搜索

58.4. 端点选项

download PDF

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 值:

  • InOnly
  • InOut
  • InOptionalOut
 

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

布尔值

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.