49.7. Spring Boot Auto-Configuration
将 servlet 与 Spring Boot 搭配使用时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-servlet-starter</artifactId>
</dependency>
组件支持 15 个选项,它们如下所列。
| 名称 | Description | 默认 | 类型 |
|---|---|---|---|
| camel.component.servlet.allow-java-serialized-object | 请求使用 context-type=application/x-java-serialized-object 时,是否允许 java serialization。默认情况下关闭。如果您启用此功能,Java 将把传入的数据从请求中反序列化为 Java,这可能会成为潜在的安全风险。 | false | 布尔值 |
| camel.component.servlet.attachment-multipart-binding | 是否会在 Camel Exchange 上自动绑定多部分/信息数据作为附件。选项附加MultipartBinding=true 和 disableStreamCache=false 无法一起工作。删除 disableStreamCache 以使用 AttachmentMultipartBinding。默认情况下关闭此项,因为这可能要求 servlet 特定配置在使用 Servlet 时启用此功能。 | false | 布尔值 |
| camel.component.servlet.autowired-enabled | 是否启用自动。这用于自动自动自动选项(选项必须标记为 autowired),方法是在 registry 中查找是否有匹配的类型实例,然后在组件上进行配置。这可用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.servlet.bridge-error-handler | 允许将消费者桥接到 Camel 路由 Error Handler,这意味着使用者试图获取传入消息或类似信息时出现任何异常,现在将作为一个消息进行处理,并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.Exception 处理程序处理异常,该处理程序将记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.servlet.enabled | 是否启用 servlet 组件的自动配置。默认启用。 | 布尔值 | |
| camel.component.servlet.file-name-ext-whitelist | 接受上传的文件的接受文件名扩展白名单。多个扩展可以通过逗号分隔,如 txt,xml。 | 字符串 | |
| camel.component.servlet.header-filter-strategy | 使用自定义 org.apache.camel.spi.HeaderFilterStrategy 过滤来自 Camel 消息的标头。选项是一个 org.apache.camel.spi.HeaderFilterStrategy 类型。 | HeaderFilterStrategy | |
| camel.component.servlet.http-binding | 使用自定义 HttpBinding 控制 Camel 消息和 HttpClient 之间的映射。选项是一个 org.apache.camel.http.common.HttpBinding 类型。 | HttpBinding | |
| camel.component.servlet.http-configuration | 使用共享 HttpConfiguration 作为基本配置。选项是一个 org.apache.camel.http.common.HttpConfiguration 类型。 | HttpConfiguration | |
| camel.component.servlet.http-registry | 使用自定义 org.apache.camel.component.servlet.HttpRegistry。选项是一个 org.apache.camel.http.common.HttpRegistry 类型。 | HttpRegistry | |
| camel.component.servlet.mute-exception | 如果对响应正文的消费者启用和交换失败处理,则响应正文不包含异常堆栈跟踪。 | false | 布尔值 |
| camel.component.servlet.servlet-name | 要使用的默认 servlet 名称。默认名称为 CamelServlet。 | CamelServlet | 字符串 |
| camel.servlet.mapping.context-path | servlet 组件用于自动映射的上下文路径。 | /camel/* | 字符串 |
| camel.servlet.mapping.enabled | 启用 servlet 组件到 Spring web 上下文的自动映射。 | true | 布尔值 |
| camel.servlet.mapping.servlet-name | Camel servlet 的名称。 | CamelServlet | 字符串 |