Java WebSocket 编程（一）

一、相关概念

• WebSocket 协议是一个网络协议，容许两个相连的端在一个单一TCP 链接上进行全双工消息通讯。相似打电话。
• Java Web Socket API是最近的Java EE 7平台的核心特性。

其中比较重要类

• Java WebSocket（暂且称为EndPoint）,其建立方式有两种
  • 注解式：使用@ServerEndpoint，并在注解中配置uri值。
  • 编程式：继承EndPoint。
• Session：可用于获取RemoteEndpoint。
• RemoteEndpoint：能够分为两类
  • RemoteEndpoint.Basic:同步，等待消息发送完成后返回。
  • RemoteEndpoint.Asyn:异步，不等待消息发送完成后返回。
• ServerApplicationConfig:用于注册WebSocket对象。

二、WebSocket生命周期

• 打开：@OnOpen；void方法，可选带参数一个Session、一个EndPointConfig、任意多个@PathParam
• 消息:@OnMessage；方法参数一个Session、一个EndPointConfig、任意多个@PathParam、消息、分片标志位（Boolean,true-最后；false-非）
              消息类型
                      *文本消息：String、Reader
                      *二进制：ByteBuffer、byte[]、InputStream
                      pong消息：PongMessage接口实例
              返回类型
                      void：
                      非 void：会将返回值发送给消息的发送者。
• 错误:@OnError：可带错误消息Throwable、Session、多个@PathParam
• 关闭:@OnClose：可带关闭信息CloseReason、Session、多个@PathParam

WebSocket是多实例多线程模式（与Sevlet不一样处）。