mqtt协议实战(一)

背景

最近项目中用到了mqtt的协议,今天特地抽时间学习了一下,搭建了一个基于nodejs的mqtt的服务。现在写一篇文章记录,分享给大家。

本案例使用的nodejs,mqtt的代理服务是使用的是mosca。客户端使用的是mqtt.js
其实网上也有几篇写mqtt的集成,但写的都很随便,时间也比较久,对于集成中的问
题,大多是一带而过,这篇文章我不仅带大家了解mqtt的主要特点,还交大家真正实战mqtt协议。

mqtt简介

如果有人问你什么是mqtt协议,有什么特点,你就用下面这段官方的话来回答他。

MQTT(Message Queuing Telemetry Transport,消息队列遥测传输协议),是一种基于发布/订阅(publish/subscribe)模式的"轻量级"通讯协议,该协议构建于TCP/IP协议上,由IBM在1999年发布。MQTT最大优点在于,可以以极少的代码和有限的带宽,为连接远程设备提供实时可靠的消息服务。作为一种低开销、低带宽占用的即时通讯协议,使其在物联网、小型设备、移动应用等方面有较广泛的应用。

MQTT是一个基于客户端-服务器的消息发布/订阅传输协议。MQTT协议是轻量、简单、开放和易于实现的,这些特点使它适用范围非常广泛。在很多情况下,包括受限的环境中,如:机器与机器(M2M)通信和物联网(IoT)。其在,通过卫星链路通信传感器、偶尔拨号的医疗设备、智能家居、及一些小型化设备中已广泛使用。

整理以上的概念描述我们可以得到,
mqtt协议的特点

  • 占用带宽小
  • 稳定可靠
  • 发布/订阅
  • 使用代码少

后面我将根据mqtt的这几个特点,为大家在实战中一一演示,解释mqtt的这些特点。

mqtt协议需要一个中间代理服务器,这个东西是其实就像一个传话筒,把客户端推送的消息,推送给指定的客户端。

主要用三个角色,订阅,mqtt代理,发布。下面这张图解释的很清楚。

概念性的东西的我们就说到这里,下面进入实战阶段。

nodejs集成mqtt

  • 创建一个mqtt-test文件夹
  • 使用npm init初始化成nodejs的项目目录
    安装二个npm包 mqttmosca
npm install mosca mqtt --save

编写服务端代码

根目录下创建一个index.js

这里是用于编写服务端的代码,创建mqtt代理服务,

接受客户端发送的事件进行业务逻辑处理,然后再推送给订阅者。

index.js的代码如下

const mosca = require("mosca");
const MqttServer = new mosca.Server({
  port: 1883
});
MqttServer.on("clientConnected", function (client) {
  //当有客户端连接时的回调.
  console.log("client connected", client.id);
});
/**
 * 监听MQTT主题消息
 * 当客户端有连接发布主题消息时
 **/
MqttServer.on("published", function (packet, client) {
  var topic = packet.topic;
  switch (topic) {
    case "temperature":
      // console.log('message-publish', packet.payload.toString());
      //MQTT可以转发主题消息至其他主题
      //MqttServer.publish({ topic: 'other', payload: 'sssss' });
      break;
    case "other":
      console.log("message-123", packet.payload.toString());
      break;
  }
});

MqttServer.on("ready", function () {
  //当服务开启时的回调
  console.log("mqtt is running...");
});

代码很好理解。
使用new mosca.Server()来创建一个服务,配置参数里只指定了一个端口,当然这里还有很多配置参数,可以指定静态目录,也可以配置ssl证书。
具体的文档在这里可以查阅得到。

具体参数如下

  • port 创建服务的端口

  • host 服务的IP地址

  • backend 配置Ascoltatore后端的所有参数对象

  • ascoltatore

  • keyPath 证书的key存放地址

  • certPath 证书的秘钥存放地址

  • static 配置一个web服务的目录

  • stats 推送的频率, 每10s。

事件列表:

  • clientConnected, 当客户端被链接时触发,客户端作为一个参数

  • clientDisconnecting, 当客户端正在断开链接时触发,客户端作为一个参数

  • clientDisconnected, 当客户端已经断开链接时触发

  • published, 当推送了一个新的消息时触发

  • subscribed, 客户端当订阅了一个主题时触发

  • unsubscribed, 当客户端取消订阅时触发

我们在index.js中监听了几个事件,
客户端链接clientConnected,发布主题消息published
以及在服务启动后的回调函数ready
代码逻辑清晰,易于理解。这正是mqtt的使用简单,便捷的特征。

需要注意的是我们虽然监听了published事件,但其实没有做任何的操作。
只是打印了消息体。这里并没有编写推送给订阅者的代码。

其实这部分在客户端订阅时限定的。客户端端可以只订阅自己需要的topic

编写推送方客户端的代码

下面我们来看一下二个客户端的代码,第一是推送方。
在根目录创建pus.js,编写内容如下

const mqtt = require("mqtt");
const client = mqtt.connect("mqtt://127.0.0.1:1883");
setInterval(function () {
  const value = Math.ceil(Math.random() * 40);
  client.publish("temperature", value.toString(), { qos: 0, retain: true });
}, 2000);

代码很简单,一句话就能解释清楚,
创建一个客户端,连接到mqtt服务,然后每2秒推送一个消息,
这里推送的消息有几个参数比较重要需要解释一下

调用client.publish()方法的第一个参数是叫做topic
表明这个消息的主题或者分类。

第二个参数是消息体,可以是String 也可以是Buffer,

这里的例子topic是temperature,注意等下需要用到这个参数。

第三个参数就是就是一些推送的参数,是一个对象。包含以下诸多参数,

  • qos 定义QoS的等级, 默认为0
  • retain 保留的标志, 布尔类型,默认false
  • dup 是否标记为副本, 布尔类型, 默认false

第四个参数是 callback 当报错时会触发该回调函数。

更加具体的参数请查询 https://www.npmjs.com/package/mqtt#publish

此外每一个客户端都有很多方法

  • mqtt.connect()
  • mqtt.Client()
  • mqtt.Client#publish()
  • mqtt.Client#subscribe()
  • mqtt.Client#unsubscribe()
  • mqtt.Client#end()
  • mqtt.Client#removeOutgoingMessage()
  • mqtt.Client#reconnect()
  • mqtt.Client#handleMessage()
  • mqtt.Client#connected
  • mqtt.Client#reconnecting
  • mqtt.Client#getLastMessageId()
  • mqtt.Store()
  • mqtt.Store#put()
  • mqtt.Store#del()
  • mqtt.Store#createStream()
  • mqtt.Store#close()

这里就不一一展开每个api的用法,后面的文章会慢慢讲解。
mqtt的api文档地址 https://www.npmjs.com/package/mqtt#api

编写订阅方客户端的代码

介绍为了推送方的js编写,我们来编写订阅方的js。
有了推送,必须要有订阅才能完整
在根目录下创建sub.js,内容如下

const mqtt = require("mqtt");
const client = mqtt.connect("mqtt://127.0.0.1:1883");
client.on("connect", function () {
  console.log("服务器连接成功");
  client.subscribe("temperature", { qos: 1 });
});
client.on("message", function (top, message) {
  console.log("当前topic:", top);
  console.log("当前温度:", message.toString());
});

订阅方的代码也很简单,首先是链接到mqtt代理服务器,
链接成功后会触发connect事件,然后在这个事件的回调函数里,调用subscribe()方法
订阅某个主题下的消息事件。

然后监听一个叫做message的事件,
回调函数里有二个参数,一个是topic,一个消息体mesage

拿我格子衫来 CSDN认证博客专家 拿我格子衫来 范马勇次郎 琦玉君
积土成山,风雨兴焉;积水成渊,蛟龙生焉;积善成德,而神明自得,圣心备焉。故不积跬步,无以至千里;不积小流,无以成江海。骐骥一跃,不能十步;驽马十驾,功在不舍。锲而舍之,朽木不折;锲而不舍,金石可镂。蚓无爪牙之利,筋骨之强,上食埃土,下饮黄泉,用心一也。蟹六跪而二螯,非蛇鳝之穴无可寄托者,用心躁也。
相关推荐
©️2020 CSDN 皮肤主题: 编程工作室 设计师:CSDN官方博客 返回首页