在Node.js下运用MQTT协议实现即时通讯及离线推送的方法
青荼 人气:0前言
前些日子了解到mqtt这样一个协议,可以在web上达到即时通讯的效果,但网上并不能很方便地找到一篇目前版本的在node下正确实现这个协议的博客。
自己捣鼓了一段时间,理解不深刻,但也算是基本能够达到使用目的。
本文尚未对离线消息的接收顺序进行处理。
代码
服务端: server.js
//服务端引入中间件mosca let mosca = require('mosca') let settings = { port: 5112 } let server = new mosca.Server(settings) server.on('ready', function(){ console.log('Mosca server is up and running at port 5112'); }) server.on('published', function(packet, client) { console.log('Published', packet.payload) }) server.on('clientDisconnected', function(client){ console.log('disconnected: ', client.id) })
推送端: pub.js
//客户端引入mqtt let mqtt = require('mqtt'); let client = mqtt.connect('mqtt://localhost', { port: 5112, clientId: 'cli_pub', }) let num = 0; setInterval(function (){ client.publish('test', 'Hello mqtt ' + (++num), {qos:1}, () => console.log(num)); }, 1000)
订阅端: sub.js
let mqtt = require('mqtt') let client = mqtt.connect('mqtt://localhost', { port: 5112, clientId: 'cli_sub', }) client.subscribe('test',{qos:1}) client.on('message', function (topic, message) { console.log('received message: ', message.toString()) })
server运行后,先启动pub,再启动sub,即可在sub中接收到推送过来的消息序列
至此实现了简单的即时推送
离线推送相关配置及简要介绍
离线配置-服务端:
要实现消息的离线推送,必然需要一个存储临时数据的部件
此处用到的是mongo,当然可以根据需要选择其他的存储工具
server.js中的settings需更改为:
let settings = { port: 5112, persistence:{ //增加了此项 factory: mosca.persistence.Mongo, url: "mongodb://localhost:27017/mosca" } }
factory: 引入mosca对特定存储工具的一些处理方法
url: 其中的 27017 为mongo所监听的端口号,mosca为存储相关数据的数据库
值得一提的是:配置好mongo的环境后,不需要提前在mongo中手动创建,若数据库不存在会自动生成,而且mosca会为你作好其他一切基本事项 (即:若只想临时体验下效果,甚至可以暂时把mongo放一边 )
在mongo中,可以看到自动新添了db: mosca及其下的collection(相当于关系型数据库中的表/关系)
离线配置-客户端:
pub.js和sub.js中的client中都可以改为:
let client = mqtt.connect('mqtt://localhost', { port: 5112, clientId: 'cli_**', clean: false//增加了此项 })
- clientId: 区分客户端的识别码
- clean: 此处决定了客户端在服务端的session是否会被清除,默认为true,为实现离线推送,我们需要将其保留
- clean及上文中的persistence为实现离线推送的关键配置
mqtt.connect()会返回一个mqttClient对象,包含了:reconnect(), subscribe(), publish()等一系列方法。
本文中发送端接收端被分为了pub.js和sub.js两个独立文件,仅仅为了方便在不同控制台中观察效果
一个client可以既为推送端,又为订阅端
至此,所有代码已完成
其他介绍:
client.subscribe():
为本客户端订阅一个话题,所有订阅此话题的用户都会收到在此话题下推送的信息
//client.subscribe(topic,opts) client.subscribe('test',{qos:1})
opts中的qos为通信机制,控制发送端与接收端的互锁程度
上文中的其中一个collection: subscriptions即记录各用户话题订阅情况
用户cli_sub及cli2_sub订阅了话题test:
(新增一个cli2_pub,下文有用)
注:
重复执行脚本sub.js实际上对topic进行了重复订阅
实际编码时,应避免topic的重复订阅,即使重复订阅并不影响实现效果
client.publish():
向指定topic发送数据
message为Buffer或String格式,可以通过序列化或转json实现对复杂数据对象的传送
//client.publish(topic, message, opts, callback) let num = 0; setInterval(function (){ client.publish('test', 'Hello mqtt ' + (++num), {qos:1}, () => console.log(num)); }, 1000)
参数不再赘述
此处用一个定时器定时在 topic: test 下发送'Hello mqtt 1,2,3..'
用回调函数实时打印一下发送的num:
当订阅者处于离线状态时,可以在collection: packets中查看到临时数据的存储情况:
mosca把每一条推送消息为所有订阅用户都生成了独立的记录,用同一个messageId进行关联
当其中一个用户(cli2_sub)上线时,获取到其对应的数据,
而后数据库中相应记录便会被删除
此时仅有cli_sub用户的数据
当cli2_sub上线接收消息后,packets中记录将被清空
client.on():
即在client上触发的事件,此处只列举消息接收事件
//client.on(event, callback) client.on('message', function (topic, message) { console.log('received message: ', message.toString()) })
处理为简单地打印到控制台
加载全部内容