README.md

🌐 Dromara mica mqtt 组件

---

📖简体中文 | 📖English

Dromara mica-mqtt 低延迟、高性能的 mqtt 物联网组件。更多使用方式详见： mica-mqtt-example 模块。

✨✨✨最佳实践✨✨✨ BladeX 物联网平台（基于 mica-mqtt 加强版）

🍱 使用场景

• 物联网（云端 mqtt broker）
• 物联网（边缘端消息通信）
• 群组类 IM
• 消息推送
• 简单易用的 mqtt 客户端

🚀 优势

• 平凡却不单调，简单却不失精彩。
• 手动档（更加易于二次开发或扩展）。
• 牛犊初生，无限可能。

✨ 功能

• 支持 MQTT v3.1、v3.1.1 以及 v5.0 协议。
• 支持 websocket mqtt 子协议（支持 mqtt.js）。
• 支持 http rest api，http api 文档详见。
• 支持 MQTT client 客户端，支持 Android。
• 支持 MQTT server 服务端，支持 Android。
• 支持 MQTT client、server 共享订阅支持。
• 支持 MQTT 遗嘱消息。
• 支持 MQTT 保留消息。
• 支持自定义消息（mq）处理转发实现集群。
• MQTT 客户端 阿里云 mqtt、华为云 mqtt 连接 demo 示例。
• 支持 GraalVM 编译成本机可执行程序。
• 支持 Spring boot、Solon 和 JFinal 项目快速接入。
• Spring boot、Solon client 插件支持保留 session。
• 支持对接 Prometheus + Grafana 实现监控。
• 基于 redis stream 实现集群，详见 mica-mqtt-broker 模块。

🌱 待办

• 优化处理 mqtt 服务端 session，以及简化 mqtt v5.0 使用。
• 基于 easy-rule + druid sql 解析，实现规则引擎。

🚨 默认端口

端口号	协议	说明
1883	tcp	mqtt tcp 端口
8083	http、websocket	http api 和 websocket mqtt 子协议端口

演示地址：mqtt.dreamlu.net 端口同上，账号：mica 密码：mica

📦️ 依赖

Spring boot 项目

客户端：

<dependency>
  <groupId>org.dromara.mica-mqtt</groupId>
  <artifactId>mica-mqtt-client-spring-boot-starter</artifactId>
  <version>${mica-mqtt.version}</version>
</dependency>

配置详见：mica-mqtt-client-spring-boot-starter 使用文档

服务端：

<dependency>
  <groupId>org.dromara.mica-mqtt</groupId>
  <artifactId>mica-mqtt-server-spring-boot-starter</artifactId>
  <version>${mica-mqtt.version}</version>
</dependency>

配置详见：mica-mqtt-server-spring-boot-starter 使用文档

solon 项目

客户端：

<dependency>
  <groupId>org.dromara.mica-mqtt</groupId>
  <artifactId>mica-mqtt-client-solon-plugin</artifactId>
  <version>${mica-mqtt.version}</version>
</dependency>

配置详见：mica-mqtt-client-solon-plugin 使用文档

服务端：

<dependency>
  <groupId>org.dromara.mica-mqtt</groupId>
  <artifactId>mica-mqtt-server-solon-plugin</artifactId>
  <version>${mica-mqtt.version}</version>
</dependency>

配置详见：mica-mqtt-server-solon-plugin 使用文档

JFinal 项目

客户端：

<dependency>
  <groupId>org.dromara.mica-mqtt</groupId>
  <artifactId>mica-mqtt-client-jfinal-plugin</artifactId>
  <version>${mica-mqtt.version}</version>
</dependency>

配置详见：mica-mqtt-client-jfinal-plugin 使用文档

服务端：

<dependency>
  <groupId>org.dromara.mica-mqtt</groupId>
  <artifactId>mica-mqtt-server-jfinal-plugin</artifactId>
  <version>${mica-mqtt.version}</version>
</dependency>

配置详见：mica-mqtt-server-jfinal-plugin 使用文档

其他项目

客户端：

<dependency>
  <groupId>org.dromara.mica-mqtt</groupId>
  <artifactId>mica-mqtt-client</artifactId>
  <version>${mica-mqtt.version}</version>
</dependency>

配置详见：mica-mqtt-client 使用文档

服务端：

<dependency>
  <groupId>org.dromara.mica-mqtt</groupId>
  <artifactId>mica-mqtt-server</artifactId>
  <version>${mica-mqtt.version}</version>
</dependency>

配置详见：mica-mqtt-server 使用文档

📝 文档

• mqtt科普、mqttx、mica-mqtt的使用视频
• mica-mqtt 快速开始
• mica-mqtt 使用常见问题汇总
• mica-mqtt 发行版本
• mica-mqtt 老版本迁移指南

🏗️ mqtt 桌面工具

• mqttx 优雅的跨平台 MQTT 5.0 GUI工具

🍻 开源推荐

• Avue 基于 vue 可配置化的前端框架：https://gitcode.com/superwei/avue
• pig 上央视的微服务框架（架构必备）：https://gitcode.com/pig-mesh/pig
• SpringBlade 企业级解决方案（企业开发必备）：https://gitcode.com/bladex/SpringBlade

📱 微信

JAVA架构日记，精彩内容每日推荐！