Java WebSocket 1.0

此功能部件启用对写入到“针对 WebSocket 的 Java API”1.0 规范的 WebSocket 应用程序的支持。

启用此功能部件

要启用 Java WebSocket 1.0 功能部件,请在 server.xml 文件的 featureManager 元素内添加以下元素声明:
<feature>websocket-1.0</feature>

受支持的 Java™ 版本

  • JavaSE-1.7
  • JavaSE-1.8

开发依赖于此功能部件的功能部件

如果您要开发依赖于 Java WebSocket 1.0 功能部件的功能部件,请在新功能部件的功能部件清单文件的 Subsystem-Content 头中添加以下项:
com.ibm.websphere.appserver.websocket-1.0; type="osgi.subsystem.feature"

此功能部件启用的功能部件

启用此功能部件的功能部件

    此功能部件提供的标准 API 包

    • javax.websocket
    • javax.websocket.server

    功能部件配置元素

    可在 server.xml 文件中使用以下元素以配置 Java WebSocket 1.0 功能部件:

    wsocOutbound
    WAS WebSocket 出局连接请求的配置属性。
    属性名称 数据类型 缺省值 描述
    httpOptionsRef 对顶级 httpOptions 元素的引用(字符串)。 defaultHttpOptions WAS WebSocket 出站的 HTTP 协议选项
    sslOptionsRef 对顶级 sslOptions 元素的引用(字符串)。   WAS WebSocket 出站的 SSL 协议选项
    tcpOptionsRef 对顶级 tcpOptions 元素的引用(字符串)。 defaultTCPOptions WAS WebSocket 出站的 TCP 协议选项
    wsocOutbound > httpOptions
    描述:WAS WebSocket 出站的 HTTP 协议选项
    必需:false
    数据类型:
    属性名称 数据类型 缺省值 描述
    keepAliveEnabled 布尔型 true 启用持续连接(HTTP 保持活动)。如果为 true,那么连接将保持活动状态,以供多个顺序请求和响应重复使用。如果为 false,那么发送响应之后将关闭连接。
    maxKeepAliveRequests int

    最小值:-1

    100 启用持续连接时,单个 HTTP 连接上允许的最大持续请求数。值为 -1 时意味着不受限制。
    persistTimeout 具有秒精度的时间段 30s 将允许套接字在各个请求之间保持空闲的时间量。仅当启用持续连接时,此设置才适用。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
    readTimeout 具有秒精度的时间段 60s 发生第一次读取之后,用于等待读请求在套接字上完成的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
    removeServerHeader 布尔型 false 从 HTTP 头除去服务器实现信息,并同时禁用缺省 Liberty 概要文件欢迎页面。
    writeTimeout 具有秒精度的时间段 60s 响应数据的每个部分在套接字上等待传输的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
    wsocOutbound > sslOptions
    描述:WAS WebSocket 出站的 SSL 协议选项
    必需:false
    数据类型:
    属性名称 数据类型 缺省值 描述
    sessionTimeout 具有秒精度的时间段 1d 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
    sslRef string   缺省 SSL 配置指令表。缺省值为 defaultSSLSettings。
    suppressHandshakeErrors 布尔型 false 禁用记录 SSL 握手错误。SSL 握手错误会在正常操作期间发生,但是当 SSL 行为异常时,这些消息将很有用。
    wsocOutbound > tcpOptions
    描述:WAS WebSocket 出站的 TCP 协议选项
    必需:false
    数据类型:
    属性名称 数据类型 缺省值 描述
    inactivityTimeout 具有毫秒精度的时间段 60s 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
    soReuseAddr 布尔型 true 允许立即重新绑定到没有任何处于活动状态的侦听器的端口。

    用于指示主题类型的图标 参考主题

    信息中心的条款和条件 | 反馈


    时间戳记图标 最近一次更新时间: Wednesday, 2 September 2015
    http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_feature_websocket-1.0
    文件名:rwlp_feature_websocket-1.0.html