Files
TencentOS-tiny/components/connectivity/mqttclient/docs/mqtt-communication.md
2020-06-18 19:49:31 +08:00

154 lines
9.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 图文并茂学习MQTT协议通信过程
# MQTT连接服务器
客户端到服务器的网络连接建立后客户端发送给服务器的第一个报文必须是CONNECT报文
在一个网络连接上客户端只能发送一次CONNECT报文如果出现第二个CONNECT报文按照协议标准服务器会将第二个CONNECT报文当作协议违规处理并断开客户端的连接。
对于正常的连接请求,服务器必须产生应答报文,如果无法建立会话,服务器应该在应答报文中报告对应的错误代码。
![mqtt007](http://qiniu.jiejie01.top/mqtt007.png)
# MQTT订阅主题
客户端向服务器发送SUBSCRIBE报文用于创建一个或多个订阅。
在服务器中会记录这个客户关注的一个或者多个主题当服务器收到这些主题的PUBLISH报文的时候将分发应用消息到与之匹配的客户端中。
SUBSCRIBE报文支持通配符也为每个订阅指定了最大的QoS等级服务器根据这些信息分发应用消息给客户端。
SUBSCRIBE报文拥有固定报头、可变报头、有效载荷。
当服务器收到客户端发送的一个SUBSCRIBE报文时必须向客户端发送一个SUBACK报文响应同时SUBACK报文必须和等待确认的SUBSCRIBE报文有相同的报文标识符。
如果服务器收到一个SUBSCRIBE报文报文的主题过滤器与一个现存订阅的主题过滤器相同那么必须使用新的订阅彻底替换现存的订阅。新订阅的主题过滤器和之前订阅的相同但是它的最大QoS值可以不同。与这个主题过滤器匹配的任何现存的保留消息必须被重发但是发布流程不能中断。
![mqtt008](http://qiniu.jiejie01.top/mqtt008.png)
SUBSCRIBE报文的有效载荷包含了一个主题过滤器列表它们表示客户端想要订阅的主题SUBSCRIBE报文有效载荷中的主题过滤器列表必须是UTF-8字符串。
服务器应该支持包含通配符的主题过滤器。如果服务器选择不支持包含通配符的主题过滤器,必须拒绝任何包含通配符过滤器的订阅请求。
每一个过滤器后面跟着一个字节这个字节被叫做服务质量要求Requested QoS。它给出了服务器向客户端发送应用消息所允许的最大QoS等级。
# MQTT发布消息
PUBLISH控制报文是指从客户端向服务器或者服务器向客户端发送一个应用消息。其实从服务器分发的报文给订阅者也是属于PUBLISH控制报文。
## 服务质量等级 QoS
QoS的值表示应用消息分发的服务质量等级保证在不同的服务质量等级中PUBLISH控制报文的处理方式也是不同的而且PUBLISH报文的接收者可以是服务器也可以是客户端必须按照根据PUBLISH报文中的QoS等级发送对应的应答报文。
PUBLISH报文固定报头的bit2-bit1位表示服务质量等级
| QoS值 | Bit 2 | Bit 1 | 描述 |
| -- | -- | --| -- |
| 0 | 0 | 0 | 最多分发一次 |
| 1 | 0 | 1 | 至少分发一次 |
| 2 | 1 | 0 | 只分发一次 |
| - | 1 | 1 | 保留位 |
MQTT按照这里定义的服务质量 (QoS) 等级分发应用消息。服务器分发应用消息给多个客户端(订阅者)时,每个客户端独立处理。从发布者发布消息到接受者,分发的消息服务质量可能是不同的,这取决于订阅者订阅主题时指定的服务质量等级。而对于发布者而言,发布消息时就指定了服务质量等级。
## QoS0的PUBLISH控制报文
消息的分发依赖于底层网络的能力。服务器不会发送响应,发布者也不会重试,它在发出这个消息的时候就立马将消息丢弃,这个消息可能送达一次也可能根本没送达。
发布者必须发送QoS等于0DUP等于0的PUBLISH报文。
在服务器接受PUBLISH报文时要将消息分发给订阅该主题消息的订阅者。
![mqtt009](http://qiniu.jiejie01.top/mqtt009.png)
## QoS1的PUBLISH控制报文
服务质量确保消息至少送达一次甚至可能被多次处理。QoS1的PUBLISH报文的可变报头中包含一个报文标识符需要PUBACK报文确认。
发布者在每次发送新的应用消息都必须分配一个未使用的报文标识符在发布消息的同时将消息存储起来等待服务器的应答直到从接收者那收到对应的PUBACK报文。发送的PUBLISH报文必须包含报文标识符且QoS等于1DUP等于0。
一旦发布者收到来自服务器的PUBACK报文后这个报文标识符就可以重复使用。
接收者响应的PUBACK报文必须包含一个报文标识符这个标识符来自接收到的PUBLISH报文。在发送了PUBACK报文之后接收者必须将任何包含相同报文标识符的入站PUBLISH报文当作一个新的消息并忽略它的DUP标志的值。
![mqtt010](http://qiniu.jiejie01.top/mqtt010.png)
## QoS2的PUBLISH控制报文
这是最高等级的服务质量,必须保证有且只有处理一次消息,消息丢失和重复都是不可接受的。使用这个服务质量等级会有额外的开销。
QoS2的消息可变报头中有报文标识符。
QoS2的PUBLISH报文的接收者使用一个两步确认过程来确认收到。
发送者必须给要发送的新应用消息分配一个未使用的报文标识符。发送的PUBLISH报文必须包含报文标识符且报文的QoS等于2,DUP等于0。
在消息发出去后需要将这个消息存储起来而且必须将这个PUBLISH报文看作是未确认的直到从接收者那收到对应的PUBREC报文。
当发布者收到的PUBREC报文后必须发送一个PUBREL报文。PUBREL报文必须包含与原始PUBLISH报文相同的报文标识符。
而且发布者还必须必须将这个PUBREL报文看作是未确认的直到从接收者那收到对应的PUBCOMP报文。一旦发送了对应的PUBREL报文就不能重发这个PUBLISH报文。
所以就如下图所示在发布消息的时候立马存储消息在收到PUBREC报文后必须将存储的消息丢弃掉然后存储报文标识符与此同时还要将PUBREL报文发送出去最后在收到PUBCOMP报文后才丢弃存储的报文标识符。
![mqtt011](http://qiniu.jiejie01.top/mqtt011.png)
当然啦,对应分发消息也是比较复杂的,它一般有两种处理方案,每一种方案都要确保消息有且只有处理一次。
接收者此处指服务器响应的PUBREC报文必须包含报文标识符这个标识符来自接收到的PUBLISH报文。
发送PUBREC报文后在收到对应的PUBREL报文之前接收者可以将消息分发给订阅者但是必须要存储报文标识符方案1
当然它在这种情况下也可以存储消息直到收到PUBREL报文才将消息分发到订阅者方案2
而当它收到PUBREL报文后它必须发送PUBCOMP报文响应发布者该报文必须包含与PUBREL报文相同的标识符。
与此同时它可以丢弃存储的报文标识符方案1而不必再分发应用消息给订阅者。
如果此前没有分发应用消息给订阅者方案2那么此时需要分发应用消息给订阅者然后丢弃消息。
在接收者发送PUBCOMP报文之后接收者必须将包含相同报文标识符的任何后续PUBLISH报文当作一个新的发布。
# 取消订阅
客户端发送UNSUBSCRIBE报文给服务器用于取消订阅主题。
UNSUBSCRIBE报文固定报头的第3,2,1,0位是保留位且必须分别设置为0,0,1,0。否则服务器必须认为任何其它的值都是不合法的并关闭网络连。具体的描述可以看协议文档。
UNSUBSCRIBE报文的有效载荷包含客户端想要取消订阅的主题过滤器列表。UNSUBSCRIBE报文中的主题过滤器必须是连续打包的UTF-8编码字符串。
UNSUBSCRIBE报文的有效载荷必须至少包含一个主题过滤器列表而且这个主题过滤器是已经被客户端订阅的否则的话没有订阅也就没有取消订阅一说了。如果一个UNSUBSCRIBE报文没有有效载荷是违反协议的标准的服务器也不会去处理它。
而对于服务器删除了一个订阅那么它将不会再分发该主题的消息到这个客户端中。而且它必须完成分发任何已经开始往客户端发送的QoS1和QoS2的消息以保证消息的服务质量。
然后服务器必须发送UNSUBACK报文来响应客户端的UNSUBSCRIBE请求。UNSUBACK报文必须包含和UNSUBSCRIBE报文相同的报文标识符。即使没有删除任何主题订阅客户端取消订阅的主题未被订阅服务器也必须发送一个UNSUBACK响应。
![mqtt012](http://qiniu.jiejie01.top/mqtt012.png)
# 断开连接
DISCONNECT报文是客户端发给服务端的最后一个控制报文。表示客户端正常断开连接。
DISCONNECT报文的固定报头保留位必须全为0。
客户端发送DISCONNECT报文之后必须关闭网络连接不能通过那个网络连接再发送任何控制报文。
服务端在收到DISCONNECT报文时必须丢弃任何与当前连接关联的未发布的遗嘱消息。而且当客户端没有关闭网络连接的时候服务器应该主动去关闭网络连接。
![mqtt013](http://qiniu.jiejie01.top/mqtt013.png)
**上一篇**[MQTT协议简介](./mqtt-introduction.md)
**下一篇**[mqttclient代码生成工具](./mqtt-tool.md)