mosquitto函数详解

mosquitto_connect函数与mosquitto_connect_async函数的区别

mosquitto_connect() 和 mosquitto_connect_async() 是 MQTT 客户端库 Mosquitto 中建立连接的两种方式。
它们的主要区别在于 mosquitto_connect() 是同步的，而 mosquitto_connect_async() 是异步的。

具体来说：
mosquitto_connect() 函数会阻塞当前线程，直到连接成功或失败。调用该函数后，客户端会尝试连接服务器，只有当连接成功后，该函数才会返回。连接失败时，该函数会抛出错误，例如用户名或密码错误等。
mosquitto_connect_async() 函数是异步非阻塞的。调用该函数后，客户端会立即返回，并在后台执行连接操作。这意味着可以将连接操作交给后台线程或进程处理，并且可以在连接过程中执行其他代码。异步操作完成后，会立即触发回调函数，告诉客户端连接状态。这个回调函数可以用于对连接成功或失败进行处理。
一些区别点总结如下：
mosquitto_connect_async() 是非阻塞的，而
mosquitto_connect() 是阻塞的。
mosquitto_connect_async() 必须配合事件循环或回调函数使用，而
mosquitto_connect() 不需要。
mosquitto_connect_async() 通常用于异步程序中，而
mosquitto_connect() 通常用于同步程序中。
mosquitto_connect_async() 可以与 Mosquitto 库中的许多其他异步函数组合使用，例如
mosquitto_loop_start() 函数等。
需要注意的是，使用 mosquitto_connect_async() 连接服务器时，还需要在后台循环处理事件（例如使用mosquitto_loop() 或 mosquito_loop_start() 函数），以确保连接正常进行，并处理消息传递等事件。

断开重连mosquitto_reconnect()

在 Mosquitto 中，可以使用 mosquitto_reconnect() 函数来实现重连但不阻塞程序的功能。该函数可以在网络连接断开的情况下自动重新连接到 MQTT 代理服务器，而不会阻塞程序的运行。以下是该函数的基本用法和说明：

int mosquitto_reconnect(struct mosquitto *mosq);

该函数将客户端的状态设置为“正在重连”，并在后台启动连接过程。如果连接成功，将触发正常的连接回调函数；如果连接失败，将继续尝试重新连接，直到达到最大重试次数。
需要注意以下几点：

1. 在使用mosquitto_reconnect() 时，需要在 mosquitto_new() 函数中设置 CLEAN_SESSION 选项为 false，以确保客户端可以在重连时保留之前的状态。

2. 该函数默认会在每次连接失败后延迟一段时间后再进行下次重连，这个时间间隔可以通过mosquitto_reconnect_delay_set() 函数进行设置。
   以下是一个示例程序：

#include <mosquitto.h>
#include <stdio.h>
#include <unistd.h>

void on_connect(struct mosquitto *mosq, void *userdata, int result)
{
    printf("Connect successful!\n");
}

int main()
{
    struct mosquitto *mosq;
    mosquitto_lib_init();

    mosq = mosquitto_new("publisher", false, NULL);
    if (!mosq) {
        fprintf(stderr, "Failed to create mosquitto client instance.\n");
        return 1;
    }

    mosquitto_connect_callback_set(mosq, on_connect);

    while (1) {
        int rc = mosquitto_connect(mosq, "localhost", 1883, 60);
        if (rc != MOSQ_ERR_SUCCESS) {
            printf("Connect failed: %s\n", mosquitto_strerror(rc));
            mosquitto_reconnect(mosq);
        }
        sleep(5);
    }

    mosquitto_destroy(mosq);
    mosquitto_lib_cleanup();
    return 0;
}

该示例程序会循环不断地尝试连接本地 MQTT 代理服务器，如果连接失败，则调用 mosquitto_reconnect() 函数进行重连，而不会阻塞程序。需要注意的是，需要在 mosquitto_new() 函数中设置 CLEAN_SESSION 选项为 false，以实现客户端状态的保留。

mosquitto_loop_forever()与mosquitto_loop_start（）的区别

mosquitto_loop_forever() 和 mosquitto_loop_start() 都是 Mosquitto 库中的函数，用于启动 MQTT 客户端的事件循环。它们的主要区别在于它们的工作方式和函数调用方式。

1. mosquitto_loop_forever()

：
函数签名：

int mosquitto_loop_forever(struct mosquitto *mosq, int timeout, int max_packets);

作用：调用此函数将启动一个无限循环，使 Mosquitto 客户端保持与 MQTT
代理的连接，并处理传入的消息和事件。它会阻塞当前线程，直到连接断开或出现错误为止。
参数：

mosq：指向 Mosquitto 客户端实例的指针。
timeout：指定循环的超时时间（以毫秒为单位）。如果设置为零，则表示没有超时时间限制。 max_packets：指定在循环中处理的最大MQTT 消息数量。如果设置为零，则表示没有限制。
返回值：函数执行成功时返回
MOSQ_ERR_SUCCESS，并且在连接断开或发生错误时返回相应的错误码。

2. mosquitto_loop_start()
   ：
   函数签名：

int mosquitto_loop_start(struct mosquitto *mosq);

作用：调用此函数将启动一个单独的线程，在该线程中保持 Mosquitto 客户端与 MQTT
代理的连接，并处理传入的消息和事件。它立即返回，不会阻塞当前线程。 参数：

mosq：指向 Mosquitto 客户端实例的指针。 返回值：函数执行成功时返回
MOSQ_ERR_SUCCESS，并且在连接断开或发生错误时返回相应的错误码。

使用 mosquitto_loop_forever() 可以在当前线程中保持 Mosquitto 客户端与代理的连接，但会阻塞当前线程的执行。而使用 mosquitto_loop_start() 可以在一个单独的线程中启动连接并处理消息，不会阻塞当前线程。
选择使用哪个函数取决于你的具体需求。如果你想在应用程序的主线程中保持 MQTT 连接，并且没有其他重要的任务需要执行，可以使用 mosquitto_loop_forever()。如果你想在应用程序的多个线程中同时保持 MQTT 连接，并且不希望阻塞当前线程，可以使用 mosquitto_loop_start()。
希望这可以帮助你理解它们之间的区别。如果你有任何其他问题，请随时提问。