README.en.md

🌐 mica mqtt

---

📖English | 📖简体中文

mica-mqtt is a low-latency and high-performance mqtt Internet of Things component. For more usage details, please refer to the mica-mqtt-example module.

🍱 Use Cases

• Internet of Things (cloud-based MQTT broker)
• Internet of Things (edge messaging communication)
• Group IM
• Message push
• Easy-to-use MQTT client

🚀 Advantages

• Ordinary yet not monotonous, simple yet not lackluster.
• Manual transmission (more conducive to secondary development or expansion).
• A newborn calf; infinite possibilities.

✨ Features

• Support for MQTT v3.1, v3.1.1, and v5.0 protocols.
• Support for WebSocket MQTT sub-protocol (compatible with mqtt.js).
• Support for HTTP REST API, see HTTP API Documentation for details.
• Support for MQTT client.
• Support for MQTT server.
• Support for MQTT Will messages.
• Support for MQTT Retained messages.
• Support for custom message (MQ) processing and forwarding to achieve clustering.
• MQTT client Alibaba Cloud MQTT、HuaWei MQTT connection demo.
• Support for GraalVM compilation into native executable programs.
• Support for rapid access to Spring Boot、Solon and JFinal projects.
• Support for integration with Prometheus + Grafana for monitoring.
• Cluster implementation based on Redis pub/sub, see mica-mqtt-broker module for details.

🌱 To-do

• Optimize the processing of MQTT sessions and support v5.0
• Implement rule engine based on easy-rule + druid sql parsing.

🚨 Default Ports

Port	Protocol	Description
1883	tcp	MQTT TCP port
8083	http, websocket	HTTP API and WebSocket MQTT port

Demo Address: mqtt.dreamlu.net, same ports，username: mica password: mica

📦️ Dependencies

Spring Boot Project

Client:

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

Configuration Details: mica-mqtt-client-spring-boot-starter Documentation

Server:

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

Configuration Details: mica-mqtt-server-spring-boot-starter Documentation

Non-Spring Boot Project

Client:

<dependency>
  <groupId>net.dreamlu</groupId>
  <artifactId>mica-mqtt-client</artifactId>
  <version>${mica-mqtt.version}</version>
</dependency>

Configuration Details: mica-mqtt-client Documentation

Server:

<dependency>
  <groupId>net.dreamlu</groupId>
  <artifactId>mica-mqtt-server</artifactId>
  <version>${mica-mqtt.version}</version>
</dependency>

Configuration Details: mica-mqtt-server Documentation

📝 Documentation

• Introduction to MQTT, mqttx, and mica-mqtt Video
• Getting Started with mica-mqtt
• mica-mqtt HTTP API Documentation
• Frequently Asked Questions about mica-mqtt Usage
• mica-mqtt Release Versions
• MQTT Protocol Documentation

💡 References

• Netty Codec MQTT
• jmqtt
• iot-mqtt-server
• Netty MQTT Client

🏗️ MQTT Client Tools

• Mqttx: An Elegant Cross-platform MQTT 5.0 Client Tool

🍻 Open Source Recommendations

• Avue: A Vue-based configurable front-end framework: https://gitee.com/smallweigit/avue
• Pig: Microservice framework featured on CCTV (architectural essential): https://gitee.com/log4j/pig
• SpringBlade: Enterprise-level solution (essential for enterprise development): https://gitee.com/smallc/SpringBlade
• smart-mqtt: High-performance MQTT broker (surpassing EMQX): https://gitee.com/smartboot/smart-mqtt
• IJPay: Payment SDK, making payment accessible: https://gitee.com/javen205/IJPay
• JustAuth: The most comprehensive third-party login open-source library ever: https://github.com/zhangyd-c/JustAuth
• spring-boot-demo: Spring Boot in-depth learning in practice: https://github.com/xkcoding/spring-boot-demo

💚 Acknowledgements

Thanks to JetBrains for providing a free open-source license:

📱 WeChat

JAVA Architecture Diary, daily recommended exciting content!