58.4. 端点选项
Servlet 端点使用 URI 语法进行配置:
servlet:contextPath
使用以下路径和查询参数:
58.4.1. 路径参数(1 参数)
Name | 描述 | 默认值 | 类型 |
---|---|---|---|
contextPath (consumer) | 必需 要使用的上下文路径。 | 字符串 |
58.4.2. 查询参数(22 参数)
Name | 描述 | 默认值 | 类型 |
---|---|---|---|
chunked (consumer) | 如果此选项为 false,则 Servlet 将禁用 HTTP 流,并在响应上设置 content-length 标头。 | true | 布尔值 |
disableStreamCache (common) | 确定来自 Servlet 的原始输入流是否缓存(Camel 会将流读取到内存/出口流到文件中,流缓存)缓存中。默认情况下,Camel 将缓存 Servlet 输入流,以支持多次读取它,以确保 Camel 可以从流检索所有数据。但是,当您需要访问原始流(如将其直接流传输到文件或其他持久性存储)时,您可以将此选项设置为 true。DefaultHttpBinding 将请求输入流复制到流缓存中,如果此选项为 false,则将其放在消息正文中,以支持多次读取流。如果您使用 Servlet 网桥/代理端点,请考虑启用此选项来提高性能,以防不需要多次读取消息有效负载。默认情况下,http producer 将缓存响应正文流。如果此选项设为 true,则制作者不会缓存响应正文流,而是使用响应流作为消息正文。 | false | 布尔值 |
HeaderFilterStrategy (common) | 使用自定义 HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。 | HeaderFilterStrategy | |
httpBinding (common (advanced)) | 使用自定义 HttpBinding 控制 Camel 消息和 HttpClient 之间的映射。 | HttpBinding | |
async (consumer) | 将消费者配置为在 async 模式下工作。 | false | 布尔值 |
bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图获取传入消息或类似消息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
httpMethodRestrict (consumer) | 仅在 HttpMethod 匹配时才允许使用,如 GET/POST/PUT 等。可以使用逗号分隔指定多个方法。 | 字符串 | |
matchOnUriPrefix (consumer) | 如果没有找到完全匹配,消费者是否应该尝试通过匹配 URI 前缀来查找目标消费者。 | false | 布尔值 |
muteException (consumer) | 如果启用并在响应正文的消费者端处理者失败的处理,则响应的堆栈跟踪不会包含异常的堆栈跟踪。 | false | 布尔值 |
responseBufferSize (consumer) | 在 javax.servlet.ServletResponse 上使用自定义缓冲区大小。 | 整数 | |
servletName (consumer) | 要使用的 servlet 的名称。 | CamelServlet | 字符串 |
transferException (consumer) | 如果在消费者端启用和交换失败的处理,如果导致的例外在响应中作为 application/x-java-serialized-object 内容类型进行序列化化。在制作者一侧,异常会被反序列化并抛出,而不是 HttpOperationFailedException。需要对原因的异常进行序列化。默认情况下关闭。如果您启用此功能,则 Java 会将传入的数据从请求反序列化到 Java,这可能会存在潜在的安全风险。 | false | 布尔值 |
attachmentMultipartBinding (consumer (advanced)) | 是否作为 Camel Exchange 上的附件自动绑定多部分/格式数据。选项 attachmentMultipartBinding=true 和 disableStreamCache=false 无法一起工作。删除 disableStreamCache 以使用 AttachmentMultipartBinding。这默认关闭,因为这可能需要特定于 servlet 的配置才能使用 Servlets 启用此功能。 | false | 布尔值 |
eagerCheckContentAvailable (consumer (advanced)) | 如果 content-length 标头为 0 还是不存在,检查 HTTP 请求是否有内容。当 HTTP 客户端没有发送流化数据时,可以打开它。 | false | 布尔值 |
exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
fileNameExtWhitelist (consumer (advanced)) | 接受上传的文件的可接受的文件名扩展的白名单。可以使用逗号分隔多个扩展,如 txt,xml。 | 字符串 | |
mapHttpMessageBody (consumer (advanced)) | 如果此选项为 true,则交换的 IN Exchange Body 将映射到 HTTP 正文。把它设置为 false 将避免 HTTP 映射。 | true | 布尔值 |
mapHttpMessageFormUrlEncodedBody (consumer (advanced)) | 如果此选项为 true,则 IN exchange Form Encoded 正文将映射到 HTTP。把它设置为 false 将避免 HTTP 表单的正文映射。 | true | 布尔值 |
mapHttpMessageHeaders (consumer (advanced)) | 如果此选项为 true,则交换的 IN 交换标头将映射到 HTTP 标头。把它设置为 false 将避免 HTTP 标头映射。 | true | 布尔值 |
optionsEnabled (consumer (advanced)) | 指定是否为这个 Servlet 使用者启用 HTTP OPTIONS。默认情况下关闭 OPTIONS。 | false | 布尔值 |
traceEnabled (consumer (advanced)) | 指定是否为这个 Servlet 使用者启用 HTTP TRACE。默认情况下关闭 TRACE。 | false | 布尔值 |