如何在 Rust 中通过 Rumqttc 实现 MQTT 通信

Rust 简介

Rust 是一门系统级编程语言，以其卓越的性能、并发能力以及内存安全特性著称。Rust 由 Mozilla 推出，目标是在现代软件开发中提供一种安全高效的编程语言。其设计旨在提供安全、并发和高效的编程体验，同时保持开发效率和代码质量不受影响。

Rust 的核心特性包括：

• 内存安全：Rust 通过所有权系统和借用检查器确保内存安全。所有权系统在编译时追踪每个值的所有权，并负责管理内存释放。借用检查器防止空指针引用和数据竞争等常见的内存问题。
• 并发性：Rust 提供了一组轻量级的并发工具，让开发人员能够轻松编写安全的并发程序。通过 std::thread 模块，可以方便创建和管理线程，而 std::sync 模块则提供了如互斥锁、信号量和通道等同步原语，保证线程之间安全的数据共享和通信。
• 高性能：Rust 强调零成本抽象和极低的运行时开销。它支持内联汇编、无锁编程和异步编程等高级功能，帮助开发者编写高性能的系统应用和网络服务。

总的来说，Rust 是一门功能强大、安全可靠、高性能的编程语言，适用于广泛的应用场景，从嵌入式开发到大规模分布式系统，甚至网络服务等领域。随着其生态系统的不断完善和活跃的社区支持，Rust 正逐渐成为开发人员的热门选择。

选择基于 Rust 的 MQTT 库

在 Rust 生态系统中，有几种常见的 MQTT 库，其中最受欢迎的是 rumqtt 和 paho-mqtt。

paho-mqtt

paho-mqtt 是 Eclipse Paho 项目的一部分，它是一个跨平台的 MQTT 客户端库，支持包括 Rust 在内的多种编程语言。paho-mqtt 支持 MQTT v3.1 和 v5.0 协议，以稳定和成熟著称。

特点：paho-mqtt 在众多项目中得到了广泛应用，并拥有活跃的社区支持。它提供了同步和异步 API，适用于多种应用场景。

rumqtt

rumqtt 是一个用 Rust 编写的开源库，旨在实现 MQTT 协议，具有简单、健壮和高性能的特点。该项目包括两个主要组件：rumqttc 和 rumqttd。

• rumqttc

  rumqttc 是一个纯 Rust 实现的 MQTT 客户端，设计目标是稳健、高效且易于使用。它基于异步（使用 tokio）的事件循环，使开发者能够方便地发送和接收 MQTT 消息，与 MQTT Broker 进行通信。

• rumqttd

  rumqttd 是一个高性能的 Rust 实现的 MQTT Broker，它的设计轻量且可嵌入，可以将其作为库集成到代码中，甚至扩展其功能。

特点：rumqtt 采用现代设计，提供符合 Rust 异步编程模型的异步 API。其轻量级和高性能的设计使其即使在资源有限的环境中也能表现出色。此外，rumqtt 的 API 设计简洁明了，遵循 Rust 的语言风格，易于使用和理解。

选择 rumqtt 的理由：

• 现代设计
• 轻量级且高性能
• 简洁的 API
• 活跃的社区支持
• 灵活的配置选项

在本文中，我们将使用 rumqttc 进行示例演示。

在 Rust 中使用 MQTT 的示例程序

以下示例将演示如何使用 rumqttc 库创建一个 MQTT 客户端，并实现消息的发布和订阅。通过这些示例，您将学习如何初始化客户端、设置选项、连接到 MQTT 服务器，以及发布/订阅消息。

准备工作

本示例使用 EMQX 提供的免费公共 MQTT 服务器进行测试，连接信息如下：

Broker：broker.emqx.io
TCP 端口：1883
Websocket 端口：8083

1. 创建一个新的 Rust 项目：

   $ cargo new mqtt-rust-example
        Created binary (application) `mqtt-rust-example` package
   

2. 修改 Cargo.toml 文件，添加所需的依赖项：

   [dependencies]
   rumqttc = "0.24.0"
   pretty_env_logger = "0.4"
   tokio = { version = "1", features = ["full"] }
   

同步订阅和发布 MQTT 消息

下面的内容展示了如何实现同步订阅和发布 MQTT 消息。

1. 修改 Cargo.toml：

   [[bin]]
   name = "syncpubsub"
   path = "src/syncpubsub.rs"
   

2. 在项目的 src 目录下创建 syncpubsub.rs 文件，并添加以下代码：

   use rumqttc::{
        Client, LastWill, MqttOptions, QoS};
   use std::thread;
   use std::time::Duration;
   
   /*
    * 这是程序的主函数。
    * 在该函数中，将初始化 MQTT 客户端、设置连接选项和遗嘱消息。
    * 然后，创建客户端和连接、并在新线程中调用发布函数。
    * 最后，使用 connection.iter() 方法遍历并处理接中的每个通知。
    */
   fn main() {
        
       // 初始化日志记录器
       pretty_env_logger::init();
   
       // 设置 MQTT 连接选项和遗嘱消息
       let mut mqttoptions = MqttOptions::new("test-1", "broker.emqx.io", 1883);
       let will = LastWill::new("hello/world", "good bye", QoS::AtMostOnce, false);
       mqttoptions
           .set_keep_alive(Duration::from_secs(5))
           .set_last_will(will);