MQTT控制报文介绍(2)-编程知识

一、CONNECT – 连接服务端

客户端到服务端的网络连接建立后，客户端发送给服务端的第一个报文必须是 CONNECT 报文。在一个网络连接上，客户端只能发送一次 CONNECT 报文。服务端必须将客户端发送的第二个 CONNECT报文当作协议违规处理并断开客户端的连接。

二、MQTT控制报文的结构

三、CONNECT 连接报文

3.1 CONNECT 连接报文固定报头

3.2 CONNECT 连接报文可变报头

第1位：

如果清理会话（CleanSession）标志被设置为 0，服务端必须基于当前会话（使用客户端标识符识别）的状态恢复与客户端的通信。如果没有与这个客户端标识符关联的会话，服务端必须创建一个新的会话。
如果清理会话（CleanSession）标志被设置为 1，客户端和服务端必须丢弃之前的任何会话并开始一个新的会话。会话仅持续和网络连接同样长的时间。与这个会话关联的状态数据不能被任何之后的会话重用。

第二位：

遗嘱标志（Will Flag）被设置为 1，表示如果连接请求被接受了，遗嘱（Will Message）消息必须被存储在服务端并且与这个网络连接关联。之后网络连接关闭时，服务端必须发布这个遗嘱消息，除非服务端收到DISCONNECT 报文时删除了这个遗嘱消息。如果遗嘱标志被设置为 1，连接标志中的 Will QoS 和 Will Retain 字段会被服务端用到，同时有效载荷中必必须须包含 Will Topic 和 Will Message 字段。
如果遗嘱标志被设置为 0，连接标志中的 Will QoS 和 Will Retain 字段必须设置为 0，并且有效载荷中不能包含 Will Topic 和 Will Message 字段 。如果遗嘱标志被设置为 0，网络连接断开时，不能发送遗嘱消息

第三、四位：

如果遗嘱标志被设置为 0，遗嘱 QoS 也必须设置为 0(0x00)。
如果遗嘱标志被设置为 1，遗嘱 QoS 的值可以等于 0(0x00)，1(0x01)，2(0x02)。

第五位：

如果遗嘱标志被设置为 0，遗嘱保留（Will Retain）标志也必须设置为 0 。
如果遗嘱标志被设置为 1：
- 如果遗嘱保留被设置为 0，服务端必须将遗嘱消息当作非保留消息发布。
- 如果遗嘱保留被设置为 1，服务端必须将遗嘱消息当作保留消息发布。

第六位：

如果用户名（User Name）标志被设置为 0，有效载荷中不能包含用户名字段
如果用户名（User Name）标志被设置为 1，有效载荷中必须包含用户名字段

第七位：

如果密码（Password）标志被设置为 0，有效载荷中不能包含密码字段
如果密码（Password）标志被设置为 1，有效载荷中必须包含密码字段
如果用户名标志被设置为 0，密码标志也必须设置为 0

保持连接（Keep Alive）是一个以秒为单位的时间间隔，表示为一个 16 位的字，它是指在客户端传输完成一个控制报文的时刻到发送下一个报文的时刻，两者之间允许空闲的最大时间间隔。客户端负责保证控制报文发送的时间间隔不超过保持连接的值。如果没有任何其它的控制报文可以发送，客户端必须发送一个PINGREQ 报文。如果保持连接的值非零，并且服务端在一点五倍的保持连接时间内没有收到客户端的控制报文，它必须断开客户端的网络连接。

非规范评注：保持连接的实际值是由应用指定的，一般是几分钟。允许的最大值是 18 小时 12 分 15 秒。

3.3 CONNECT 连接报文有效载荷

CONNECT 报文的有效载荷（payload）包含一个或多个以长度为前缀的字段，可变报头中的标志决定是否包含这些字段。如果包含的话，必须按这个顺序出现：客户端标识符，遗嘱主题，遗嘱消息，用户名，密码

（一）客户端标识符：

服务端使用客户端标识符 (ClientId) 识别客户端。连接服务端的每个客户端都有唯一的客户端标识符（ClientId）。客户端和服务端都必须使用 ClientId 识别两者之间的 MQTT 会话相关的状态。客户端标识符 (ClientId) 必须存在而且必须是 CONNECT 报文有效载荷的第一个字段。
服务端必须允许 1 到 23 个字节长的 UTF-8 编码的客户端标识符，客户端标识符只能包含这些字符：“0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ”（大写字母，小写字母和数字）

（二）遗嘱主题：
如果遗嘱标志被设置为 1，有效载荷的下一个字段是遗嘱主题。

（三）遗嘱消息：
如果遗嘱标志被设置为 1，有效载荷的下一个字段是遗嘱消息。遗嘱消息定义了将被发布到遗嘱主题的应用消息。这个字段由一个两字节的长度和遗嘱消息的有效载荷组成，表示为零字节或
多个字节序列。长度给出了跟在后面的数据的字节数，不包含长度字段本身占用的两个字节。

（四）用户名：
如果用户名（User Name）标志被设置为 1，有效载荷的下一个字段就是它。服务端可以将它用于身份验证和授权。

（五）密码：
如果密码（Password）标志被设置为 1，有效载荷的下一个字段就是它。密码字段包含一个两字节的长度字段，长度表示二进制数据的字节数（不包含长度字段本身占用的两个字节），后面跟着 0 到 65535 字节的二进制数据。

3.4 CONNECT 报文确认连接请求

四、PUBLISH – 发布消息

PUBLISH 控制报文是指从客户端向服务端或者服务端向客户端传输一个应用消息

4.1 PUBLISH报文固定包头

第三位（DUP重发标志)：
如果 DUP 标志被设置为 0，表示这是客户端或服务端第一次请求发送这个 PUBLISH 报文。如果 DUP 标志被设置为 1，表示这可能是一个早前报文请求的重发。客户端或服务端请求重发一个 PUBLISH 报文时，必须将 DUP 标志设置为 1 。对于 QoS0 的消息，DUP 标志必须设置为 0

第一、二位（Qos等级、服务质量等级）：

第 0 位（保留标志）：
如果客户端发给服务端的 PUBLISH 报文的保留（RETAIN）标志被设置为 1，服务端必须存储这个应用消息和它的服务质量等级（QoS），以便它可以被分发给未来的主题名匹配的订阅者。
如果客户端发给服务端的 PUBLISH 报文的保留标志位 0，服务端不能存储这个消息也不能移除或替换任何现存的保留消息。