mqtt_client.h 9.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335
  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* reconn_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 int mqtt_client_connect(mqtt_client_t* cli,
  90. const char* host,
  91. int port DEFAULT(DEFAULT_MQTT_PORT),
  92. int ssl DEFAULT(0));
  93. HV_EXPORT bool mqtt_client_is_connected(mqtt_client_t* cli);
  94. // disconnect
  95. // @see hio_close
  96. HV_EXPORT int mqtt_client_disconnect(mqtt_client_t* cli);
  97. // publish
  98. HV_EXPORT int mqtt_client_publish(mqtt_client_t* cli,
  99. mqtt_message_t* msg);
  100. // subscribe
  101. HV_EXPORT int mqtt_client_subscribe(mqtt_client_t* cli,
  102. const char* topic, int qos DEFAULT(0));
  103. // unsubscribe
  104. HV_EXPORT int mqtt_client_unsubscribe(mqtt_client_t* cli,
  105. const char* topic);
  106. END_EXTERN_C
  107. #ifdef __cplusplus
  108. #include <functional>
  109. #include <map>
  110. #include <mutex>
  111. #include <string>
  112. namespace hv {
  113. // @usage examples/mqtt/mqtt_client_test.cpp
  114. class MqttClient {
  115. public:
  116. mqtt_client_t* client;
  117. // callbacks
  118. typedef std::function<void(MqttClient*)> MqttCallback;
  119. typedef std::function<void(MqttClient*, mqtt_message_t*)> MqttMessageCallback;
  120. MqttCallback onConnect;
  121. MqttCallback onClose;
  122. MqttMessageCallback onMessage;
  123. MqttClient(hloop_t* loop = NULL) {
  124. client = mqtt_client_new(loop);
  125. }
  126. ~MqttClient() {
  127. if (client) {
  128. mqtt_client_free(client);
  129. client = NULL;
  130. }
  131. }
  132. void run() {
  133. mqtt_client_set_callback(client, on_mqtt);
  134. mqtt_client_set_userdata(client, this);
  135. mqtt_client_run(client);
  136. }
  137. void stop() {
  138. mqtt_client_stop(client);
  139. }
  140. void setID(const char* id) {
  141. mqtt_client_set_id(client, id);
  142. }
  143. void setWill(mqtt_message_t* will) {
  144. mqtt_client_set_will(client, will);
  145. }
  146. void setAuth(const char* username, const char* password) {
  147. mqtt_client_set_auth(client, username, password);
  148. }
  149. void setPingInterval(int sec) {
  150. client->keepalive = sec;
  151. }
  152. int lastError() {
  153. return mqtt_client_get_last_error(client);
  154. }
  155. // SSL/TLS
  156. int setSslCtx(hssl_ctx_t ssl_ctx) {
  157. return mqtt_client_set_ssl_ctx(client, ssl_ctx);
  158. }
  159. int newSslCtx(hssl_ctx_opt_t* opt) {
  160. return mqtt_client_new_ssl_ctx(client, opt);
  161. }
  162. void setReconnect(reconn_setting_t* reconn) {
  163. mqtt_client_set_reconnect(client, reconn);
  164. }
  165. void setConnectTimeout(int ms) {
  166. mqtt_client_set_connect_timeout(client, ms);
  167. }
  168. int connect(const char* host, int port = DEFAULT_MQTT_PORT, int ssl = 0) {
  169. return mqtt_client_connect(client, host, port, ssl);
  170. }
  171. int reconnect() {
  172. return mqtt_client_reconnect(client);
  173. }
  174. int disconnect() {
  175. return mqtt_client_disconnect(client);
  176. }
  177. bool isConnected() {
  178. return mqtt_client_is_connected(client);
  179. }
  180. int publish(mqtt_message_t* msg, MqttCallback ack_cb = NULL) {
  181. int mid = mqtt_client_publish(client, msg);
  182. if (msg->qos > 0 && mid >= 0 && ack_cb) {
  183. setAckCallback(mid, ack_cb);
  184. }
  185. return mid;
  186. }
  187. int publish(const std::string& topic, const std::string& payload, int qos = 0, int retain = 0, MqttCallback ack_cb = NULL) {
  188. mqtt_message_t msg;
  189. memset(&msg, 0, sizeof(msg));
  190. msg.topic_len = topic.size();
  191. msg.topic = topic.c_str();
  192. msg.payload_len = payload.size();
  193. msg.payload = payload.c_str();
  194. msg.qos = qos;
  195. msg.retain = retain;
  196. return publish(&msg, ack_cb);
  197. }
  198. int subscribe(const char* topic, int qos = 0, MqttCallback ack_cb = NULL) {
  199. int mid = mqtt_client_subscribe(client, topic, qos);
  200. if (qos > 0 && mid >= 0 && ack_cb) {
  201. setAckCallback(mid, ack_cb);
  202. }
  203. return mid;
  204. }
  205. int unsubscribe(const char* topic, MqttCallback ack_cb = NULL) {
  206. int mid = mqtt_client_unsubscribe(client, topic);
  207. if (mid >= 0 && ack_cb) {
  208. setAckCallback(mid, ack_cb);
  209. }
  210. return mid;
  211. }
  212. protected:
  213. void setAckCallback(int mid, MqttCallback cb) {
  214. ack_cbs_mutex.lock();
  215. ack_cbs[mid] = std::move(cb);
  216. ack_cbs_mutex.unlock();
  217. }
  218. void invokeAckCallback(int mid) {
  219. MqttCallback ack_cb = NULL;
  220. ack_cbs_mutex.lock();
  221. auto iter = ack_cbs.find(mid);
  222. if (iter != ack_cbs.end()) {
  223. ack_cb = std::move(iter->second);
  224. ack_cbs.erase(iter);
  225. }
  226. ack_cbs_mutex.unlock();
  227. if (ack_cb) ack_cb(this);
  228. }
  229. static void on_mqtt(mqtt_client_t* cli, int type) {
  230. MqttClient* client = (MqttClient*)mqtt_client_get_userdata(cli);
  231. // printf("on_mqtt type=%d\n", type);
  232. switch(type) {
  233. case MQTT_TYPE_CONNECT:
  234. // printf("mqtt connected!\n");
  235. break;
  236. case MQTT_TYPE_DISCONNECT:
  237. // printf("mqtt disconnected!\n");
  238. if (client->onClose) {
  239. client->onClose(client);
  240. }
  241. break;
  242. case MQTT_TYPE_CONNACK:
  243. // printf("mqtt connack!\n");
  244. if (client->onConnect) {
  245. client->onConnect(client);
  246. }
  247. break;
  248. case MQTT_TYPE_PUBLISH:
  249. if (client->onMessage) {
  250. client->onMessage(client, &cli->message);
  251. }
  252. break;
  253. case MQTT_TYPE_PUBACK: /* qos = 1 */
  254. // printf("mqtt puback mid=%d\n", cli->mid);
  255. client->invokeAckCallback(cli->mid);
  256. break;
  257. case MQTT_TYPE_PUBREC: /* qos = 2 */
  258. // printf("mqtt pubrec mid=%d\n", cli->mid);
  259. // wait MQTT_TYPE_PUBCOMP
  260. break;
  261. case MQTT_TYPE_PUBCOMP: /* qos = 2 */
  262. // printf("mqtt pubcomp mid=%d\n", cli->mid);
  263. client->invokeAckCallback(cli->mid);
  264. break;
  265. case MQTT_TYPE_SUBACK:
  266. // printf("mqtt suback mid=%d\n", cli->mid);
  267. client->invokeAckCallback(cli->mid);
  268. break;
  269. case MQTT_TYPE_UNSUBACK:
  270. // printf("mqtt unsuback mid=%d\n", cli->mid);
  271. client->invokeAckCallback(cli->mid);
  272. break;
  273. default:
  274. break;
  275. }
  276. }
  277. private:
  278. // mid => ack callback
  279. std::map<int, MqttCallback> ack_cbs;
  280. std::mutex ack_cbs_mutex;
  281. };
  282. }
  283. #endif
  284. #endif // HV_MQTT_CLIENT_H_