Mosquitto

一款实现了 MQTT 协议的开源消息代理软件,提供轻量级的,支持可发布/可订阅的的消息推送模式,使设备对设备之间的短消息通信变得简单,比如现在应用广泛的低功耗传感器,手机、嵌入式计算机、微型控制器等移动设备。

从官网(http://mosquitto.org)下载安装后,会得到以下文件。
MQTT(栗子)[mosquitto]

  • mosquitto.exe:代理主程序。
  • mosquitto.conf:配置文件。
  • mosquitto_password:用户密码管理工具。
  • mosquitto_pub.exe:用于发布消息的客户端。
  • mosquitto_sub.exe:用于订阅消息的客户端。

第一步:启动 mosquitto.exe,不要关闭。
第二步:订阅。win + R,打开 cmd 界面,进入 mosquitto 的安装目录,输入 mosquitto_sub -v -t MqttTest。(-t:主题)
第三步:发布。win + R,打开 cmd 界面,进入 mosquitto 的安装目录,输入 mosquitto_pub -t MqttTest -m HelloMqtt。(-t:主题、-m:消息内容)
MQTT(栗子)[mosquitto]
如果在第二步中的界面可以接收到第三步中发布的消息,说明安装成功了。

maven

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

服务端

public class Server {
    public static final String HOST = "tcp://localhost:1883";
    public static final String TOPIC = "test_topic";
    private static final String clientid = "test_client";

    private MqttClient client;
    private MqttTopic testTopic;
    private String userName = "mosquitto";
    private String passWord = "";
    private MqttMessage message;

    public Server() throws MqttException {
        // host为主机名,clientid即连接MQTT的客户端ID,一般以唯一标识符表示,MemoryPersistence设置clientid的保存形式,默认为以内存保存
        client = new MqttClient(HOST, clientid, new MemoryPersistence());
        connect();
    }

    public void connect() {
        MqttConnectOptions options = new MqttConnectOptions();
        options.setCleanSession(false);
        options.setUserName(userName);
        options.setPassword(passWord.toCharArray());
        options.setConnectionTimeout(10);
        // 设置会话心跳时间
        options.setKeepAliveInterval(20);
        try {
            client.setCallback(new PushCallback());
            client.connect(options);
            testTopic = client.getTopic(TOPIC);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public void publish(MqttTopic topic, MqttMessage message) throws MqttException {
        MqttDeliveryToken token = topic.publish(message);
        token.waitForCompletion();
        System.out.println("message is published completely!" + token.isComplete());
    }

    public static void main(String[] args) throws MqttException {
        Server server = new Server();
        server.message = new MqttMessage();
        server.message.setQos(1);
        server.message.setRetained(true);
        server.message.setPayload("hello,test_topic!".getBytes());
        server.publish(server.testTopic, server.message);
        System.out.println(server.message.isRetained() + "------ratained状态");
    }
}

客户端

public class Client {
    public static final String HOST = "tcp://localhost:1883";
    public static final String TOPIC = "test_topic";
    private static final String clientid = "test_client";

    private MqttClient client;
    private MqttConnectOptions options;
    private String userName = "admin";
    private String passWord = "000";
    private ScheduledExecutorService scheduler;

    public void start() {
        try {
            // host为主机名,clientid即连接MQTT的客户端ID,一般以唯一标识符表示,MemoryPersistence设置clientid的保存形式,默认为以内存保存
            client = new MqttClient(HOST, clientid, new MemoryPersistence());
            // MQTT的连接设置
            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 PushCallback());
            MqttTopic topic = client.getTopic(TOPIC);
            //setWill方法,如果项目中需要知道客户端是否掉线可以调用该方法。设置最终端口的通知消息
            options.setWill(topic, "close".getBytes(), 2, true);
            client.connect(options);
            //订阅消息
            int[] Qos = {1};
            String[] topic1 = {TOPIC};
            client.subscribe(topic1, Qos);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        Client client = new Client();
        client.start();
    }
}

回调

public class PushCallback implements MqttCallback {
    public void connectionLost(Throwable cause) {
        System.out.println("连接断开,可以做重连");
    }

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

    public void messageArrived(String topic, MqttMessage message) throws Exception {
        System.out.println("接收消息主题 : " + topic);
        System.out.println("接收消息Qos : " + message.getQos());
        System.out.println("接收消息内容 : " + new String(message.getPayload()));
    }
}

运行结果

服务端
MQTT(栗子)[mosquitto]
客户端
MQTT(栗子)[mosquitto]

相关文章: