項目背景介紹
專注于為中小企業(yè)提供網(wǎng)站制作、做網(wǎng)站服務(wù),電腦端+手機端+微信端的三站合一,更高效的管理,為中小企業(yè)新河免費做網(wǎng)站提供優(yōu)質(zhì)的服務(wù)。我們立足成都,凝聚了一批互聯(lián)網(wǎng)行業(yè)人才,有力地推動了近1000家企業(yè)的穩(wěn)健成長,幫助中小企業(yè)通過網(wǎng)站建設(shè)實現(xiàn)規(guī)模擴充和轉(zhuǎn)變。
最近在寫的項目中存在著社交模塊,需要實現(xiàn)這樣的一個功能:當(dāng)發(fā)生了用戶被點贊、評論、關(guān)注等操作時,需要由服務(wù)器向用戶實時地推送一條消息。最終完成的項目地址為:https://github.com/noiron/socket-message-push,這里將介紹一下實現(xiàn)的思路及部分代碼。
項目的流程中存在著這樣的幾個對象:
事件處理的流程如下:
考慮消息推送服務(wù)器上必須記錄下當(dāng)前在線用戶的信息,這樣才能向特定的用戶推送消息。所以當(dāng)用戶登錄時,必須將自身的用戶信息發(fā)到 Node.js 服務(wù)器上。為了達到這種雙向的實時消息傳遞,很明顯地考慮用 WebSocket 來實現(xiàn)。既然我們在消息推送服務(wù)器上使用了 Node.js,我們就有了一個很方便的選項:socket.io。
Socket.io 介紹
Socket.io是一個用 JavaScript 實現(xiàn)的實時雙向通信的庫,利用它來實現(xiàn)我們的功能會很簡單。
socket.io 包含兩個部分:
可以看看如下的 socket.io 的示例代碼,它給出了 socket.io 發(fā)出及監(jiān)聽事件的基本用法:
io.on('connection', function(socket){ socket.emit('request', /* */); // emit an event to the socket io.emit('broadcast', /* */); // emit an event to all connected sockets socket.on('reply', function(){ /* */ }); // listen to the event });
關(guān)于 Socket.io 還有一點需要注意:Socke.io 并不完全是 WebSocket 的實現(xiàn)。
Note: Socket.IO is not a WebSocket implementation. Although Socket.IO indeed uses WebSocket as a transport when possible, it adds some metadata to each packet: the packet type, the namespace and the ack id when a message acknowledgement is needed.
接下來我們需要用 Express.js 來建立一個服務(wù)器端程序,并在其中引入 Socket.io。
Node.js 服務(wù)器的搭建
利用 Express.js 搭建基礎(chǔ)服務(wù)器
我們使用了 Express.js 來搭建 Node.js 消息推送服務(wù)器,先利用一個簡要的例子來瀏覽其功能:
// server.js const express = require('express'); const app = express(); const path = require('path'); const http = require('http').Server(app); const port = 4001; app.use(express.static(path.join(__dirname, 'public'))); app.get('/', function(req, res) { res.sendFile(__dirname + '/public/index.html'); }); app.get('/api', function(req, res) { res.send('.'); }); http.listen(port, function() { console.log(`listening on port:${port}`); });
將上面的代碼保存為 server.js,新建一個 public 文件夾,在其中放入 index.html 文件。運行以下命令:
node server.js
現(xiàn)在即可在 localhost:4001 查看效果了。
引入 Socket.io
現(xiàn)在已經(jīng)有了一個基礎(chǔ)的 Express 服務(wù)器,接下來需要將 Socket.io 加入其中。
const io = require('socket.io')(http); io.on('connection', function(socket) { console.log('a user connected'); socket.broadcast.emit('new_user', {}); }
這里的 io 監(jiān)聽 connection 事件,當(dāng) client 與 server 建立了連接之后,這里的回調(diào)函數(shù)會被調(diào)用( client中的代碼將在下一節(jié)介紹)。
函數(shù)的參數(shù) socket 代表的是當(dāng)前的 client 和 server 間建立的這個連接??稍?client 程序中將這個建立的 socket 連接打印出來,如下圖所示:
其中的 id 屬性可以用于標(biāo)識出這一連接,從而 server 可以向特定的用戶發(fā)送消息。
socket.broadcast.emit('new_user', {});
這一行代碼表示 socket 將向當(dāng)前所有與 server 建立了連接的 client(不包括自己) 廣播一條名為 new_user 的消息。
后端推送消息的處理流程
對用戶信息的處理
方便起見,這里只用一個數(shù)組保存用戶信息,實際工作中可以根據(jù)需要放入數(shù)據(jù)庫中保存。
global.users = []; // 記錄下登錄用戶的tokenId, socketId
當(dāng)用戶登錄時, client 會向 server 發(fā)送 user_login 事件,服務(wù)器接收到后會做如下操作:
socket.on('user_login', function(info) { const { tokenId, userId, socketId } = info; addSocketId(users, { tokenId, socketId, userId }); });
addSocketId() 會向 users 數(shù)組中添加用戶信息,不同用戶通過 tokenId 進行區(qū)分,每個用戶有一個 socketIds 數(shù)組,保存可能存在的多個 socketId。該函數(shù)的具體代碼可見 src/utils.js 文件。
同理,還有一個 deleteSocketId() 函數(shù)用于刪除用戶信息,代碼可見同一文件。
在獲取了用戶的 tokenId 之后,就需要找到對應(yīng)的 socketId,然后向特定用戶推送消息。
// 只向 id = socketId 的這一連接發(fā)送消息 io.sockets.to(socketId).emit('receive_message', { entityType, data });
服務(wù)器的思路大致如此,接下來介紹客戶端中是如何進行相應(yīng)的處理的。
客戶端
Socket.io 的初始化
首先在 html 文件中引入 Socket.io 的 client 端文件,例如通過 cdn 引入:
其它的引入方式:
const io = require('socket.io-client'); // or with import syntax import io from 'socket.io-client';
引入 Socket.io 后就獲得了 io 函數(shù),通過它來與消息推送服務(wù)器建立連接。
// 假設(shè)你將 Node 服務(wù)器部署后的地址為:https://www.example.com/ws // 則: WS_HOST = 'https://www.example.com' const msgSocket = io(`${WS_HOST}`, { secure: true, path: '/ws/socket.io' });
如果監(jiān)聽本地:
const msgSocket = io('http://localhost:4001');
這里如果寫成 io('https://www.example.com/ws') 會出現(xiàn)錯誤,需要將 /ws 寫入path中。
為了能在其它文件使用這一變量,可將 msgSocket 作為一個全局變量:
window.msgSocket = msgSocket;
用戶建立連接
// 用戶登錄時,向服務(wù)器發(fā)送用戶的信息。服務(wù)器會在收到信息后建立 socket 與用戶的映射。 msgSocket.emit('user_login', { userId, socketId: msgSocket.id, tokenId });
接收到推送的消息后的處理
// WebSocket 連接建立后,監(jiān)聽名為 receive_message 的事件 msgSocket.on('receive_message', msg => { store.dispatch({ type: 'NEW_SOCKET_MSG', payload: msg }); });
當(dāng) WebSocket 服務(wù)器向客戶端推送了消息之后,客戶端需要監(jiān)聽 receive_message 事件,接收到的參數(shù)中有相應(yīng)待處理的信息。
由于使用了 Redux 進行數(shù)據(jù)的處理,所以這里 dispatch 了一個 NEW_SOCKET_MSG action,后續(xù)則是常規(guī)的 redux 處理流程了。
項目的使用
GitHub 上的項目地址:https://github.com/noiron/socket-message-push
npm run dev
即可在 devlopment 環(huán)境下進行測試,現(xiàn)在你就有了一個運行在4001端口的消息推送服務(wù)器了。
但是這里并沒有后端的服務(wù)器來向我們發(fā)送消息,所以我們將利用 Postman 來模擬發(fā)送消息。
為了展示程序的功能,在項目的 client 文件夾下放置了一個 index.html 文件。注意這個文件并不能用在實際的項目中,只是用來顯示消息推送的效果而已。
在開啟了服務(wù)器之后,打開 client/index.html,根據(jù)提示隨意輸入一個 tokenId 即可。
現(xiàn)在利用 Postman 向 localhost:4001/api post 如下的一條信息:
{ // tokens 數(shù)組表示你想向哪個用戶推送消息 "tokens": ["1", "2"], "data": "You shall not pass!!!" }
至此,如果一切順利,你應(yīng)該能夠在 client 的控制臺中看到收到的消息了。
你可以打開多個 client 頁面,輸入不同的 tokenId,然后檢查消息是否發(fā)送給了正確的用戶。
總結(jié)
以上所述是小編給大家介紹的利用Socket.io 實現(xiàn)消息實時推送功能,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復(fù)大家的。在此也非常感謝大家對創(chuàng)新互聯(lián)網(wǎng)站的支持!