目标
1.安装EMQ
2.使用java发布消息到EMQ、订阅消费EMQ消息
3.常见MQTT客户端
概述
1,MQTT 介绍
(1)MQTT(Message Queuing Telemetry Transport,消息队列遥测传输)是 IBM 开发的一个即时通讯协议,它是一种轻量级的、基于代理的“发布/订阅”模式的消息传输协议。
(2)MQTT 具有协议简洁、小巧、可扩展性强、省流量、省电等优点,比较适合于在低带宽、不可靠的网络的进行远程传感器和控制设备通讯等,正在日益成为物联网通信协议的重要组成部分。
2,MQTT 特性
MQTT 协议工作在低带宽、不可靠的网络的远程传感器和控制设备通讯而设计的协议,它具有以下主要的几项特性:
(1)使用发布/订阅消息模式,提供一对多的消息发布,解除应用程序耦合。
(2)对负载内容屏蔽的消息传输。
(3)使用 TCP/IP 提供网络连接。
- 主流的 MQTT 是基于 TCP 连接进行数据推送的,但是同样有基于 UDP 的版本,叫做 MQTT-SN。这两种版本由于基于不同的连接方式,优缺点自然也就各有不同了。
(4)有三种消息发布服务质量:
- “至多一次”:消息发布完全依赖底层 TCP/IP 网络。会发生消息丢失或重复。这一级别可用于如下情况,环境传感器数据,丢失一次读记录无所谓,因为不久后还会有第二次发送。这一种方式主要普通 APP 的推送,倘若你的智能设备在消息推送时未联网,推送过去没收到,再次联网也就收不到了。
- “至少一次”:确保消息到达,但消息重复可能会发生。
- “只有一次”:确保消息到达一次。在一些要求比较严格的计费系统中,可以使用此级别。在计费系统中,消息重复或丢失会导致不正确的结果。这种最高质量的消息发布服务还可以用于即时通讯类的 APP 的推送,确保用户收到且只会收到一次。
(5)小型传输,开销很小(固定长度的头部是 2 字节),协议交换最小化,以降低网络流量。
- 这就是为什么在介绍里说它非常适合“在物联网领域,传感器与服务器的通信,信息的收集”,要知道嵌入式设备的运算能力和带宽都相对薄弱,使用这种协议来传递消息再适合不过了。
3,实现方式
(1)实现 MQTT 协议需要客户端和服务器端通讯完成,在通讯过程中,MQTT 协议中有三种身份:发布者(Publish)、代理(Broker)(服务器)、订阅者(Subscribe)。其中:
- 消息的发布者和订阅者都是客户端
- 消息代理是服务器
- 消息发布者可以同时是订阅者
(2)MQTT 传输的消息分为:主题(Topic)和负载(payload)两部分:
- Topic:可以理解为消息的类型,订阅者订阅(Subscribe)后,就会收到该主题的消息内容(payload);
- payload:可以理解为消息的内容,是指订阅者具体要使用的内容。
4,MQTT 发布订阅模式简述
(1)MQTT 是发布、订阅(Publish/Subscribe) 模式的消息协议,与 HTTP 协议请求、响应(Request/Response) 模式不同。
(2)MQTT 发布者与订阅者之间通过“主题”(Topic) 进行消息路由,主题(Topic) 格式类似 Unix 文件路径,例如:
MQTT 主题(Topic) 支持’+’, ‘#’的通配符:
- +:通配一个层级
- #:通配多个层级(必须在末尾)
sensor/1/temperature
chat/room/subject
presence/user/feng
sensor/1/#
sensor/+/temperature
uber/drivers/joe/inbox
(3)发布、订阅的主题说明:
- MQTT 消息发布者(Publisher)只能向特定“名称主题”(不支持通配符)发布消息
- 订阅者(Subscriber)通过订阅“过滤主题”(支持通配符)来匹配消息
安装EMQ
MQTT消息中间件常见的主要有EMQX:github 4882 stars、Mosquitto:github 1645 stars、Apollo:ActiveMQ的升级版,github 109 stars。本文讲解使用较多的EMQ。
1.本文基于Centos7 x86_64
x86_64,x64,AMD64基本上是同一个东西
x86是intel开发的一种32位指令集
x86_64是一种64位的指令集,x86_64是x86指令的超集,在x86上可以运行的程序,在x86_64上也可以运行,x86_64是AMD发明的,也叫AMD64
2.按照官网 https://www.emqx.cn/downloads 安装
1. 下载 emqx-ee-centos7-4.3.1-amd64.rpmSHA256
wget -P /home https://www.emqx.cn/downloads/enterprise/v4.3.1/emqx-ee-centos7-4.3.1-amd64.rpm
-P指定下载目录
2. 安装
sudo yum install emqx-ee-centos7-4.3.1-amd64.rpm
3. 运行
sudo emqx start
Centos 7 关闭防火墙
1、开放EMQ服务器常用的TCP端口
firewall-cmd --permanent --add-port=1883/tcp
# 开放1883端口
firewall-cmd --permanent --add-port=18083/tcp
#
Dashboard 管理控制台端口
firewall-cmd --reload
# 配置立即生效1883:MQTT 协议端口 8883:MQTT/SSL 端口
8083:MQTT/WebSocket 端口 8080:HTTP API 端口 18083:Dashboard 管理控制台端口
2、查看防火墙所有开放的端口
firewall-cmd --zone=public --list-ports
3.、关闭防火墙
如果要开放的端口太多,嫌麻烦,可以关闭防火墙,安全性自行评估
systemctl stop firewalld.service
4、查看防火墙状态
firewall-cmd --state
查看 Dashboard
EMQ X Dashboard 是一个 Web 应用程序,你可以直接通过浏览器来访问它,无需安装任何其他软件。
当 EMQ X 成功运行在你的本地计算机上且 EMQ X Dashboard 被默认启用时,你可以访问 http://localhost:18083 来查看你的 Dashboard,默认用户名是
admin
,密码是public
。
MQTT Box
MQTT客户端工具有很多,比如MQTT.fx,Mosquito CLI、MQTTX、MQTT Box、mqtt-spy、MQTT Lens,选择一个项目组已经使用的 MQTT Box来介绍。推荐使用MQTTX,和EMQ配套客户端程序。
MQTT Box 是 Sathya Vikram 个人开发的 MQTT 客户端工具,最初仅在 Chrome (https://chrome.google.com/webstore/detail/mqtt-client-tcp-and-ws/kaajoficamnjijhkeomgfljpicifbkaf?utm_source=chrome-ntp-launcher) 上使用,作为浏览器拓展安装使用, 后经重写开源成为桌面端跨平台独立软件。
1.windows、mac版本下载页面打不开 使用Chrome插件方式
2.Menu---MQTT CLIENTS 新建MQTT客户端
EMQ服务器默认的用户名/密码 admin/public
默认的TCP连接端口为1883
3.发布、订阅主题实现消息通信
发布的主题名字随意,只要订阅者订阅相同名字主题即可实现消费
Java发布、订阅EMQ
通过 Maven 安装 Paho Java
通过包管理工具 Maven 可以方便地安装 Paho Java 客户端库,截止目前最新版本安装如下:
<dependency> <groupId>org.eclipse.paho</groupId> <artifactId>org.eclipse.paho.client.mqttv3</artifactId> <version>1.2.2</version> </dependency>
Paho Java 使用示例
Java 体系中 Paho Java 是比较稳定、广泛应用的 MQTT 客户端库,本示例包含 Java 语言的 Paho Java 连接 EMQ X Broker,并进行消息收发完整代码:
App.java
package io.emqx; import org.eclipse.paho.client.mqttv3.MqttClient; import org.eclipse.paho.client.mqttv3.MqttConnectOptions; import org.eclipse.paho.client.mqttv3.MqttException; import org.eclipse.paho.client.mqttv3.MqttMessage; import org.eclipse.paho.client.mqttv3.persist.MemoryPersistence; public class App { public static void main(String[] args) { String subTopic = "testtopic/#"; String pubTopic = "testtopic/1"; String content = "Hello World"; int qos = 2; # emqx官方服务器 String broker = "tcp://broker.emqx.io:1883"; String clientId = "emqx_test"; MemoryPersistence persistence = new MemoryPersistence(); try { MqttClient client = new MqttClient(broker, clientId, persistence); // MQTT 连接选项 MqttConnectOptions connOpts = new MqttConnectOptions(); connOpts.setUserName("emqx_test"); connOpts.setPassword("emqx_test_password".toCharArray()); // 保留会话 connOpts.setCleanSession(true); // 设置回调 client.setCallback(new OnMessageCallback()); // 建立连接 System.out.println("Connecting to broker: " + broker); client.connect(connOpts); System.out.println("Connected"); System.out.println("Publishing message: " + content); // 订阅 client.subscribe(subTopic); // 消息发布所需参数 MqttMessage message = new MqttMessage(content.getBytes()); message.setQos(qos); client.publish(pubTopic, message); System.out.println("Message published"); client.disconnect(); System.out.println("Disconnected"); client.close(); System.exit(0); } catch (MqttException me) { System.out.println("reason " + me.getReasonCode()); System.out.println("msg " + me.getMessage()); System.out.println("loc " + me.getLocalizedMessage()); System.out.println("cause " + me.getCause()); System.out.println("excep " + me); me.printStackTrace(); } } }
回调消息处理类 OnMessageCallback.java
package io.emqx; import org.eclipse.paho.client.mqttv3.IMqttDeliveryToken; import org.eclipse.paho.client.mqttv3.MqttCallback; import org.eclipse.paho.client.mqttv3.MqttMessage; public class OnMessageCallback implements MqttCallback { public void connectionLost(Throwable cause) { // 连接丢失后,一般在这里面进行重连 System.out.println("连接断开,可以做重连"); } public void messageArrived(String topic, MqttMessage message) throws Exception { // subscribe后得到的消息会执行到这里面 System.out.println("接收消息主题:" + topic); System.out.println("接收消息Qos:" + message.getQos()); System.out.println("接收消息内容:" + new String(message.getPayload())); } public void deliveryComplete(IMqttDeliveryToken token) { System.out.println("deliveryComplete---------" + token.isComplete()); } }
内参资料
MQTT系列教程1(基本概念介绍)https://www.hangge.com/blog/cache/detail_2347.html
MQTT系列教程2(消息服务器EMQ的搭建和使用)https://www.hangge.com/blog/cache/detail_2348.html#
MQTT系列教程3(客户端工具MQTTBox的安装和使用)https://www.hangge.com/blog/cache/detail_2350.html
MQTT 客户端工具 https://segmentfault.com/a/1190000021106683
常见MQTT服务器搭建与试用 https://www.jianshu.com/p/e5cf0c1fd55c
中文官网资料
EMQ X Broker https://www.emqx.cn/products/broker
MQTT Java 客户端库 https://docs.emqx.cn/broker/v4.3/development/java.html#%E9%80%9A%E8%BF%87-maven-%E5%AE%89%E8%A3%85-paho-java