在物联网(iot)应用中,消息队列遥测传输(mqtt)作为一种轻量级的消息协议,因其低带宽需求和高效传输特点,广泛应用于设备通信中。对于刚接触mqtt的开发者来说,了解如何在spring boot项目中集成mqtt客户端并建立连接是迈向实际应用的重要一步。今天,我将分享一个详细的入门指南,带你一步步在spring boot中建立mqtt连接,并通过junit进行简单的单元测试。
项目配置
首先,我们需要在pom.xml中配置spring boot的父依赖以及必要的mqtt和测试依赖。以下是一个示例配置:
<parent>
<groupid>org.springframework.boot</groupid>
<artifactid>spring-boot-starter-parent</artifactid>
<version>3.0.5</version>
</parent>
<dependencies>
<!-- spring boot整合junit单元测试的起步依赖 -->
<dependency>
<groupid>org.springframework.boot</groupid>
<artifactid>spring-boot-starter-test</artifactid>
</dependency>
<!-- mqtt java客户端依赖 -->
<dependency>
<groupid>org.eclipse.paho</groupid>
<artifactid>org.eclipse.paho.client.mqttv3</artifactid>
<version>1.2.5</version>
</dependency>
</dependencies>在这个配置中,我们引入了spring-boot-starter-test用于单元测试,以及org.eclipse.paho.client.mqttv3作为mqtt客户端库。这些依赖为我们后续的开发和测试提供了必要的基础。
编写mqtt测试类
接下来,我们在项目中创建一个测试类mqttpahotest,用于测试mqtt连接的建立。以下是完整的代码示例:
package com.takumilove.mqtt.test;
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.persist.memorypersistence;
import org.junit.jupiter.api.test;
/**
* @author: takumilove
* @description: 通过junit测试,验证mqtt客户端与服务器的连接是否成功。
* @date: 2024/12/13
**/
public class mqttpahotest {
// mqtt服务器地址
string serveruri = "tcp://156.238.***.***:1883";
// 客户端id
string clientid = "paho_test";
@test
public void createconnection() throws mqttexception {
// 创建mqttclient对象,使用内存持久化
mqttclient mqttclient = new mqttclient(serveruri, clientid, new memorypersistence());
// 配置连接选项
mqttconnectoptions options = new mqttconnectoptions();
options.setusername("admin"); // 设置用户名
options.setpassword("123456".tochararray()); // 设置密码
options.setcleansession(true); // 设置是否清除会话
// 连接到mqtt服务器
mqttclient.connect(options);
system.out.println("连接成功");
// 让当前线程阻塞,保持连接
while (true) ;
}
}代码解析
- 导入必要的类:我们引入了
mqttclient、mqttconnectoptions等类,这些都是paho mqtt客户端库提供的,用于建立和管理mqtt连接。 - 配置mqtt服务器信息:
serveruri:指定mqtt服务器的地址和端口。clientid:为客户端生成一个唯一的id。
- 创建mqtt客户端:
- 使用
mqttclient构造函数,传入服务器uri、客户端id以及持久化策略(这里使用内存持久化memorypersistence)。
- 使用
- 设置连接选项:
setusername和setpassword:设置连接mqtt服务器所需的认证信息。setcleansession:决定是否清除会话,true表示每次连接都是新的会话。
- 建立连接:
- 调用
connect方法,使用之前配置的选项与mqtt服务器建立连接。 - 成功连接后,输出“连接成功”。
- 调用
- 保持连接:
- 通过一个无限循环
while (true);,保持当前线程不退出,以维持mqtt连接。
- 通过一个无限循环
验证连接状态
成功运行上述测试类后,连接是否建立成功可以通过mqtt服务器的管理仪表盘进行验证。大多数mqtt服务器,如mosquitto、hivemq等,都会提供一个仪表盘界面,用于监控当前连接的客户端。
在仪表盘中,你应该能够看到刚刚创建的客户端paho_test已经成功连接。连接状态通常会显示为“在线”或“已连接”,并且可能会显示一些连接细节,如客户端id、连接时间等。通过这种方式,你可以直观地确认mqtt客户端与服务器之间的连接是否正常建立,为后续的消息发布和订阅操作奠定基础。
运行测试
确保你的mqtt服务器(例如mosquitto)已经启动,并且能够接受来自客户端的连接。然后运行上述测试类,如果一切配置正确,你应该会在控制台看到“连接成功”的提示。同时,在mqtt服务器的仪表盘中,可以看到客户端paho_test的连接状态。

总结
通过以上步骤,我们成功地在spring boot项目中集成了mqtt客户端,并通过junit进行了简单的连接测试。
到此这篇关于在spring boot中建立连接及测试的文章就介绍到这了,更多相关spring boot内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
发表评论