1
0

mqtt_client.h 9.2 KB

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