358.2. 选项
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 中要查找的以逗号分隔的 注意 您不能使用相同的端口号,将不同的处理程序用于不同的 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 |