Eclipse Paho MQTT C 客户端库的四种变体库的区别

Eclipse Paho MQTT C 客户端库提供了四种变体库，它们分别适用于不同的场景和需求。以下是这些库的区别：

1. paho-mqtt3a - 异步（MQTTAsync）

• 异步操作：这个库提供了异步的 API，意味着它可以在后台处理网络通信，而不需要阻塞应用程序的主线程。
• 适用场景：适合于需要高性能和实时性的应用，因为它们可以在后台处理网络事件，而不影响应用程序的其他部分。
• API 设计：使用回调函数来通知应用程序有关连接状态、消息到达等事件。
• 示例：MQTTAsync_connect()，MQTTAsync_disconnect()，MQTTAsync_send() 等。

2. paho-mqtt3as - 异步带有 SSL/TLS 支持（MQTTAsync）

• 异步操作 + SSL/TLS 支持：与 paho-mqtt3a 类似，但它增加了对 SSL/TLS 加密的支持，使得通信更加安全。
• 适用场景：适合于需要加密通信的应用，同时保持异步操作的优势。
• API 设计：同样使用回调函数来通知应用程序有关连接状态、消息到达等事件。
• 示例：MQTTAsync_connectOptions_setTLS()，MQTTAsync_connect()，MQTTAsync_disconnect() 等。

3. paho-mqtt3c - “经典”/同步（MQTTClient）

• 同步操作：这个库提供了一种传统的同步方式来处理 MQTT 操作，这意味着每次调用都会阻塞直到操作完成。
• 适用场景：适合于那些不需要实时性能或者可以容忍阻塞的应用。
• API 设计：直接返回操作的结果，没有回调函数。
• 示例：MQTTClient_connect()，MQTTClient_disconnect()，MQTTClient_publishMessage() 等。

4. paho-mqtt3cs - “经典”/同步带有 SSL/TLS 支持（MQTTClient）

• 同步操作 + SSL/TLS 支持：与 paho-mqtt3c 类似，但它也支持 SSL/TLS 加密，从而确保通信的安全性。
• 适用场景：适合于需要加密通信的应用，同时保持同步操作的方式。
• API 设计：直接返回操作的结果，没有回调函数。
• 示例：MQTTClient_connectOptions_setTLS()，MQTTClient_connect()，MQTTClient_disconnect() 等。

总结

• 异步 vs 同步：异步库 (paho-mqtt3a 和 paho-mqtt3as) 可以在后台处理网络通信，因此更适合高性能和实时性要求较高的应用场景；而同步库 (paho-mqtt3c 和 paho-mqtt3cs) 则适合于那些可以容忍阻塞操作的应用。
• 加密支持：带 SSL/TLS 支持的库 (paho-mqtt3as 和 paho-mqtt3cs) 提供了加密通信的能力，这在需要保证数据安全性的场景下非常重要。

选择哪个库取决于你的具体需求：

• 如果需要高性能和实时性，并且不介意处理回调函数，则可以选择异步库；
• 如果需要加密通信，并且可以容忍阻塞操作，则可以选择同步带 SSL/TLS 支持的库；
• 如果只需要同步操作，并且不需要加密通信，则可以选择普通的同步库。

示例代码对比

异步库示例

#include <stdio.h>
#include <stdlib.h>
#include "MQTTAsync.h"

static void on_connect(void *context, int status)
{
    if (status == 0) {
        printf("Connected to MQTT broker asynchronously.\n");
    } else {
        printf("Connection failed with status: %d\n", status);
    }
}

int main()
{
    MQTTAsync client;
    MQTTAsync_connectOptions conn_opts = MQTTAsync_connectOptions_initializer;
    MQTTAsync_responseOptions opts = MQTTAsync_responseOptions_initializer;
    int rc;

    MQTTAsync_create(&client, "tcp://test.mosquitto.org:1883", "ClientID", MQTTCLIENT_PERSISTENCE_NONE, NULL);

    conn_opts.keepAliveInterval = 20;
    conn_opts cleansession = 1;
    conn_opts.onSuccess = on_connect;

    if ((rc = MQTTAsync_connect(client, &conn_opts)) != MQTTASYNC_SUCCESS) {
        printf("Failed to start connect, return code %d\n", rc);
        return 1;
    }

    MQTTAsync_waitForCompletion(client, &opts, NULL);

    // 其他操作...

    MQTTAsync_destroy(&client);

    return 0;
}

同步库示例

#include <stdio.h>
#include <stdlib.h>
#include "MQTTClient.h"

int main()
{
    MQTTClient client;
    MQTTClient_connectOptions conn_opts = MQTTClient_connectOptions_initializer;
    int rc;

    MQTTClient_create(&client, "tcp://test.mosquitto.org:1883", "ClientID", MQTTCLIENT_PERSISTENCE_NONE, NULL);

    conn_opts.keepAliveInterval = 20;
    conn_opts.cleansession = 1;

    if ((rc = MQTTClient_connect(client, &conn_opts)) != MQTTCLIENT_SUCCESS) {
        printf("Failed to connect, return code %d\n", rc);
        return 1;
    }

    // 其他操作...

    MQTTClient_disconnect(client, 10000);
    MQTTClient_destroy(&client);

    return 0;
}

通过这两个示例，可以看出异步库使用回调函数来处理事件，而同步库则直接返回操作的结果。你可以根据自己的需求选择合适的库来实现 MQTT 客户端。