java mqtt 发送消息

原创

mob64ca12e4d52e 2024-09-13 06:04:08 ©著作权

©著作权归作者所有：来自51CTO博客作者mob64ca12e4d52e的原创作品，请联系作者获取转载授权，否则将追究法律责任

Java MQTT 消息发送教程

一、概述

本文旨在教授初学者如何使用Java编程语言通过MQTT协议发送消息。MQTT（Message Queuing Telemetry Transport）是一种轻量级的消息传输协议，常用于物联网（IoT）应用。通过本教程，你将理解整个流程，并获得实际代码示例。

二、流程概览

在开始之前，我们先梳理一下发送MQTT消息的基本流程，如下表所示：

步骤	描述
1	引入MQTT依赖库
2	创建MQTT客户端
3	连接到MQTT代理
4	发送消息
5	断开连接

流程图

以下是整个流程的可视化图示：

flowchart TD
    A[引入MQTT依赖库] --> B[创建MQTT客户端]
    B --> C[连接到MQTT代理]
    C --> D[发送消息]
    D --> E[断开连接]

三、逐步实现

下面我们将逐步实现每一个步骤，并编写相应的代码。

1. 引入MQTT依赖库

在Java项目中发送MQTT消息需要使用一个MQTT客户端库，最常用的库之一是Eclipse Paho。在你的pom.xml文件中添加以下依赖（如果是Maven项目）：

<dependency>
    <groupId>org.eclipse.paho</groupId>
    <artifactId>org.eclipse.paho.client</artifactId>
    <version>1.2.5</version> <!-- 请根据需要检查最新版本 -->
</dependency>

备注：如果你没有使用Maven，可以到[Paho Eclispe官网](

2. 创建MQTT客户端

在Java中创建MQTT客户端相对简单，以下是初始化客户端的代码：

import org.eclipse.paho.client.mqttv3.MqttClient;
import org.eclipse.paho.client.mqttv3.MqttException;

// 创建MQTT客户端
String broker = "tcp://localhost:1883"; // MQTT代理地址
String clientId = "JavaSampleClient"; // 客户端ID
MqttClient mqttClient = new MqttClient(broker, clientId);

注释：这里我们需要指定MQTT代理地址，以及为我们的客户端分配一个唯一的客户端ID。

3. 连接到MQTT代理

在发送消息之前，你需要连接到MQTT代理。以下是连接的代码：

import org.eclipse.paho.client.mqttv3.MqttConnectOptions;

// 创建连接选项
MqttConnectOptions options = new MqttConnectOptions();
options.setCleanSession(true); // 清空会话

try {
    // 连接MQTT代理
    mqttClient.connect(options);
    System.out.println("Connected to MQTT broker: " + broker);
} catch (MqttException e) {
    e.printStackTrace(); // 输出异常信息
}

注释：MqttConnectOptions允许你设置连接的选项，比如是否清空会话。

4. 发送消息

连接成功后，就可以发送消息了，代码如下：

import org.eclipse.paho.client.mqttv3.MqttMessage;

String topic = "test/topic"; // 主题
String content = "Hello MQTT"; // 消息内容
int qos = 2; // 服务质量（0, 1, 2）

try {
    MqttMessage message = new MqttMessage(content.getBytes());
    message.setQos(qos); // 设置服务质量
    mqttClient.publish(topic, message); // 发送消息
    System.out.println("Message published: " + content);
} catch (MqttException e) {
    e.printStackTrace(); // 输出异常信息
}

注释：消息的QOS（Quality of Service）可以选择0（最多一次）、1（至少一次）和2（仅一次）中的一种。

5. 断开连接

最后，发送完消息后，需要断开连接，代码如下：

try {
    mqttClient.disconnect();
    System.out.println("Disconnected from MQTT broker.");
} catch (MqttException e) {
    e.printStackTrace(); // 输出异常信息
}

注释：使用disconnect方法可以安全地断开与代理的连接。

四、完整代码

将以上步骤结合起来，下面是完整的Java代码示例：

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;

public class MqttPublisher {
    public static void main(String[] args) {
        // 1. 创建MQTT客户端
        String broker = "tcp://localhost:1883"; // MQTT代理地址
        String clientId = "JavaSampleClient"; // 客户端ID
        MqttClient mqttClient;

        try {
            mqttClient = new MqttClient(broker, clientId);

            // 2. 连接到MQTT代理
            MqttConnectOptions options = new MqttConnectOptions();
            options.setCleanSession(true); // 清空会话
            mqttClient.connect(options);
            System.out.println("Connected to MQTT broker: " + broker); 

            // 3. 发送消息
            String topic = "test/topic"; // 主题
            String content = "Hello MQTT"; // 消息内容
            int qos = 2; // 服务质量

            MqttMessage message = new MqttMessage(content.getBytes());
            message.setQos(qos); // 设置服务质量
            mqttClient.publish(topic, message); // 发送消息
            System.out.println("Message published: " + content);

            // 4. 断开连接
            mqttClient.disconnect();
            System.out.println("Disconnected from MQTT broker.");
        } catch (MqttException e) {
            e.printStackTrace(); // 输出异常信息
        }
    }
}