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不一樣處）。