基于 Pshlets 的消息推送设计.doc

基于 Pushlets 的消息推送设计 基于 Pushlets 的消息推送设计 原理 服务器端 事件发布 关键参数 客户端 技术设计 服务器端 JS 客户端 时序 集群 参考 Pushlets 是通过长连接方式实现“推”消息的。推送模式分为：Poll（轮询）、Pull（拉）。本文围绕 Pull 模式进行设计。 原理 客户端发起请求，服务端接收到请求后根据 Pushlets 协议进行处理。推数据通过 HTTP 响应返回。 客户端在接收到响应后根据 Pushlets 协议进行处理，重新发起请求。Pull 模式时序： join：join 请求，服务器端建立 Pushlet 会话 join-ack：join 应答，返回会话 id listen：订阅并监听主题 listen-ack：监听应答，返回会话 id，订阅 id subscribe（可选）：订阅主题 subscribe-ack（可选）：订阅主题应答，返回会话 id，订阅 refresh：长连接请求，实参会话 id refresh-ack：长连接响应，包括下一次 refresh 请求间隔hb：心跳响应data：推数据 leave：清空订阅 leave-ack：清空订阅应答 服务器端 服务器端主要负责维护会话，根据请求处理应答。使用内存队列维护每个会话的主题事件。 事件产生后通过分发器（Dispatcher）将事件发布到指定订阅者的事件队列里。Pull 模式使用阻塞队列，读超时（没有事件）后返回 hb 与 refresh 指令的应答。 事件发布 广播：将事件发布给所有订阅者 多播：将事件发布给匹配的订阅者 单播：将事件发给某个订阅者 关键参数 订阅者的事件队列配置： queue.size=24队列大小为 24。如果队列满了新发布到该队列的事件将被丢弃。 lis=20000队列读超时 20 秒。读超时后返回 hb 与 refresh 指令的应答。该项配置即请求线程最长 hold 时间。 lis=20队列写超时 20 毫秒。如果队列是满的，等待 20 毫秒后如果还满，则销毁该订阅者。 刷新时长配置： lis=45000服务器端刷新超时 45 秒。如果服务器端某订阅者超过 45 秒没有收到客户端的 listen 或 refresh 请求，则销毁该订阅者。该超时判断发生在发布事件时。 lis=2000lis=6000refresh 指令中指定客户端下次请求的等待时间区间，值取该区间内的随机值。 客户端 Pushlets 支持多种客户端，例如浏览器客户端、Java 客户端。浏览器客户端又分为 iframe 和 AJAX 两种。 初始化客户端后，客户端发起监听、订阅请求，并根据服务器返回指令发送 refresh 请求。当有 data 应答时，回调客户端 onData(event) 函数实现消息处理。 技术设计 对 Pushlets 做接口封装以屏蔽其特性细节，也便于以后兼容其他服务器消息推送技术（例如 WebSocket）做好铺垫。 封装的服务器推机制定义为 Channel 服务，提供服务器到浏览器客户端的消息推送。 服务器端 通过 Channel API 在 JS 客户端与服务器端建立长连接，使服务器端可以实时地发送消息给客户端。 JS 客户端 预留 WebSocket 接口 使用命名空间 oaweb.Channel() 类： init()初始化服务器调用 URL、客户端状态。 open()发送 join 请求，服务端创建会话。 subscribe(listeners : { topic,  onmessage, onerror})发送 subscribe 请求，服务端创建订阅者，添加订阅主题。 unsubscribe(topic)发送 unsubscribe 请求，服务端移除订阅。 close()发送 leave 请求，服务端销毁会话。 时序 集群 均衡器通过源地址保持策略保证同一 IP 的请求均会分发到固定服务节点。 当服务节点进行业务逻辑处理后，发送消息到消息服务系统； 服务节点订阅消息主题，当监听到新消息时调用 Channel 服务发布消息到具体的推送实现组件（Pushlets）。 参考 消息推送技术 Google App Engine Channel API HTML5 WebSocket API manufacturers of technical documents on the quality requirements applicable to this project. Construction quality inspection and evaluation standards issued b