MQTT 2——服务端安装与客户端测试

本篇记录一下MQTT服务器，客户端，JAVA客户端的选择开发与测试

MQTT服务端选择与安装过程；
MQTT客户端测试工具安装与测试；
MQTT JAVA客户端的选择与开发，测试

---

MQTT服务器选择与安装

目前主流的开源MQTT服务器主要是以下3个：
1) EMQX:github 4882 stars
2) Mosquitto：github 1645 stars
3) Apollo：ActiveMQ的升级版，github 109 stars

我们选择EMQX作为本次MQTT的服务器，首先去EMQ官网去下载EMQX安装版,截止目前最新版本已到V4.0.4

安装步骤请参考官网给出的帮助文档

按照官网操作无法启动服务，卡在emqx start看过来
  这步很坑的，一定要需要系统先安装好ERLANG开发环境，ERLANG跳转地址,可能是因为EMQX是用ERLANG来解释或开发的

安装启动完成后，如果是安装在本机，可以在浏览器中打开http://127.0.0.1:18083，输入默认用户名“admin”和默认密码“public”，能顺利进入管理控制台说明EMQX服务器安装完成。

MQTT客户端安装与测试

客户端测试工具建议使用MQTTBox

MQTTBox有两种使用的方式：一种为Chrome插件；另外一种为Windows程序安装。

1) Chrome插件直接去Chrome插件市场搜索mqttbox即可(需要FQ)
2) Windows安装包位置：点击下载

连接MQTT服务器：

参考下图设置连接服务器，协议选择mqtt/tcp ; Host端口为1883；
其它参数暂不影响测试，有兴趣自行研究。

成功连接服务器，Connected图标会显示为绿色

增加一个订阅者

订单topic为 "hello"；Qos 为默认0

增加一个发布者

发布一个topic为"hello" 的一段消息{"hello":"world"}，Qos默认为0

消息发布后，订阅者窗口马上会收到这段消息。至此，客户端测试就完成。

MQTT JAVA客户端开发与测试

JAVA客户端选择
EMQX SDK_TOOLS上罗列的几乎所有开发语言下的开源客户端工具。JAVA下的SDK目前主要有Eclipse Paho,Xenqtt,MeQanTT,mqtt-client。

因为Spring 的 Integration Endpoints去连接官方支持DEMO里面用的就是Eclipse Paho,所以本次JAVA客户端我们选择的也是Eclipse Paho .

POM引入

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

发布端开发示例

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 PublishSample {
    public static void main(String[] args) {

        String topic = "mqtt/okok";
        String content = "hello 哈哈1";
        int qos = 1;
        String broker = "tcp://127.0.0.1:1883";
        String userName = "test";
        String password = "test";
        String clientId = "pubClient1";
        // 内存存储
        MemoryPersistence persistence = new MemoryPersistence();

        try {
            // 创建客户端
            MqttClient sampleClient = new MqttClient(broker, clientId, persistence);
            // 创建链接参数
            MqttConnectOptions connOpts = new MqttConnectOptions();
            // 在重新启动和重新连接时记住状态
            connOpts.setCleanSession(false);
            // 设置连接的用户名
            connOpts.setUserName(userName);
            connOpts.setPassword(password.toCharArray());
            // 建立连接
            sampleClient.connect(connOpts);
            // 创建消息
            MqttMessage message = new MqttMessage(content.getBytes());
            // 设置消息的服务质量
            message.setQos(qos);
            // 发布消息
            sampleClient.publish(topic, message);
            // 断开连接
            sampleClient.disconnect();
            // 关闭客户端
            sampleClient.close();
        } 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();
        }
    }
}

订阅端发布实例

import org.eclipse.paho.client.mqttv3.*;
import org.eclipse.paho.client.mqttv3.persist.MemoryPersistence;

/**
 * 订阅端
 */
public class SubscribeSample {
    public static void main(String[] args) throws MqttException {
        String HOST = "tcp://127.0.0.1:1883";
        String TOPIC = "mqtt/okok";
        int qos = 1;
        String clientid = "subClient1";
        String userName = "test";
        String passWord = "test";
        try {
            // host为主机名，test为clientid即连接MQTT的客户端ID，一般以客户端唯一标识符表示，MemoryPersistence设置clientid的保存形式，默认为以内存保存
            MqttClient client = new MqttClient(HOST, clientid, new MemoryPersistence());
            // MQTT的连接设置
            MqttConnectOptions options = new MqttConnectOptions();
            // 设置是否清空session,这里如果设置为false表示服务器会保留客户端的连接记录，这里设置为true表示每次连接到服务器都以新的身份连接
            options.setCleanSession(true);
            // 设置连接的用户名
            options.setUserName(userName);
            // 设置连接的密码
            options.setPassword(passWord.toCharArray());
            // 设置超时时间 单位为秒
            options.setConnectionTimeout(10);
            // 设置会话心跳时间 单位为秒 服务器会每隔1.5*20秒的时间向客户端发送个消息判断客户端是否在线，但这个方法并没有重连的机制
            options.setKeepAliveInterval(20);
            // 设置回调函数
            client.setCallback(new MqttCallback() {

                @Override
                public void connectionLost(Throwable cause) {
                    System.out.println("connectionLost");
                }

                @Override
                public void messageArrived(String topic, MqttMessage message) throws Exception {
                    System.out.println("topic:"+topic);
                    System.out.println("Qos:"+message.getQos());
                    System.out.println("message content:"+new String(message.getPayload()));

                }

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

            });
            client.connect(options);
            //订阅消息
            client.subscribe(TOPIC, qos);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

下一篇：MQTT整合进Spring Mvc

更多参考网站：

1.EMQX帮助中心 https://docs.emqx.io/broker/latest/cn/
2.Spring MQTT Support https://docs.spring.io/spring-integration/docs/5.0.8.RELEASE/reference/html/mqtt.html