Mosquitto
一款实现了 MQTT 协议的开源消息代理软件,提供轻量级的,支持可发布/可订阅的的消息推送模式,使设备对设备之间的短消息通信变得简单,比如现在应用广泛的低功耗传感器,手机、嵌入式计算机、微型控制器等移动设备。
从官网(http://mosquitto.org)下载安装后,会得到以下文件。
- 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:消息内容)
如果在第二步中的界面可以接收到第三步中发布的消息,说明安装成功了。
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()));
}
}
运行结果
服务端
客户端