#1 WebSocket 基本API

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

websocket特點(diǎn):

  • 在TLS(Transport Layer Security 或 SSL)協(xié)議上進(jìn)行操作
  • 能夠?qū)崟r(shí)的更新碰辅,減少客戶端和服務(wù)端(更多)資源需求
  • 使用HTTP作為初始化傳輸機(jī)制峰鄙,客戶端接受到響應(yīng)之后俭厚,通信不會(huì)中斷,因此能夠拜托傳統(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個(gè)參數(shù):

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

WebSocket的一些協(xié)議:

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

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

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

事件

open

當(dāng)WebSocket server響應(yīng)連接請(qǐng)求温自,握手完成,open 事件觸發(fā)皇钞,連接建立悼泌。

此時(shí)服務(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信息

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

message

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

error

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

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ā),同時(shí)'onerror' 將被執(zhí)行被去。一旦此事件觸發(fā)兰绣,服務(wù)器和客戶端的連接也就斷開了

codereason 特性,可以用于指示要處理的錯(cuò)誤條件或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)建者使它的方法十分的簡(jiǎn)單,只有2個(gè)方法:

  • send()
  • close()

send()

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

我們知道WebSocket是事件驅(qū)動(dòng)的畅蹂,使用此事件前健无,必須保證連接已經(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對(duì)象準(zhǔn)備好了接收messages

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

close()

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

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

ws.close()

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

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

數(shù)字代碼:

  • 1000CLOSE_NORMAL,正常關(guān)閉示损,連接任務(wù)已經(jīng)成功完成
  • 1001CLOSE_GOING_AWAY,終端離開渗磅,要么服務(wù)器失敗或者瀏覽器離開連接的頁(yè)面
  • 1002CLOSE_PROTOCOL_ERROR, 由于協(xié)議錯(cuò)誤,終端終止連接
  • 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)用中有幾個(gè)可使用的特性

readyState

只讀,在客戶端發(fā)送數(shù)據(jù)之前最好先檢查一下這個(gè)屬性脆贵,這個(gè)屬性有4個(gè)值医清,分別表示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ù)会烙,因?yàn)樵摂?shù)據(jù)量給瀏覽器處理過大,這個(gè)屬性最大的用處就是 在關(guān)閉連接之前確保所有的數(shù)據(jù)都被發(fā)送双泪,并且實(shí)現(xiàn)客戶端節(jié)流(throttling)

protocol

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

總結(jié)

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

  • WebSocket的定義
  • WebSocket對(duì)象的實(shí)例化贫导,2個(gè)參數(shù),URL蟆盹,protocols(可選)
  • WebSocket相關(guān)的一些事件:open, message, error, close, PING/PONG
  • 2個(gè)方法:send(), close()
  • 特性:readyState孩灯,bufferedAmount, protocol
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市逾滥,隨后出現(xiàn)的幾起案子峰档,更是在濱河造成了極大的恐慌,老刑警劉巖寨昙,帶你破解...
    沈念sama閱讀 218,607評(píng)論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件讥巡,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡舔哪,警方通過查閱死者的電腦和手機(jī)欢顷,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,239評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來捉蚤,“玉大人抬驴,你說我怎么就攤上這事±虑桑” “怎么了布持?”我有些...
    開封第一講書人閱讀 164,960評(píng)論 0 355
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)陕悬。 經(jīng)常有香客問我鳖链,道長(zhǎng),這世上最難降的妖魔是什么墩莫? 我笑而不...
    開封第一講書人閱讀 58,750評(píng)論 1 294
  • 正文 為了忘掉前任芙委,我火速辦了婚禮,結(jié)果婚禮上狂秦,老公的妹妹穿的比我還像新娘灌侣。我一直安慰自己,他們只是感情好裂问,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,764評(píng)論 6 392
  • 文/花漫 我一把揭開白布侧啼。 她就那樣靜靜地躺著,像睡著了一般堪簿。 火紅的嫁衣襯著肌膚如雪痊乾。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,604評(píng)論 1 305
  • 那天椭更,我揣著相機(jī)與錄音哪审,去河邊找鬼。 笑死虑瀑,一個(gè)胖子當(dāng)著我的面吹牛湿滓,可吹牛的內(nèi)容都是我干的滴须。 我是一名探鬼主播,決...
    沈念sama閱讀 40,347評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼叽奥,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼扔水!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起朝氓,我...
    開封第一講書人閱讀 39,253評(píng)論 0 276
  • 序言:老撾萬榮一對(duì)情侶失蹤魔市,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后赵哲,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體待德,經(jīng)...
    沈念sama閱讀 45,702評(píng)論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,893評(píng)論 3 336
  • 正文 我和宋清朗相戀三年誓竿,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了磅网。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,015評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡筷屡,死狀恐怖涧偷,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情毙死,我是刑警寧澤燎潮,帶...
    沈念sama閱讀 35,734評(píng)論 5 346
  • 正文 年R本政府宣布,位于F島的核電站扼倘,受9級(jí)特大地震影響确封,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜再菊,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,352評(píng)論 3 330
  • 文/蒙蒙 一爪喘、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧纠拔,春花似錦秉剑、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,934評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至臀叙,卻和暖如春略水,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背劝萤。 一陣腳步聲響...
    開封第一講書人閱讀 33,052評(píng)論 1 270
  • 我被黑心中介騙來泰國(guó)打工渊涝, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,216評(píng)論 3 371
  • 正文 我出身青樓驶赏,卻偏偏與公主長(zhǎng)得像炸卑,于是被迫代替她去往敵國(guó)和親既鞠。 傳聞我的和親對(duì)象是個(gè)殘疾皇子煤傍,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,969評(píng)論 2 355

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

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