140.5. 端点选项
Vert.x WebSocket 端点使用 URI 语法进行配置:
vertx-websocket:host:port/path
vertx-websocket:host:port/path
使用以下路径和查询参数:
140.5.1. 路径参数(3 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| host (common) | 在客户端模式中时,所需的 WebSocket 主机名,如 localhost 或远程主机。 | 字符串 | |
| port (common) | 要使用 所需的 WebSocket 端口号。 | int | |
| path (common) | 要使用的 websocket 路径。 | 字符串 |
140.5.2. 查询参数(18 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| allowedOriginPattern (consumer) | 与 WebSocket 客户端发送的原始标头匹配的正则表达式模式。 | 字符串 | |
| allowOriginHeader (consumer) | WebSocket 客户端是否应该将 Origin 标头添加到 WebSocket 握手请求中。 | true | 布尔值 |
| consumeAsClient (consumer) | 当设置为 true 时,消费者充当 WebSocket 客户端,在每个收到的 WebSocket 事件上创建交换。 | false | 布尔值 |
| fireWebSocketConnectionEvents (consumer) | 当新的 WebSocket 对等点连接时,服务器消费者是否会创建一个消息交换。 | false | 布尔值 |
| maxReconnectAttempts (consumer) | 当 useAsClient 设置为 true 时,这会将允许重新连接的最大数量设置为之前关闭的 WebSocket。值 0 (默认值)将尝试无限期重新连接。 | 0 | int |
| originHeaderUrl (consumer) | WebSocket 客户端应在 WebSocket 握手请求中使用的 Origin 标头值。如果没有指定,WebSocket 客户端将自动从请求 URL 确定 Origin 的值。 | 字符串 | |
| reconnectInitialDelay (consumer) | 当 consumeAsClient 设置为 true 时,这会在尝试重新连接到之前关闭的 WebSocket 前设置初始延迟(毫秒)。 | 0 | int |
| reconnectInterval (consumer) | 当 consumeAsClient 设置为 true 时,这会以毫秒为单位设置间隔,这会重新连接到之前关闭的 WebSocket。 | 1000 | int |
| router (consumer) | 将现有的 vertx 路由器用于 HTTP 服务器: | 路由器 | |
| serverOptions (consumer) | 设置用于为消费者配置托管 WebSocket 的 HTTP 服务器的自定义选项。 | HttpServerOptions | |
| bridgeErrorHandler (consumer (advanced)) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| clientOptions (producer) | 设置用于配置制作者中使用的 WebSocket 客户端的自定义选项。 | HttpClientOptions | |
| clientSubProtocols (producer) | 以逗号分隔的 WebSocket 子协议列表,客户端用于 Sec-WebSocket-Protocol 标头。 | 字符串 | |
| sendToAll (producer) | 发送到所有 websocket 订阅者。可用于在端点级别上配置,而不是在消息中提供 VertxWebsocketConstants.SEND_TO_ALL 标头。请注意,在使用此选项时,为 vertx-websocket producer URI 指定的主机名必须与用于现有 vertx-websocket consumer 的主机名匹配。请注意,只有在将消息生成到由 vertx-websocket 消费者托管的端点时,才会应用此选项,而不是外部托管的 WebSocket。 | false | 布尔值 |
| lazyStartProducer (producer (advanced)) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| sslContextParameters (security) | 使用 SSLContextParameters 配置安全性。 | SSLContextParameters |