技術標籤：WebSocketwebsocket規範簡寫入門翻譯

文章目錄

• • 1.1、文件的意圖
  • 1.2、規範的目標
  • 1.3、通篇規範使用的技術
  • 1.4、規範約定
  • 1.5、專家組成員
  • 1.6、致謝

1.1、文件的意圖

• 該文件與Java WebSocket API的API文件都是WebSocketAPI規範描述組成部分，該規範定義實現才能成為Java WebSocket API的實現必須滿足的要求，該規範是根據Java Community Process的規則開發的。與測試相容套件(Test Compatibility Kit TCK)【用於測試給定實現是否滿足規範要求】以及參考實現（RI）（用於實現該規範並通過TCK測試）一起，為WebSocket應用程式開發定義了Java標準。
• 儘管本文件中有許多對使用Java WebSocket API的開放人員有用的資訊，但其目的不是成為開發人員指南，同樣，儘管本文件中有很多有用的資訊對正在建立Java WebSocket API 實現的開發人員有用，但是其目的並不是事無鉅細告訴開發者所有實現必須功能的指南。

1.2、規範的目標

• 本規範的目的是定義對希望支援Java平臺上的Websocket程式設計API的容器的要求，雖然該文件對於使用本規範定義的API的開發人員可能是有用的參考，但是本文件不是開發人員的指南。

1.3、通篇規範使用的技術

• endpoint[端點]： websocket端點是Java元件，代表兩個已連線對等方之間websocket互動序列的一側
• connection(連線) ： 在端點之間建立一個websocket網路連線，同時它們通過websocket 協議進行互動
• peer[對等方]：在websocket端點的上下文使用，websocket對等方用於與端點進行互動另一個參與者
• session（會話）websocket 會話表示端點和對等方之間一系列互動的上下文資訊。

1.4、規範約定

• 對於關鍵字‘必須’，‘不能’， ‘要求’，‘需要’，‘最好不要’， ‘應該’，‘應該不’，‘推薦’，‘可能’ 和‘可選’的含義，具體可以參考RFC2119規範文件

• 另外，可以使用一致性測試套件進行測試的規範要求，並且表示WSC（Websocket Compatibility websocket相容性)，後面跟上數字用於標識具體測試用例，例如WSC-12

• java程式碼和簡單資料片段都會以如下形式展示

  • package com.example.hello;
    public class Hello{
      public static void main(String args[]){
        System.out.println("Hello World");
      }
    }
    

• URI 一般格式為 ‘http://example.org/…’ 和 ‘http://example.com/…’ 代表應用或上下文依賴URI格式

• 本規範的所有部分均為規範性內容，但示例，註釋和部分明確標記為“非規範性”，例如非規範性格式如下

  • 註釋：這是一個註釋。

1.5、專家組成員

• 該規範是在Java社群流程中作為JSR356的一部分開發的，這是JSR356專家組成員共同努力的成果，完整的公共郵件檔案可以在附錄找到，以下是專家組成員：
  • Jean-Francois Arcand (Individual Member) − Greg Wilkins (Intalio)
  • Scott Ferguson (Caucho Technology, Inc) − Joe Walnes (DRW Holdings, LLC)
  • Minehiko IIDA (Fujitsu Limited) − Wenbo Zhu (Google Inc.)
  • Bill Wigger (IBM)
  • Justin Lee (Individual Member) − Danny Coward (Oracle)
  • Rmy Maucherat (RedHat)
  • Moon Namkoong (TmaxSoft, Inc.) − Mark Thomas (VMware)
  • Wei Chen (Voxeo Corporation)
  • Rossen Stoyanchev (VMware)

1.6、致謝

• 在制定本規範的過程中，我們收到了許多評意見，反饋和建議。特別感謝：Jitendra Kotamraju, Martin Matula, Steˇpa ́n Kopˇriva, Dhiru Panday, Jondean Healey,Joakim Erdfelt, Dianne Jiao, Michal Conos and Jan Supol.