mqtt_client.h 9.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340
  1. #ifndef HV_MQTT_CLIENT_H_
  2. #define HV_MQTT_CLIENT_H_
  3. #include "mqtt_protocol.h"
  4. #include "hloop.h"
  5. #include "hssl.h"
  6. #include "hmutex.h"
  7. #define DEFAULT_MQTT_KEEPALIVE 60 // s
  8. typedef struct mqtt_client_s mqtt_client_t;
  9. // @type mqtt_type_e
  10. // @example examples/mqtt
  11. typedef void (*mqtt_client_cb)(mqtt_client_t* cli, int type);
  12. struct mqtt_client_s {
  13. // connect: host:port
  14. char host[256];
  15. int port;
  16. int connect_timeout; // ms
  17. // reconnect
  18. reconn_setting_t* reconn_setting;
  19. // login: flags + keepalive + client_id + will + username + password
  20. // flags
  21. unsigned char protocol_version; // Default MQTT_PROTOCOL_V311
  22. unsigned char clean_session: 1;
  23. unsigned char ssl: 1; // Read Only
  24. unsigned char alloced_ssl_ctx: 1; // intern
  25. unsigned char connected : 1;
  26. unsigned short keepalive;
  27. int ping_cnt;
  28. char client_id[64];
  29. // will
  30. mqtt_message_t* will;
  31. // auth
  32. char username[64];
  33. char password[64];
  34. // message
  35. mqtt_head_t head;
  36. int error; // for MQTT_TYPE_CONNACK
  37. int mid; // for MQTT_TYPE_SUBACK, MQTT_TYPE_PUBACK
  38. mqtt_message_t message; // for MQTT_TYPE_PUBLISH
  39. // callback
  40. mqtt_client_cb cb;
  41. // userdata
  42. void* userdata;
  43. // privdata
  44. hloop_t* loop;
  45. hio_t* io;
  46. htimer_t* timer;
  47. // SSL/TLS
  48. hssl_ctx_t ssl_ctx;
  49. // thread-safe
  50. hmutex_t mutex_;
  51. };
  52. BEGIN_EXTERN_C
  53. // hloop_new -> malloc(mqtt_client_t)
  54. HV_EXPORT mqtt_client_t* mqtt_client_new(hloop_t* loop DEFAULT(NULL));
  55. // @see hloop_run
  56. HV_EXPORT void mqtt_client_run (mqtt_client_t* cli);
  57. // @see hloop_stop
  58. HV_EXPORT void mqtt_client_stop(mqtt_client_t* cli);
  59. // hloop_free -> free(mqtt_client_t)
  60. HV_EXPORT void mqtt_client_free(mqtt_client_t* cli);
  61. // id
  62. HV_EXPORT void mqtt_client_set_id(mqtt_client_t* cli, const char* id);
  63. // will
  64. HV_EXPORT void mqtt_client_set_will(mqtt_client_t* cli,
  65. mqtt_message_t* will);
  66. // auth
  67. HV_EXPORT void mqtt_client_set_auth(mqtt_client_t* cli,
  68. const char* username, const char* password);
  69. // callback
  70. HV_EXPORT void mqtt_client_set_callback(mqtt_client_t* cli, mqtt_client_cb cb);
  71. // userdata
  72. HV_EXPORT void mqtt_client_set_userdata(mqtt_client_t* cli, void* userdata);
  73. HV_EXPORT void* mqtt_client_get_userdata(mqtt_client_t* cli);
  74. // error
  75. HV_EXPORT int mqtt_client_get_last_error(mqtt_client_t* cli);
  76. // SSL/TLS
  77. HV_EXPORT int mqtt_client_set_ssl_ctx(mqtt_client_t* cli, hssl_ctx_t ssl_ctx);
  78. // hssl_ctx_new(opt) -> mqtt_client_set_ssl_ctx
  79. HV_EXPORT int mqtt_client_new_ssl_ctx(mqtt_client_t* cli, hssl_ctx_opt_t* opt);
  80. // reconnect
  81. HV_EXPORT int mqtt_client_set_reconnect(mqtt_client_t* cli,
  82. reconn_setting_t* reconn);
  83. HV_EXPORT int mqtt_client_reconnect(mqtt_client_t* cli);
  84. // connect
  85. // hio_create_socket -> hio_connect ->
  86. // on_connect -> mqtt_client_login ->
  87. // on_connack
  88. HV_EXPORT void mqtt_client_set_connect_timeout(mqtt_client_t* cli, int ms);
  89. HV_EXPORT void mqtt_client_set_host(mqtt_client_t* cli, const char* host, int port, int ssl);
  90. HV_EXPORT int mqtt_client_connect(mqtt_client_t* cli,
  91. const char* host,
  92. int port DEFAULT(DEFAULT_MQTT_PORT),
  93. int ssl DEFAULT(0));
  94. HV_EXPORT bool mqtt_client_is_connected(mqtt_client_t* cli);
  95. // disconnect
  96. // @see hio_close
  97. HV_EXPORT int mqtt_client_disconnect(mqtt_client_t* cli);
  98. // publish
  99. HV_EXPORT int mqtt_client_publish(mqtt_client_t* cli,
  100. mqtt_message_t* msg);
  101. // subscribe
  102. HV_EXPORT int mqtt_client_subscribe(mqtt_client_t* cli,
  103. const char* topic, int qos DEFAULT(0));
  104. // unsubscribe
  105. HV_EXPORT int mqtt_client_unsubscribe(mqtt_client_t* cli,
  106. const char* topic);
  107. END_EXTERN_C
  108. #ifdef __cplusplus
  109. #include <functional>
  110. #include <map>
  111. #include <mutex>
  112. #include <string>
  113. namespace hv {
  114. // @usage examples/mqtt/mqtt_client_test.cpp
  115. class MqttClient {
  116. public:
  117. mqtt_client_t* client;
  118. // callbacks
  119. typedef std::function<void(MqttClient*)> MqttCallback;
  120. typedef std::function<void(MqttClient*, mqtt_message_t*)> MqttMessageCallback;
  121. MqttCallback onConnect;
  122. MqttCallback onClose;
  123. MqttMessageCallback onMessage;
  124. MqttClient(hloop_t* loop = NULL) {
  125. client = mqtt_client_new(loop);
  126. }
  127. ~MqttClient() {
  128. if (client) {
  129. mqtt_client_free(client);
  130. client = NULL;
  131. }
  132. }
  133. void run() {
  134. mqtt_client_set_callback(client, on_mqtt);
  135. mqtt_client_set_userdata(client, this);
  136. mqtt_client_run(client);
  137. }
  138. void stop() {
  139. mqtt_client_stop(client);
  140. }
  141. void setID(const char* id) {
  142. mqtt_client_set_id(client, id);
  143. }
  144. void setWill(mqtt_message_t* will) {
  145. mqtt_client_set_will(client, will);
  146. }
  147. void setAuth(const char* username, const char* password) {
  148. mqtt_client_set_auth(client, username, password);
  149. }
  150. void setPingInterval(int sec) {
  151. client->keepalive = sec;
  152. }
  153. int lastError() {
  154. return mqtt_client_get_last_error(client);
  155. }
  156. // SSL/TLS
  157. int setSslCtx(hssl_ctx_t ssl_ctx) {
  158. return mqtt_client_set_ssl_ctx(client, ssl_ctx);
  159. }
  160. int newSslCtx(hssl_ctx_opt_t* opt) {
  161. return mqtt_client_new_ssl_ctx(client, opt);
  162. }
  163. void setReconnect(reconn_setting_t* reconn) {
  164. mqtt_client_set_reconnect(client, reconn);
  165. }
  166. void setConnectTimeout(int ms) {
  167. mqtt_client_set_connect_timeout(client, ms);
  168. }
  169. void setHost(const char* host, int port = DEFAULT_MQTT_PORT, int ssl = 0) {
  170. mqtt_client_set_host(client, host, port, ssl);
  171. }
  172. int connect(const char* host, int port = DEFAULT_MQTT_PORT, int ssl = 0) {
  173. return mqtt_client_connect(client, host, port, ssl);
  174. }
  175. int reconnect() {
  176. return mqtt_client_reconnect(client);
  177. }
  178. int disconnect() {
  179. return mqtt_client_disconnect(client);
  180. }
  181. bool isConnected() {
  182. return mqtt_client_is_connected(client);
  183. }
  184. int publish(mqtt_message_t* msg, MqttCallback ack_cb = NULL) {
  185. int mid = mqtt_client_publish(client, msg);
  186. if (msg->qos > 0 && mid >= 0 && ack_cb) {
  187. setAckCallback(mid, ack_cb);
  188. }
  189. return mid;
  190. }
  191. int publish(const std::string& topic, const std::string& payload, int qos = 0, int retain = 0, MqttCallback ack_cb = NULL) {
  192. mqtt_message_t msg;
  193. memset(&msg, 0, sizeof(msg));
  194. msg.topic_len = topic.size();
  195. msg.topic = topic.c_str();
  196. msg.payload_len = payload.size();
  197. msg.payload = payload.c_str();
  198. msg.qos = qos;
  199. msg.retain = retain;
  200. return publish(&msg, ack_cb);
  201. }
  202. int subscribe(const char* topic, int qos = 0, MqttCallback ack_cb = NULL) {
  203. int mid = mqtt_client_subscribe(client, topic, qos);
  204. if (qos > 0 && mid >= 0 && ack_cb) {
  205. setAckCallback(mid, ack_cb);
  206. }
  207. return mid;
  208. }
  209. int unsubscribe(const char* topic, MqttCallback ack_cb = NULL) {
  210. int mid = mqtt_client_unsubscribe(client, topic);
  211. if (mid >= 0 && ack_cb) {
  212. setAckCallback(mid, ack_cb);
  213. }
  214. return mid;
  215. }
  216. protected:
  217. void setAckCallback(int mid, MqttCallback cb) {
  218. ack_cbs_mutex.lock();
  219. ack_cbs[mid] = std::move(cb);
  220. ack_cbs_mutex.unlock();
  221. }
  222. void invokeAckCallback(int mid) {
  223. MqttCallback ack_cb = NULL;
  224. ack_cbs_mutex.lock();
  225. auto iter = ack_cbs.find(mid);
  226. if (iter != ack_cbs.end()) {
  227. ack_cb = std::move(iter->second);
  228. ack_cbs.erase(iter);
  229. }
  230. ack_cbs_mutex.unlock();
  231. if (ack_cb) ack_cb(this);
  232. }
  233. static void on_mqtt(mqtt_client_t* cli, int type) {
  234. MqttClient* client = (MqttClient*)mqtt_client_get_userdata(cli);
  235. // printf("on_mqtt type=%d\n", type);
  236. switch(type) {
  237. case MQTT_TYPE_CONNECT:
  238. // printf("mqtt connected!\n");
  239. break;
  240. case MQTT_TYPE_DISCONNECT:
  241. // printf("mqtt disconnected!\n");
  242. if (client->onClose) {
  243. client->onClose(client);
  244. }
  245. break;
  246. case MQTT_TYPE_CONNACK:
  247. // printf("mqtt connack!\n");
  248. if (client->onConnect) {
  249. client->onConnect(client);
  250. }
  251. break;
  252. case MQTT_TYPE_PUBLISH:
  253. if (client->onMessage) {
  254. client->onMessage(client, &cli->message);
  255. }
  256. break;
  257. case MQTT_TYPE_PUBACK: /* qos = 1 */
  258. // printf("mqtt puback mid=%d\n", cli->mid);
  259. client->invokeAckCallback(cli->mid);
  260. break;
  261. case MQTT_TYPE_PUBREC: /* qos = 2 */
  262. // printf("mqtt pubrec mid=%d\n", cli->mid);
  263. // wait MQTT_TYPE_PUBCOMP
  264. break;
  265. case MQTT_TYPE_PUBCOMP: /* qos = 2 */
  266. // printf("mqtt pubcomp mid=%d\n", cli->mid);
  267. client->invokeAckCallback(cli->mid);
  268. break;
  269. case MQTT_TYPE_SUBACK:
  270. // printf("mqtt suback mid=%d\n", cli->mid);
  271. client->invokeAckCallback(cli->mid);
  272. break;
  273. case MQTT_TYPE_UNSUBACK:
  274. // printf("mqtt unsuback mid=%d\n", cli->mid);
  275. client->invokeAckCallback(cli->mid);
  276. break;
  277. default:
  278. break;
  279. }
  280. }
  281. private:
  282. // mid => ack callback
  283. std::map<int, MqttCallback> ack_cbs;
  284. std::mutex ack_cbs_mutex;
  285. };
  286. }
  287. #endif
  288. #endif // HV_MQTT_CLIENT_H_