MQTT控制报文格式 -- SUBSCRIBE – 客户端订阅主题请求

• 订阅数据包从客户端发送到服务器以创建一个或多个订阅。 每个订阅都会登记客户对一个或多个主题的兴趣。 服务器向客户端发送 PUBLISH 数据包，以便转发已发布到与这些订阅匹配的主题的应用程序消息。 SUBSCRIBE 数据包还指定（对于每个订阅）服务器可以向客户端发送应用程序消息的最大 QoS。

1. 固定包头 Fixed header

固定包头的剩余长度= 可变包头长度 + payload长度

2. 可变包头 Variable header

可变包头会包含 数据包标识符（Packet Identifier），由2个字节构成
一个packet id=10 的样例如下：

3. 载荷 Payload

• SUBSCRIBE Payload 部分包含主题过滤器列表，指示客户端想要订阅的主题。使用UTF-8编码。
• 服务端应该支持主题过滤器，如果服务端不支持，那么应该拒绝包含通配符的SUBSCRIBE 请求。
• 每一个主题过滤器后面都有一个 QoS 字节，表示服务器可以向客户端发送消息的最大QoS 级别。
• SUBSCRIBE消息的Paylaod 必须包含最少1个主题 和Qos 的数据，否则被认为是违反协议标准

数据包组成：

Payload 样例：

响应和动作 Response

• 当服务端收到 SUBSCRIBE 数据包时，必须使用SUBACK 进行响应，SUBACK 中的 PacketIdentifier 必须与 SUBSCRIBE中的PacketIdtifier 相同。
• 服务端呗允许在发送SUBACK数据包之前开发发送与订阅匹配的PUBLISH 数据包
• 如果服务器收到包含与现有订阅的主题过滤器相同的订阅数据包，则它必须用新的订阅完全替换已有的。新订阅的主题过滤器与先前订阅的主题过滤器相同，尽管QoS 值可能不通，任何与主题过滤器匹配的现有保留消息都必须重新发送，使得发布流不中断。
• 如果主题过滤器与现有任何过滤器不同，则会创建新的订阅并发送所有匹配的保留消息。
• 如果服务器收到包含多个主题过滤器的SUBSCRIBE数据包，它必须像收到一系列多个SUBSCRIBE 数据包一样处理该数据包，只不过响应是单个的SUBACK。
• 服务端发送给客户端的SUBACK 必须包含每个主题过滤器的返回代码。此返回代码必须显示该订阅授予的最大QoS 或失败消息。
• 服务器可能会授予比订阅这请求的更低的最大QoS。
• SUBACK 消息Payload 中的QoS 必须是原始发布消息的QoS和服务器授予的最大的QoS 中的最小值。