368.2. Websocket 选项
Jetty Websocket 组件支持 14 个选项,如下所列。
名称 | 描述 | 默认值 | 类型 |
---|---|---|---|
staticResources (consumer) | 为静态资源设置资源路径(如 .html 文件等)。如果您从 classpath 加载资源,如果您的前缀带有 classpath:,否则资源会从文件系统或 JAR 文件加载。例如,要从 root 类路径加载,请使用 classpath:. 或 classpath:WEB-INF/static 如果未配置(如 null),则不使用静态资源。 | 字符串 | |
host (common) | 主机名。默认值为 0.0.0.0 | 0.0.0.0 | 字符串 |
port (common) | 端口号。默认值为 9292 | 9292 | 整数 |
sslKeyPassword (security) | 使用 SSL 时密钥存储的密码。 | 字符串 | |
sslPassword (security) | 使用 SSL 时的密码。 | 字符串 | |
sslKeystore (security) | 密钥存储的路径。 | 字符串 | |
enableJmx (advanced) | 如果此选项为 true,则会为此端点启用 Jetty JMX 支持。如需了解更多详细信息,请参阅 Jetty JMX 支持。 | false | 布尔值 |
minThreads (advanced) | 要为服务器线程池中的最小线程数设置值。因为切换到 Jetty9,需要 MaxThreads/minThreads 或 threadPool 字段。minThreads 的默认值为 1。 | 整数 | |
maxThreads (advanced) | 要为服务器线程池中的最大线程数设置值。因为切换到 Jetty9,需要 MaxThreads/minThreads 或 threadPool 字段。maxThreads 的默认值为 1 2 noCores。 | 整数 | |
threadPool (advanced) | 将自定义线程池用于服务器。因为切换到 Jetty9,需要 MaxThreads/minThreads 或 threadPool 字段。 | ThreadPool | |
sslContextParameters (security) | 使用 SSLContextParameters 配置安全性 | SSLContextParameters | |
useGlobalSslContext Parameters (security) | 启用使用全局 SSL 上下文参数。 | false | 布尔值 |
socketFactory (common) | 配置包含子协议的自定义 WebSocketFactory 的映射。映射中的键是子协议。默认密钥为默认实现保留。 | Map | |
resolveProperty Placeholders (advanced) | 启动时组件是否应解析自身上的属性占位符。只有属于 String 类型的属性才能使用属性占位符。 | true | 布尔值 |
Jetty Websocket 端点使用 URI 语法进行配置:
websocket:host:port/resourceUri
使用以下路径和查询参数:
368.2.1. 路径参数(3 参数):
名称 | 描述 | 默认值 | 类型 |
---|---|---|---|
主机 | 主机名。默认值为 0.0.0.0。在组件上设置这个选项将使用组件配置的值作为默认值。 | 0.0.0.0 | 字符串 |
端口 | 端口号。默认值为 9292。在组件上设置这个选项将使用组件配置的值作为默认值。 | 9292 | 整数 |
resourceUri | 要使用的 websocket 频道 所需的 名称 | 字符串 |
368.2.2. 查询参数(18 参数):
名称 | 描述 | 默认值 | 类型 |
---|---|---|---|
maxBinaryMessageSize (common) | 可用于设置 websocketServlet 创建的 websocket 在关闭前可以接受的大小(以字节为单位)。(默认为 -1 - 或无限) | -1 | 整数 |
bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
sessionSupport (consumer) | 是否启用会话支持,从而为每个 http 请求启用 HttpSession。 | false | 布尔值 |
staticResources (consumer) | 为静态资源设置资源路径(如 .html 文件等)。如果您从 classpath 加载资源,如果您的前缀带有 classpath:,否则资源会从文件系统或 JAR 文件加载。例如,要从 root 类路径加载,请使用 classpath:. 或 classpath:WEB-INF/static 如果未配置(如 null),则不使用静态资源。 | 字符串 | |
exceptionHandler (consumer) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
exchangePattern (consumer) | 在消费者创建交换时设置交换模式。 | ExchangePattern | |
sendTimeout (producer) | 发送到 websocket 频道时的 millis 超时。默认超时为 30000 (30 秒)。 | 30000 | 整数 |
sendToAll (producer) | 发送到所有 websocket 订阅者。可用于在端点级别上配置,而不必在消息中使用 WebsocketConstants.SEND_TO_ALL 标头。 | 布尔值 | |
bufferSize (advanced) | 设置 websocketServlet 的缓冲大小,其也是最大帧字节大小(默认值 8192) | 8192 | 整数 |
maxIdleTime (advanced) | 设置由 websocketServlet 创建的 websocket 在关闭前可以闲置的时间(默认为 300000) | 300000 | 整数 |
maxTextMessageSize (advanced) | 可用于设置 websocketServlet 创建的 websocket 在关闭前可以接受的字符的大小。 | 整数 | |
minVersion (advanced) | 可用于设置 websocketServlet 接受的最小协议版本。(默认为 13 - RFC6455 版本) | 13 | 整数 |
同步 (advanced) | 设置是否应严格使用同步处理,或者 Camel 允许使用异步处理(如果受支持)。 | false | 布尔值 |
allowedOrigins (cors) | CORS 允许的源。使用 允许所有. | 字符串 | |
crossOriginFilterOn (cors) | 是否启用 CORS | false | 布尔值 |
filterPath (cors) | 过滤 CORS 的上下文路径 | 字符串 | |
enableJmx (monitoring) | 如果此选项为 true,则会为此端点启用 Jetty JMX 支持。如需了解更多详细信息,请参阅 Jetty JMX 支持。 | false | 布尔值 |
sslContextParameters (security) | 使用 SSLContextParameters 配置安全性 | SSLContextParameters |