提交 ea4cc70a 编写于 作者: 如梦技术's avatar 如梦技术 🐛

📝 优化文档。

上级 c9e512b6
......@@ -44,11 +44,11 @@
</dependency>
```
**配置详见**[mica-mqtt 使用文档](docs/docs.md)
**配置详见**[mica-mqtt 使用文档](mica-mqtt-core/README.md)
## 文档
- [mica-mqtt-spring-boot-starter 使用文档](mica-mqtt-spring-boot-starter/README.md)
- [mica-mqtt 使用文档](docs/docs.md)
- [mica-mqtt 使用文档](mica-mqtt-core/README.md)
- [mica-mqtt 发行版本](CHANGELOG.md)
- [t-io 官方文档](https://www.tiocloud.com/doc/tio/85)
- [mqtt 协议文档](https://github.com/mcxiaoke/mqtt)
......
# mica-mqtt-spring-boot-starter 使用文档
**详见**[mica-mqtt-spring-boot-starter 使用文档](../mica-mqtt-spring-boot-starter/README.md)
\ No newline at end of file
# 文档备忘
# 使用文档
## topic 通配符含义
- `/`:用来表示层次,比如 a/b,a/b/c。
- `#`:表示匹配 `>=0` 个层次,比如 a/# 就匹配 a/,a/b,a/b/c。单独的一个 # 表示匹配所有。不允许 a# 和 a/#/c。
- `+`:表示匹配一个层次,例如 a/+ 匹配 a/b,a/c,不匹配 a/b/c。单独的一个 + 是允许的,a+ 不允许,a/+/b 不允许。
## 使用说明
### MQTT 遗嘱消息场景
> 当客户端断开连接时,发送给相关的订阅者的遗嘱消息。在设备 A 进行连接时候,遗嘱消息设定为 `offline`,手机App B 订阅这个遗嘱主题。
> 当 A 异常断开时,手机App B 会收到这个 `offline` 的遗嘱消息,从而知道设备 A 离线了。
### MQTT 保留消息场景
> 例如,某设备定期发布自身 GPS 坐标,但对于订阅者而言,从它发起订阅到第一次收到数据可能需要几秒钟,也可能需要十几分钟甚至更多,这样并不友好。因此 MQTT 引入了保留消息。
> 而每当有订阅者建立订阅时,服务端就会查找是否存在匹配该订阅的保留消息,如果保留消息存在,就会立即转发给订阅者。
> 借助保留消息,新的订阅者能够立即获取最近的状态。
## 客户端使用
```java
// 初始化 mqtt 客户端
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册