49.4. 端点选项

contextPath (consumer)

需要使用 context-path。

字符串

块 （使用者）

如果此选项为 false，则 Servlet 将禁用 HTTP 流，并为响应设置 content-length 标头。

true

布尔值

disableStreamCache (common)

确定是否缓存来自 Servlet 的原始输入流(Camel 将流读取到内存/覆盖流到文件，流缓存)缓存。默认情况下，Camel 将缓存 Servlet 输入流，以支持多次读取它，以确保 Camel 可以从流检索所有数据。但是，当您需要访问原始流时，您可以将这个选项设置为 true，例如将其直接流传输到文件或其他持久性存储。DefaultHttpBinding 会将请求输入流复制到流缓存中，如果此选项为 false，则将其放入消息正文中，以便支持多次读取流。如果您使用 Servlet 来桥接/代理端点，请考虑启用此选项来提高性能，以防不需要多次读取消息有效负载。http 制作者将默认缓存响应正文流。如果此选项设为 true，则制作者不会缓存响应正文流，而是将响应流用作消息正文。

false

布尔值

headerFilterStrategy (common)

使用自定义 HeaderFilterStrategy 过滤标题到 Camel 消息或从 Camel 消息过滤。

HeaderFilterStrategy

httpBinding （通用（高级）

使用自定义 HttpBinding 控制 Camel 消息和 HttpClient 之间的映射。

HttpBinding

async （消费者）

将消费者配置为以 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 （消费者）

如果对消费者端启用和交换失败处理，如果导致 Exception 在响应中发送回序列化，作为 application/x-java-serialized-object 内容类型。在制作者一端，异常将被反序列化并按原样丢弃，而不是 HttpOperationFailedException。原因例外是需要序列化的。默认情况下是关闭的。如果您启用它，Java 将把请求中的传入数据反序列化到 Java，这可能会带来潜在的安全风险。

false

布尔值

attachmentMultipartBinding （使用者（高级）

是否在 Camel Exchange 上自动绑定多部分/数据作为附件。选项 attachmentMultipartBinding=true 和 disableStreamCache=false 无法一起工作。删除 disableStreamCache 以使用 AttachmentMultipartBinding。默认情况下是关闭的，因为这可能要求 servlet 特定的配置在使用 Servlet 时启用此功能。

false

布尔值

eagerCheckContentAvailable （使用者（高级）

如果 content-length 标头是 0 还是不存在，则 HTTP 请求是否具有内容。如果 HTTP 客户端没有发送流数据，则可以打开它。

false

布尔值

exceptionHandler （消费者）

要让使用者使用自定义例外处理程序：请注意，如果启用了 bridgeErrorHandler 选项，则此选项不在使用。默认情况下，使用者将处理异常，其记录在 WARN 或 ERROR 级别中，并忽略。

ExceptionHandler

ExchangePattern （消费者）

在消费者创建交换时设置交换模式。

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 body 将映射到 HTTP。把它设置为 false 将避免 HTTP Form Encoded body 映射。

true

布尔值

mapHttpMessageHeaders (consumer (advanced))

如果此选项为 true，则交换的 IN exchange Headers 将映射到 HTTP 标头。把它设置为 false 将避免 HTTP Headers 映射。

true

布尔值

optionsEnabled （使用者）

指定是否为这个 Servlet 消费者启用 HTTP OPTIONS。默认情况下关闭 OPTIONS。

false

布尔值

traceEnabled （使用者（高级）

指定是否为这个 Servlet 消费者启用 HTTP TRACE。默认情况下，TRACE 已关闭。

false

布尔值