MQTT控制---connect

连接服务端

　　客户端到服务端的第一个报文必须是CONNECT，且只能发送一次，发送的第二个connect报文当作违规处理并断开连接。

　　有效载荷包含一个或者多个编码的字段。包括客户端的唯一标识符，Will主题，Will消息，用户名和密码。

　　除了标识外，其他字段都是可选的，基于标志位决定可变报头中是否需要包含这些字段。

固定报头

　　报头长度：2 Bytes

　　1、报文类型：1  CONNECT

　　2、标志位  0 0 0 0：

　

　　3、剩余长度

　　　　等于可变报头的长度（10）加上有效载荷的长度。

可变报头

　　在固定CONNECT报文可变报头包含四个字段，协议名、协议级别、连接标志、保持连接：

　　1、协议名 （Protocol Name）。

　　如果协议名不正确，server端可以断开连接。

　　2、协议级别（Protocol Level）。

　　使用第7个字节：

　　

　　客户端用8位的无符号值表示协议的版本。对于3.1.1，协议级别值是4（04）。

　　如果发现不支持的协议级别，server必须发送一个0x01的ACK报文响应CONNECT报文，然后断开连接。

　　3、连接标志（Connect Flags）。

　　bit 0  ： server必须验证CONNECT的保留标志位（第0位）是否为0，如果不为0必须断开连接。

　　bit 1：指定了会话状态的处理方式。用于控制会话状态的生存时间。

　　　　= 0 ：server必须基于当前会话的状态恢复与client的通信。如果没有与这个client标识符关联的会话，server必须创建一个新会话。

　　　　　　在连接断开后，client和server必须保存会话信息。server必须将之后的QoS 1和QoS2级别的消息保存为会话状态的一部分，

　　　　　　如果这些消息匹配断开连接时client的任何订阅。server也可以保存满足相同条件的QoS 0级别的消息。

　　　　= 1：server和client必须丢弃之前的任何会话，并开始一个新的会话。

　　　　　　会话仅持续和网络连接同样长的时间。与这个会话关联的状态数据不能被任何之后的会话重用。

　　　　　　client的会话状态包括：

• • • • 已经发送给server，但是还没有完成确认的QoS 1 和QoS 2 级别的消息
      • 已从server接收，但是还没有完成确认的QoS 2 级别的消息

　　　　　　server会话状态包括：

• • • • 会话是否存在，即使会话状态的其他部分都是空。
      • client的订阅信息
      • 已经发送给client，但是还没有完成确认的QoS 1  和 QoS 2 级别的消息。
      • 即将传输给client的QoS 1和QoS 2级别的消息
      • 已从client接收，但是还没有完成确认的QoS 2级别的消息
      • 可选，准备发送给client的QoS 0 级别的消息

　　bit 2：遗嘱标志 （Will Flag）

　　　　=1：如果连接请求被接受了，遗嘱消息必须被保存在server端并且与这个网络连接关联。之后网络连接关闭时，server必须发布这个遗嘱消息。

　　　　　　除非server收到DISCONNECT报文时删除了这个遗嘱消息。

　　　　　　遗嘱消息发布的条件：

• • • • server检测到了一个I/O错误或者网络故障
      • client在保持连接的时间内未能通讯
      • client没有先发送DISCONNECT直接关闭了网络连接
      • 由于协议错误server关闭了网络连接

　　　　　　之后的连接标志Will QoS 和Will Retain字段会被server用到，同是，有效载荷中必须包含Will Topic 和Will Message字段

　　　　　　一旦被发布或者server收到了client发送的DISCONNECT，遗嘱消息就必须从存储的会话状态中移除。

　　　　=0：之后的连接标志Will QoS 和Will Retain字段必须为0，并且有效载荷中不能包含Will Topic 和Will Message字段。

　　　　　　网络连接断开时，不能发送遗嘱消息。

　　　　　　server端应该迅速发布遗嘱消息。在关机或者故障的情况下，server可以推迟遗嘱消息的发布直到之后的重启。

　　　　　　如果发生了这种情况，在server故障和遗嘱消息被发布之间可能会有一个延迟。

　　bit 3-4：遗嘱QoS  Will QoS

　　　　这两位用于指定发布遗嘱消息时使用的服务质量等级。

　　　　值由遗嘱标志位决定：

　　　　Will Flag = 0：它的值必须设置为0。

　　　　Will Flag = 1：它的值可以等于0,1,2。

　　bit 5：遗嘱保留 Will Retain

　　　　如果遗嘱消息被发布时需要保留，需要指定这一位的值。

　　　　如果Will Flag = 0：  它的值为 0 ，server必须将遗嘱消息当作非保留信息发布。

　　　　如果 Will Flag = 1： 它的值为 1 ，server必须将遗嘱消息当作保留信息发布。

　　bit 6：密码标志  Password Flag　

　　　　=0：有效载荷中不能包含密码字段

　　　　=1：有效载荷中必须包含密码字段

　　　　如果用户名标志为0，它也必须为0

　　bit 7：用户名标志 User Name Flag

　　　　=0：有效载荷中不能包含用户名字段

　　　　=1：有效载荷中必须包含用户名字段

　　4、保持连接（Keep Alive）。

　　使用第9、10字节。

　　它是一个以秒为单位的时间间隔，表示为一个16位的字，它是指在client传输完一个控制报文的时刻到发送下一个报文的时刻。

　　client负责保证报文发送的时间间隔不超过保持连接的值。如果没有任何其他的报文发送，就必须发送一个PINGREQ报文。

　　不管保持连接的值是多少，client任何时候都可以发送PINGREQ报文，并且使用PINGRESP判断网络和server的活动状态。

　　= ！0 ：如果server在1.5倍的时间内没有收到client的报文，它必须断开连接。

　　　　client在发送了PINGREQ后，如果在合理的时间内没有收到PINGRESP，也应该关闭连接。

　　= 0 ：表示关闭连接保持的功能。意味着，server不需要因为client不活跃而关闭连接。

　　　　不管保持值为多少，任何时候，只要server认为client是不活跃或无响应的，可以断开client连接。

　　可变报头示例：

有效载荷

　　CONNECT报文的有效载荷包含一个或多个以长度为前缀的字段，可变报头中的标志决定是否包含这些字段。

　　如果包含的话，必须按照这个顺序出现：client标识符，遗嘱主题，遗嘱消息，用户名，密码。

　　1、client标识符

　　server使用client标识符识别client。

　　连接到server的每个client都有唯一的clientID。

　　client和server都必须使用clientID识别两者之间的MQTT会话相关的状态。

　　clientID必须存在，必须是CONNECT报文有效载荷的第一个字段。

　　clientID必须是UTF-8编码字符串。

　　server必须允许1到23个字节长的UTF-8编码的clientID，clientID只能包含这些字符：

　　　　　　“0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ”

　　server可以允许编码后超过23个字节的clientID，也可以允许包含不是上面列表字符的clientID。

　　如果server拒绝了这个clientID，它必须发送返回码0x02（表示ID不合格）的CONNACK。

　　于PUBLISH来说就是消息内容了。

　　需要有效载荷的控制报文：CONNECT、SUBSCRIBE、SUBACK、UNSUBSCRIBE。 PUBLISH是可选。

　　2、遗嘱主题 

　　如果遗嘱标志为1，有效载荷的下一个字段是遗嘱主题，它必须是UTF-8编码字符串。

　　3、遗嘱消息

　　如果遗嘱标志为1，有效载荷的下一个字段是遗嘱消息。遗嘱消息定义了将被发布到遗嘱主题的应用消息。

　　这个字段由一个两字节长度+有效载荷组成。长度给出了跟在后面的数据的字节数，不包含长度字段本身的两个字节。

　　遗嘱消息被发布到遗嘱主题时，它的有效载荷只包含这个字段的数据部分，不包含开头的两个长度字节。

　　4、用户名

　　如果用户名标志为1：有效载荷的下一个字段就是它，server用于身份验证和授权。

　　5、密码

　　密码字段包含一个两字节的长度字段，长度表示二进制数据的字节数(不包含长度字段本身占用的两个字节)，后面跟着0-65535字节的二进制数据。

　　密码字节：

响应

　　server检查CONNECT报文的内容是不是满足任何进一步的限制，可以执行身份验证和授权检查。　　　　　

　　如果验证成功，执行下列步骤：

1. 1. 如果ClientID表明client已经连接到这个server，server必须断开原来的client连接
   2. server按照执行清理会话过程
   3. server发送返回码为0的CONNACK报文作为CONNECT报文的确认响应
   4. 开始消息分发和保持连接状态监视

　　允许client在发送CONNECT报文后立即发送其它的控制报文；client不需要等待server的CONNACK报文。

　　如果server拒绝了CONNECT，它不能继续处理在CONNECT报文之后发送的任何数据。

-----------------------------------------------------------------------------------------------------------------------

CONNACK-确认连接请求

　　server发送给client的第一个报文必须是CONNACK。

　　如果client在合理的时间内没有收到CONNACK，client应该关闭连接。（合理的时间取决于应用的类型和通信基础设施）

　　固定报头

　　报头格式描述如下：

　　剩余长度字段表示可变报头的长度。对于CONNACK，这个值是2.

　　可变报头

　　可变报头描述如下：

　　byte 1 ：连接确认标志，1-7位是保留，且必须设置为0。第0位是当前会话标志。使server和client在是否有已保存的会话状态上保持一致。

　　　　如果server收到清理会话标志为1的连接，除了将CONNACK报文中的返回码设置为0之外，还必须设置当前会话标志设为0。

　　　　如果server收到清理会话标志为0的连接，它的值取决于server是否保存了clientID对应client的会话状态。如果保存则为1，否则为0。

　　　　如果server发送了一个包含非零返回码的CONNACK报文，它必须将当前会话标志设置为0。

　　byte 2 ：连接返回码，使用一个字节的无符号值。

　　　　如果server收到一个合法的CONNECT报文，但是出于某些原因无法处理它，server应该尝试发送一个包含非零返回码，再关闭连接。

　　连接返回码：

　　如果认为上表中的所有连接返回码都不太适合，那么server必须关闭连接，不需要发送CONNACK报文。

　　有效载荷

　　　　CONNACK没有载荷