#1 WebSocket 基本API

WebSocket 對web應(yīng)用來將是一個事件驅(qū)動,全雙工異步通信通道(WebSocket is an event-driven, full-duplex asynchronous communications channel for your web applications)

websocket特點:

  • 在TLS(Transport Layer Security 或 SSL)協(xié)議上進行操作
  • 能夠?qū)崟r的更新,減少客戶端和服務(wù)端(更多)資源需求
  • 使用HTTP作為初始化傳輸機制,客戶端接受到響應(yīng)之后,通信不會中斷,因此能夠拜托傳統(tǒng)的HTTP request/response 模式的約束
  • 只要連接(connection)保持打開,客戶端和服務(wù)端就能夠自由異步的發(fā)送信息,而不用使用輪詢(polling)

學(xué)習(xí)目標(biāo):

  • 了解Websocket API
  • Websocket 協(xié)議: 信息傳遞工具
  • web 應(yīng)用中如何使用

API

初始化

WebSocket 的構(gòu)造器有2個參數(shù):

  • URL: 用作連接到服務(wù)器,如果不指定端口,則會通過默認(rèn)端口80(HTTP 端口)或者端口443(HTTPS 端口)連接
  • protocol(可選參數(shù)): 可以是數(shù)組或者一個字符串,不傳入則默認(rèn)為空字符串,用來指定子協(xié)議(subprotocols)。頭文件作為 Sec-WebSocket-Protocol,一個server能夠?qū)崿F(xiàn)多個WebSocket子協(xié)議

WebSocket的一些協(xié)議:

  • Registered protocols: 在WebSocket RFC6455的規(guī)范中,第11.5節(jié)定義了子協(xié)議名稱由IANA維護注冊的注冊管理機構(gòu)。
  • Opened protocols: 可以使用開發(fā)的未注冊的協(xié)議,比如XMPP(Extensible Messaging and Presence Protocol) 或者 STOMP(Simple Text Oriented Message Protocol 面向簡單文字信息協(xié)議)
  • Custom protocols: 可以自由設(shè)計協(xié)議,只要客戶端和服務(wù)端都支持,推薦使用包含子協(xié)議發(fā)起方(originator)的域名的ASCII版本的名稱,比如:chat.acme.com

使用本地server,而不使用web server代理連接的話,可以通過下列方式來實例化一個WebSocket對象

# 此處URL為: 'ws://localhost:8181'
# 如果使用TLS傳輸協(xié)議,URL中的'ws://' 可以用 'wss://'替換
var ws = new WebSocket('ws://localhost:8181');

事件

open

當(dāng)WebSocket server響應(yīng)連接請求,握手完成,open 事件觸發(fā),連接建立。

此時服務(wù)端完成握手,準(zhǔn)備好發(fā)送信息和接收來自客戶端應(yīng)用的信息

var stock_request = {"stock": ["AAPL", "MSFT", "AMZN", "GOOG", "YHOO"]}

// WebSocket 連接建立
ws.onopen = function(e) {
  console.log('Connection established');
  ws.send(JSON.stringify(stock_request));
};
// stock_request json化后的字符串通過WebSocket發(fā)送給服務(wù)端
// 服務(wù)端知道哪些stocks需要更新
// 并且每隔1s向客戶端將信息發(fā)送這些stocks信息

可以通過這個事件,可以向服務(wù)器發(fā)送信息,并且輸出狀態(tài)到屏幕,連接已準(zhǔn)備好,可以開始雙向的通信

message

當(dāng)服務(wù)器端有數(shù)據(jù),WebSocket API將調(diào)用 'message' 事件

error

當(dāng)發(fā)生錯誤時,'error'事件觸發(fā),然后 'close' 事件將觸發(fā)或者嘗試重新連接,codereason 特性能夠提供一些錯誤信息

ws.onerror = function(e) {
  console.log('WebSocket failure, error', e);
  handleErrors(e);
}

PING/PONG

WebSocket協(xié)議調(diào)用2種幀類型: PING 和 PONG。

客戶端不能夠發(fā)送PING到服務(wù)端,PING只能由服務(wù)端發(fā)送,瀏覽器應(yīng)當(dāng)以PONG作為回應(yīng)

close

當(dāng)WebSocket連接關(guān)閉,'close'事件將觸發(fā),同時'onerror' 將被執(zhí)行。一旦此事件觸發(fā),服務(wù)器和客戶端的連接也就斷開了

codereason 特性,可以用于指示要處理的錯誤條件或close事件的原因,
wasClean(布爾值)可以用來判斷中斷是否完整, readyState 的值,從2('closing') 變?yōu)?3('closed')

// close事件
ws.onclose = function(e) {
  console.log(e.reason + ' ' + e.code);
  for (var symbol in stocks) {
    if (stocks.hasOwnProperty(symbol)) {
      stocks[symbol] = 0;
    }
  }
}

// close方法
ws.close(1000, 'WebSocket connection closed');

方法

WebSocket的創(chuàng)建者使它的方法十分的簡單,只有2個方法:

  • send()
  • close()

send()

當(dāng)客戶端和服務(wù)端建立起連接,客戶端可以指定什么類型的數(shù)據(jù)能夠被傳遞,能夠接收 stringbinary 的值。

我們知道WebSocket是事件驅(qū)動的,使用此事件前,必須保證連接已經(jīng)打開,并且準(zhǔn)備好了接收消息,可以通過下面2種方式來完成:

1.在 onopen 事件中發(fā)送數(shù)據(jù)

var ws = new WebSocket('ws://localhost:8181');
ws.onopen = function(e) {
  ws.send(JSON.stringify(stock_request));
}

2.檢查 readyState 特性,確保WebSocket對象準(zhǔn)備好了接收messages

function processEvent(e) {
  if (ws.readyState === WebSocket.OPEN) {
    // Socket 打開,Send
    ws.send(e);
  } else {
    // 顯示錯誤信息,待會再發(fā)送
  }
}

close()

斷開WebSocket連接或者中斷嘗試連接完成可以使用 close方法,調(diào)用此方法之后,數(shù)據(jù)就不能夠再傳遞了

可以不帶參數(shù)使用:

ws.close()

或者傳入一個 數(shù)字代碼 和 關(guān)閉原因

ws.close(1000, 'Goodbye, World');

數(shù)字代碼:

  • 1000CLOSE_NORMAL,正常關(guān)閉,連接任務(wù)已經(jīng)成功完成
  • 1001CLOSE_GOING_AWAY,終端離開,要么服務(wù)器失敗或者瀏覽器離開連接的頁面
  • 1002CLOSE_PROTOCOL_ERROR, 由于協(xié)議錯誤,終端終止連接
  • 1003CLOSE_UNSUPPORTED,由于終端接收到的數(shù)據(jù)類型不支持,連接斷開
  • 1004CLOSE_TOO_LARGE,接收到的數(shù)據(jù)過大導(dǎo)致連接斷開
  • 1005CLOSE_NO_STATUS,保留數(shù)字代碼,顯示沒有狀態(tài)碼被提供
  • 1006CLOSE_ABNORMAL,表示連接意外被終止

特性(Attributes)

當(dāng)連接建立(open),客戶端應(yīng)用中有幾個可使用的特性

readyState

只讀,在客戶端發(fā)送數(shù)據(jù)之前最好先檢查一下這個屬性,這個屬性有4個值,分別表示W(wǎng)ebSocket不同的狀態(tài):

  • WebSocket.CONNECTING: 0, 連接還沒有打開
  • WebSocket.OPEN: 1,連接打開,準(zhǔn)備好通信
  • WebSocket.CLOSING: 2,連接正在關(guān)閉中
  • WebSocket.CLOSED: 3,連接關(guān)閉

不同的值可以用于調(diào)試和了解連接服務(wù)器的生命周期

bufferedAmount

發(fā)送到服務(wù)器的緩存數(shù)據(jù)量,多用于發(fā)送 binary 數(shù)據(jù),因為該數(shù)據(jù)量給瀏覽器處理過大,這個屬性最大的用處就是 在關(guān)閉連接之前確保所有的數(shù)據(jù)都被發(fā)送,并且實現(xiàn)客戶端節(jié)流(throttling)

protocol

WebSocket構(gòu)造器可選參數(shù),客戶端發(fā)送多個子協(xié)議到服務(wù)器,服務(wù)器決定選取那個協(xié)議,客戶端和服務(wù)端握手完成,服務(wù)端應(yīng)當(dāng)包含選擇的協(xié)議或者什么也沒有

總結(jié)

本章主要了解了WebSocket的一些基本概念,以及WebSocket建立客戶端與服務(wù)端的優(yōu)勢,主要有:

  • WebSocket的定義
  • WebSocket對象的實例化,2個參數(shù),URL,protocols(可選)
  • WebSocket相關(guān)的一些事件:open, message, error, close, PING/PONG
  • 2個方法:send(), close()
  • 特性:readyState,bufferedAmount, protocol
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,563評論 6 544
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,694評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,672評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,965評論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 72,690評論 6 413
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 56,019評論 1 329
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,013評論 3 449
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 43,188評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,718評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 41,438評論 3 360
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,667評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,149評論 5 365
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 44,845評論 3 351
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,252評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,590評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,384評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 48,635評論 2 380

推薦閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 134,830評論 18 139
  • 我最愛的小孩 你今天沒有笑 是否有人奪去了你快樂的容貌 我最美的小孩 你今天沒有鬧 是否風(fēng)兒吹走了你嬉戲的情調(diào) 我...
    綠打蘇ei閱讀 275評論 0 1
  • 回顧 相關(guān)文章回顧 mongoDB查詢進階--聚合管道(一)回顧mongoDB查詢進階--聚合管道(二)回顧 管道...
    n_ll閱讀 1,548評論 0 3
  • 小時候,村子四周被一條環(huán)形的護城河圍繞。村東的護城河,還連著一個池塘。記得一年夏天,雨過天晴的上午,池塘邊躺著一個...
    一聲笑閱讀 611評論 0 0