PUBREC报文是对QoS等级2的PUBLISH报文的响应。它是QoS 2等级协议交换的第二个报文。
Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
---|---|---|---|---|---|---|---|---|
byte 1 | MQTT控制报文类型 (5) | 保留位 | ||||||
0 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | |
byte 2 | 剩余长度 (2) |
剩余长度字段
表示可变报头的长度,用变长字节整数编码。
PUBREC可变报头按顺序包含以下字段:所确认的PUBLISH报文标识符(Packet Identifier),PUBREC原因码(Reason Code),属性(Properties)。属性的编码规则,如2.2.2节所述。
Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
---|---|---|---|---|---|---|---|---|
byte 1 | 报文标识符 MSB | |||||||
byte 2 | 报文标识符 LSB | |||||||
byte 3 | PUBREC原因码 | |||||||
byte 4 | 属性长度 |
PUBREC可变报头第3字节是原因码(Reason Code)。如果剩余长度为2,则表示使用原因码0x00(成功)。
值 | 16进制 | 原因码名称 | 说明 |
---|---|---|---|
0 | 0x00 | 成功 | 消息被接收。QoS为2的消息已发布。 |
16 | 0x10 | 无匹配的订阅者 | 消息被接收,但没有订阅者。只有服务端会发送此原因码。如果服务端得知没有匹配的订阅者,服务端可以使用此原因码代替0x00(成功)。 |
128 | 0x80 | 未指明的错误 | 接收端不接受此消息,且不愿意透露错误原因或没有适用的原因码。 |
131 | 0x83 | 实现特定错误 | PUBLISH报文有效,但不被接收端所接受。 |
135 | 0x87 | 未授权 | PUBLISH报文未授权。 |
144 | 0x90 | 主题名无效 | 主题名格式正确,但未被客户端或服务端所接受。 |
145 | 0x91 | 报文标识符被占用 | 报文标识符正被占用。可能表明客户端和服务端之间的会话状态不匹配。 |
151 | 0x97 | 超出配额 | 已超出实现限制或管理限制。 |
153 | 0x99 | 载荷格式无效 | 载荷格式与载荷格式指示符不匹配。 |
服务端或客户端发送PUBREC报文时必须设置其中一种原因码 [MQTT-3.5.2-1]。当原因码为0x00(成功)且没有属性(Properties)时,原因码和属性长度可以被省略。在这种情况下,PUBREC剩余长度为2。
PUBREC可变报头的属性长度被编码为变长字节整数。如果剩余长度小于4,则表示没有属性长度字段。
31 (0x1F) ,原因字符串(Reason String)标识符。 跟随其后的是UTF-8编码的字符串,表示此次响应相关的原因。此原因字符串(Reason String)是为诊断而设计的可读字符串,不应该被接收端所解析。
发送端使用此值向接收端提供附加信息。如果加上原因字符串之后的PUBREC报文长度超出了接收端指定的最大报文长度(Maximum Packet Size),则发送端不能发送此属性 [MQTT-3.5.2-2]。包含多个原因字符串将造成协议错误(Protocol Error)。
38 (0x26) ,用户属性(User Property)标识符。 跟随其后的是UTF-8字符串对。此属性可用于提供包括诊断信息在内的附加信息。如果加上用户属性之后的PUBREC报文长度超出了接收端指定的最大报文长度(Maximum Packet Size),则发送端不能发送此属性 [MQTT-3.5.2-3]。用户属性(User Property)允许出现多次,以表示多个名字/值对,且相同的名字可以多次出现。
PUBREC报文没有有效载荷。
描述见 4.3.3节。
- 3.0 Contents – MQTT控制报文
- 3.1 CONNECT – 连接服务端
- 3.2 CONNACK – 确认连接请求
- 3.3 PUBLISH – 发布消息
- 3.4 PUBACK –发布确认
- 3.5 PUBREC – 发布收到(QoS 2,第一步)
- 3.6 PUBREL – 发布释放(QoS 2,第二步)
- 3.7 PUBCOMP – 发布完成(QoS 2,第三步)
- 3.8 SUBSCRIBE - 订阅主题
- 3.9 SUBACK – 订阅确认
- 3.10 UNSUBSCRIBE –取消订阅
- 3.11 UNSUBACK – 取消订阅确认
- 3.12 PINGREQ – 心跳请求
- 3.13 PINGRESP – 心跳响应
- 3.14 DISCONNECT –断开连接
- 3.15 AUTH – 认证交换