搜索

358.2. 选项

download PDF

Undertow 组件支持下列 5 个选项:

Name描述默认值类型

undertowHttpBinding (advanced)

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

 

UndertowHttpBinding

sslContextParameters (security)

使用 SSLContextParameters 配置安全性

 

SSLContextParameters

useGlobalSslContext 参数 (security)

启用使用全局 SSL 上下文参数。

false

布尔值

hostOptions (advanced)

配置常见选项,如线程池

 

UndertowHostOptions

resolveProperty Placeholders (advanced)

组件是否应在启动时解析属性占位符。只有 String 类型的属性可以使用属性占位符。

true

布尔值

Undertow 端点使用 URI 语法进行配置:

undertow:httpURI

使用以下路径和查询参数:

358.2.1. 路径参数(1 参数):

Name描述默认值类型

httpURI

必需 使用的 HTTP 端点的 url。

 

URI

358.2.2. 查询参数(22 参数):

Name描述默认值类型

bridgeErrorHandler (consumer)

允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。

false

布尔值

httpMethodRestrict (consumer)

仅在 HttpMethod 匹配时才允许使用,如 GET/POST/PUT 等。可以使用逗号分隔多个方法。

 

字符串

matchOnUriPrefix (consumer)

如果找不到完全匹配,消费者是否应该尝试通过匹配 URI 前缀来查找目标消费者。

false

布尔值

optionsEnabled (consumer)

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

false

布尔值

ExceptionHandler ( consumer)

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

 

ExceptionHandler

exchangePattern (consumer)

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

 

ExchangePattern

handlers (consumer)

指定 registry 中要查找的以逗号分隔的 io.undertow.server.HttpHandler 实例集合。这些处理程序添加到 Undertow 处理程序链中,例如为添加安全性。

注意

您不能使用相同的端口号,将不同的处理程序用于不同的 Undertow 端点。处理程序与端口号关联。如果您需要不同的处理程序,则使用不同的端口号。

 

字符串

cookieHandler (producer)

配置 Cookie 处理程序,以维护 HTTP 会话

 

CookieHandler

keepalive ( producer)

设置以确保因为不活跃而不会关闭套接字

true

布尔值

options (producer)

设置其他频道选项。可以使用的选项在 org.xnio.Options 中定义。要从端点 uri 配置,然后使用选项为每个选项添加前缀,如 option.close-abort=true&option.send-buffer=8192

 

Map

reuseAddresses (producer)

设置以方便套接字多路

true

布尔值

tcpNoDelay (producer)

设置以提高 TCP 协议性能

true

布尔值

throwExceptionOnFailure (producer)

如果来自远程服务器的失败响应,用于禁用抛出 HttpOperationFailedException。这样,您可以获取所有响应,而不考虑 HTTP 状态代码。

true

布尔值

transferException (producer)

如果在消费者端启用和交换失败处理,如果原因 Exception 在响应中作为 application/x-java-serialized-object 内容类型发送序列化,且原因为 Exception。在生产者侧,异常将反序列化并丢弃为 HttpOperationFailedException。原因异常需要按顺序处理。默认为关闭。如果您启用它,则 Java 会将传入的数据反序列化 Java 请求,这可能会成为潜在的安全风险。

false

布尔值

headerFilterStrategy (advanced)

使用自定义 HeaderFilterStrategy 过滤到 Camel 消息的标头。

 

HeaderFilterStrategy

同步 (高级)

设置是否应严格使用同步处理,还是允许 Camel 使用异步处理(如果支持)。

false

布尔值

undertowHttpBinding (advanced)

使用自定义 UndertowHttpBinding 来控制 Camel 消息和 undertow 之间的映射。

 

UndertowHttpBinding

fireWebSocketChannelEvents (websocket)

如果为 true,则消费者将在新的 WebSocket 对等点连接、断开连接等时向路由发布通知。请参阅 UndertowConstants.EVENT_TYPE 和 EventType。

false

布尔值

sendTimeout (websocket)

发送到 websocket 频道时的超时时间(毫秒)。默认超时为 30000 (30 秒)。

30000

整数

sendToAll (websocket)

发送到所有 websocket 订阅者。可用于在端点级别上配置,而不必在消息上使用 UndertowConstants.SEND_TO_ALL 标头。

 

布尔值

useStreaming (websocket)

如果为 true,则通过 WebSocket 的文本和二进制消息将分别嵌套为 java.io.Reader 和 java.io.InputStream,然后再将它们分别传递为 Exchange;否则它们将分别传递为 String 和字节。

false

布尔值

sslContextParameters (security)

使用 SSLContextParameters 配置安全性

 

SSLContextParameters

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.