背景:最近接触到MQTT协议用来和设备进行数据对接。先将设备的信息接入网关,网关配置采集的信息后发送到MQTT服务器中,我们在启动java程序来拉取MQTT topic中的数据
MQTT服务器使用 EMQX(Docker 部署指南 | EMQX 5.1 文档) 文档很全,我这里使用开源版本。
MQTT客户端工具使用 MQTTX(MQTTX: Your All-in-one MQTT Client Toolbox)
使用Java语言,完成MQTT的学习和测试,
1.引入pom依赖
<dependency>
<groupId>org.eclipse.paho</groupId>
<artifactId>org.eclipse.paho.client.mqttv3</artifactId>
<version>1.2.4</version>
</dependency>
2.编写测试代码
@Test
void testSub() throws MqttException, InterruptedException {
String clientId = "client-testSub2";
MqttConnectOptions options = new MqttConnectOptions();
options.setServerURIs(new String[]{"tcp://192.168.**.**:1883"});
options.setUserName("");
options.setPassword("".toCharArray());
options.setConnectionTimeout(10);
options.setAutomaticReconnect(true);
options.setCleanSession(false);
MqttClient mqttClient = new MqttClient(options.getServerURIs()[0], clientId, new MemoryPersistence());
mqttClient.connect(options);
mqttClient.setCallback(new MqttCallback() {
@Override
public void connectionLost(Throwable cause) {
}
@Override
public void messageArrived(String topic, MqttMessage message) throws Exception {
System.out.println(topic + "收到messageId=" + message.getId() + ",payload=" + new String(message.getPayload()));
String msg = new String(message.getPayload());
if ("1".equals(msg)) {
throw new RuntimeException("模拟消息处理失败");
}
}
@Override
public void deliveryComplete(IMqttDeliveryToken token) {
}
});
mqttClient.subscribe(new String[]{"topic/testPublish"}, new int[] {1});
while(true) {
Thread.sleep(30 * 1000);
}
}
3.假设MQTT服务端已安装完毕,MQTTX已安装完毕,使用MQTTX连接MQTT服务端
4.测试retain消息
mqtt协议设计retain消息是用来,当一个订阅者订阅了一个topic后,这个topic的retain消息就可以接收到,如果订阅者id不变且保留session,当不重新订阅topic时不会收到retain消息,如果重新订阅则会再次收到retain消息。注意:一个topic只能有一条retain消息,新发的会替代旧的;当不需要保留retain消息时,发送一条payload为空的消息就可以了;这里无论qos是什么都一样
retain消息:用来针对数据采集间隔时间长的情景,这样新上线的订阅者就可以得到上一次设备的数据。
4.1 发送retain消息
4.2 启动Java程序
当关闭Java程序,再次启动时,它会再次消费
发送一个内容为空的Retain消息
消费者会再次接收一个内容为空的Retain消息
再次启动就不会再收到Retain消息了
5.订阅消息及指定等级
QOS=0 至多一次,消息发送接收依赖TCP
QOS=1 承诺至少会有一次发送给接收者
QOS=2 保证消息仅仅传送到目的地一次
结论:订阅消息的处理逻辑要看发送消息的qos及订阅消息的qos,取最下的那个执行。
当相同的clientId订阅同一个主题时,消息将会以轮询的方式被每个消费者消费
5.1 发送qos=0 接收qos=0 1 2
5.1.1 发送消费会出现异常的消息,也只会处理一次
5.2 发送qos=1 2 接收qos=0
效果等同 发送qos=0 接收qos=0 1 2
5.2.1 发送消费会出现异常的消息,也只会处理一次
5.3 发送qos=1 接收qos=1 2
发送一次会导致消费失败的消息
5.3.1 消费失败后会再次收到失败的消息,重复消费
5.4 发送qos=2 接收 2
效果和发送qos=1 接收qos=1 2的一致
5.4.1 消费失败后会再次收到失败的消息,重复消费
6.cleanSession
结论:无论qos为多少,cleanSession为true时,消费端下线时的消息都不能被消费。cleanSession为false时,mqtt broker没有自动清除session时,消费端下线时的消息可以被消费。
7. 异常
7.1 消费能触发消费异常的消息
当发送qos=0 接收qos=0,先发送一条会触发消费异常的消息,程序启动后会触发异常,程序会自动退出。如果程序先启动起来,再收到能触发异常的消息,程序会正常执行