MQTT协议:Retain (保留消息)功能分析小结

MQTT协议中的Retain功能确保了新订阅者能接收到已发布的消息。当发布者设置retain标志为1时,broker会保存消息并推送给未来订阅者。若topic已有Retain消息,新消息会覆盖旧的。要删除Retain消息,可发送长度为0的Retain消息。此特性解决了订阅延迟问题,确保消息即时传递。
摘要由CSDN通过智能技术生成

场景分析

 某个mqtt客户端A每小时向某个特定的topic发布一条消息,所有订阅这个topic
的客户端将会收到该消息,这是正常流程,如果客户端A刚刚发布消息, 此时有一
个新的客户端B订阅该topic,也就是“订阅”是在“发布”后,这个时候客户端B将接收
不到该消息。
  Retain 功能就是为了解决这一问题,当客户端A发布小时时,将 retain
标志置1,那么broker就会保存该消息,当有新的客户端订阅该topic时,会立刻
将该条消息推送给客户端B。
    所以官方的协议中是这样介绍该功能:“如果客户端发给服务端的 PUBLISH 
 报文的保留(RETAIN)标志被设置为 1,服务端 必须存储这个应用消息和它的
 服务质量等级(QoS),以便它可以被分发给未来的主题名匹配的订阅者”

Retain 功能特点

1、一个topic只能有1条Retain消息,新的Retain消息会覆盖旧的。
2、删除一个Retain消息,可以向这个topic发布一个长度为0的
 Retain 消息即可。
以下是使用C++ paho mqtt库中的mqtt::topic发布json对象的示例代码: ```c++ #include <iostream> #include <cstring> #include <cstdlib> #include <cstdio> #include <json/json.h> #include "mqtt/async_client.h" using namespace std; const string ADDRESS("tcp://localhost:1883"); const string CLIENTID("AsyncPublisher"); const string TOPIC("test"); const int QOS = 1;const int TIMEOUT = 10000L; class callback : public virtual mqtt::callback { public: virtual void connection_lost(const std::string& cause) { cout << "\nConnection lost" << endl; if (!cause.empty()) cout << "\tcause: " << cause << endl; } virtual void delivery_complete(mqtt::delivery_token_ptr token) { cout << "\n\tDelivery complete for token: " << (token ? token->get_message_id() : -1) << endl; } }; int main(int argc, char* argv[]) { mqtt::async_client client(ADDRESS, CLIENTID); mqtt::connect_options connOpts; connOpts.set_keep_alive_interval(20); connOpts.set_clean_session(true); callback cb; client.set_callback(cb); try { mqtt::token_ptr conntok = client.connect(connOpts); conntok->wait_for_completion(); Json::Value root; root["name"] = "John"; root["age"] = 25; root["email"] = "john@example.com"; string json_str = root.toStyledString(); mqtt::message_ptr pubmsg = mqtt::make_message(TOPIC, json_str); pubmsg->set_qos(QOS); mqtt::delivery_token_ptr pubtok = client.publish(pubmsg); pubtok->wait_for_completion(TIMEOUT); cout << "Message '" << json_str << "' published to topic '" << TOPIC << "'" << endl; client.disconnect()->wait_for_completion(); } catch (const mqtt::exception& exc) { cerr << exc.what() << endl; return 1; } return 0; } ``` 在这个示例中,我们使用了Jsoncpp库来创建一个Json对象,并将其转换为字符串。然后,我们使用mqtt::make_message()函数创建一个mqtt::message_ptr对象,该对象包含要发布的主题和消息。最后,我们使用mqtt::async_client类的publish()函数将消息发布到主题上。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值