mqtt_client.h 9.1 KB

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