358.2. 选项
Undertow 组件支持 5 个选项,如下所列。
名称 | 描述 | 默认值 | 类型 |
---|---|---|---|
undertowHttpBinding (advanced) | 使用自定义 HttpBinding 来控制 Camel 消息和 HttpClient 之间的映射。 | UndertowHttpBinding | |
sslContextParameters (security) | 使用 SSLContextParameters 配置安全性 | SSLContextParameters | |
useGlobalSslContext Parameters (security) | 启用使用全局 SSL 上下文参数。 | false | 布尔值 |
hostOptions (advanced) | 配置常用选项,如线程池 | UndertowHostOptions | |
resolveProperty Placeholders (advanced) | 启动时组件是否应解析自身上的属性占位符。只有属于 String 类型的属性才能使用属性占位符。 | true | 布尔值 |
Undertow 端点使用 URI 语法进行配置:
undertow:httpURI
使用以下路径和查询参数:
358.2.1. 路径参数(1 参数):
名称 | 描述 | 默认值 | 类型 |
---|---|---|---|
httpURI | 必需 要使用的 HTTP 端点的 url。 | URI |
358.2.2. 查询参数(22 参数):
名称 | 描述 | 默认值 | 类型 |
---|---|---|---|
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 中定义。要从 endpoint uri 配置,然后使用 option.close-abort=true&option.send-buffer=8192 前缀。 | Map | |
reuseAddresses (producer) | 设置为方便套接字多路 | true | 布尔值 |
tcpNoDelay (producer) | 设置以提高 TCP 协议性能 | true | 布尔值 |
throwExceptionOnFailure (producer) | 如果远程服务器失败响应,禁用禁用 HttpOperationFailedException 的选项。这样,无论 HTTP 状态代码是什么,您都可以获得所有响应。 | true | 布尔值 |
transferException (producer) | 如果在消费者端启用,且 Exchange 在消费者端处理失败,如果导致的 Exception 被发送序列化为 application/x-java-serialized-object 内容类型。在生成者一侧,异常将被反序列化和抛出,与 HttpOperationFailedException 不同。导致异常需要被序列化。默认情况下是关闭的。如果启用此选项,则 Java 会将传入数据从请求反序列化到 Java,这可能会成为潜在的安全风险。 | false | 布尔值 |
headerFilterStrategy (advanced) | 使用自定义 HeaderFilterStrategy 过滤标头到 Camel 消息。 | HeaderFilterStrategy | |
同步 (advanced) | 设置是否应严格使用同步处理,或者 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 和 byte 传递。 | false | 布尔值 |
sslContextParameters (security) | 使用 SSLContextParameters 配置安全性 | SSLContextParameters |