【學習筆記】基於eclipse.paho的Java端mqtt發佈者和訂閱者實例

mqtt介紹

MQTT（Message Queuing Telemetry Transport，消息隊列遙測傳輸協議），是一種基於發佈/訂閱（publish/subscribe）模式的"輕量級"通訊協議，該協議構建於TCP/IP協議上，由IBM在1999年發佈。MQTT最大優點在於，可以以極少的代碼和有限的帶寬，爲連接遠程設備提供實時可靠的消息服務。作爲一種低開銷、低帶寬佔用的即時通訊協議，使其在物聯網、小型設備、移動應用等方面有較廣泛的應用。

特點

1. 基於發佈/訂閱模型
2. 使用二進制協議，緊湊，佔用空間小
3. 提供三種qos保障：0-最多一次，1-至少一次，2-僅一次

mqtt服務安裝

mqtt服務器

比較常用的是mosquitto作爲mqtt的服務器。
因公司需要搭建emqx，故本文將以emqx作爲服務器，mosquitto可自行百度查閱相關文章。

emqx安裝

emqx安裝可直接參考官方文檔emqx官方文檔

基於paho的生產者實例

maven 依賴

    <dependency>
      <groupId>org.eclipse.paho</groupId>
      <artifactId>org.eclipse.paho.client.mqttv3</artifactId>
      <version>1.2.0</version>
    </dependency>

發佈者實現

注：項目運行在spring環境裏
發佈者客戶端構建

    @Bean
   public MqttClient buildMqttClient(){
       try {
           MqttClient client=new MqttClient(MqttConfig.HOST,"server11",new MemoryPersistence());
           MqttConnectOptions options = new MqttConnectOptions();
           options.setCleanSession(false);
           options.setUserName(MqttConfig.USERNAME);
           options.setPassword(MqttConfig.PASSWORD.toCharArray());
           // 設置超時時間
           options.setConnectionTimeout(10);
           // 設置會話心跳時間
           options.setKeepAliveInterval(20);
           client.setCallback(new PushCallback());
           client.connect(options);
           return client;
       } catch (MqttException e) {
           e.printStackTrace();
       }
       return null;
   }

使用

MqttTopic topic=mqttClient.getTopic("test_topic");
MqttMessage msg=new MqttMessage();
 msg.setQos(1);
 msg.setPayload(("this is test info from mqtt server\t"+LocalDateTime.now()).getBytes());
 msg.setRetained(true);
 try {
     MqttDeliveryToken token=topic.publish(msg);
     token.waitForCompletion();
     System.out.println("消息推送成功:"+LocalDateTime.now());
 } catch (MqttException e) {
     System.err.println("消息推送失敗:"+LocalDateTime.now());
     e.printStackTrace();
 }

基於paho的消費者實例

maven 依賴

    <dependency>
      <groupId>org.eclipse.paho</groupId>
      <artifactId>org.eclipse.paho.client.mqttv3</artifactId>
      <version>1.2.0</version>
    </dependency>

訂閱者實現

MqttClient client=new MqttClient("tcp://127.0.0.1:1883","client11",new MemoryPersistence());
MqttConnectOptions options=new MqttConnectOptions();
// 設置是否清空session,這裏如果設置爲false表示服務器會保留客戶端的連接記錄，設置爲true表示每次連接到服務器都以新的身份連接
options.setCleanSession(false);
// 設置連接的用戶名
options.setUserName("admin");
// 設置連接的密碼
options.setPassword("public".toCharArray());
// 設置超時時間 單位爲秒
options.setConnectionTimeout(10);
// 設置會話心跳時間 單位爲秒 服務器會每隔1.5*20秒的時間向客戶端發送個消息判斷客戶端是否在線，但這個方法並沒有重連的機制
options.setKeepAliveInterval(20);
// 設置回調
client.setCallback(new PushCallback());
//MqttTopic topic = client.getTopic(TOPIC1);
client.connect(options);
//訂閱消息
int[] Qos  = {1};
String[] topic1 = {"test_topic"};
client.subscribe(topic1, Qos);
System.out.println("消息訂閱:"+topic1[0]+"\n");

pushcallback

class PushCallback implements MqttCallback {

   @Override
   public void connectionLost(Throwable throwable) {
       System.out.println("連接斷開");
   }

   @Override
   public void messageArrived(String s, MqttMessage msg) throws Exception {
       System.out.println("消費消息");
       System.out.println("主題:"+s);
       System.out.println("消息qos:"+msg.getQos());
       System.out.println("消息內容:"+new String(msg.getPayload())+"\n");
   }

   @Override
   public void deliveryComplete(IMqttDeliveryToken token) {
       System.out.println("deliveryComplete-----"+token.isComplete());
   }
}

注意事項

mqtt端口

mqtt默認端口如下

端口	協議及作用
1883	MQTT protoc port
8883	MQTT/SSL port
8083	MQTT/WebSocket port
8080	HTTP API port
18083	Dashboard Management Console Port

這裏面需要注意的是8080與tomcat默認端口衝突，需要注意下。

關於qos

qos等級	說明
0	最多一次的傳輸
1	至少一次的傳輸
2	只有一次的傳輸

1. 訂閱和發佈都可以指定qos，但最終qos是他們當中的最小值
2. 如果qos爲1，publisher發佈的消息必須設置setRetained(true)，這樣才能保存重發。