跳转到内容

当客户端想要请求服务端获取数据时必须通过请求包发送相应的请求。

ℹ️Info

当包头中的 type 值为 1 时,数据包为请求包

结构如下:

  0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| type=1|v|g|re.|    cmd_code   |           request_id          |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                               |            timeout            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                    body_len                   |               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+               +
|                       body(by body_len)                       |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
+                        nonce(optional)                        +
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
+                                                               +
|                                                               |
+                      signature(optional)                      +
|                                                               |
+                                                               +
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

包体字段说明如下:

字段长度 (bit)长度(字节)说明
cmd_code81指令 cmd 值
request_id32(uint32)4请求 id,同一个连接的 id 需要唯一,从 1 开始,到达 4294967295 后从新开始。
timeout16(uint16)2timeout 单位毫秒,最大 60000(60s)
body_len24(uint32)3body 长度,单位:字节,最大 16 MB 数据;如果 gzip 为 1,该值为 body 压缩后的长度
body可变长度,由 body_len 决定可变长度body,最大 16 MB
nonce648仅当包头中的 verify 为 1 时存在
signature12816仅当包头中的 verify 为 1 时存在
ℹ️Info

获取到数据包后,通过反序列化 body 得到具体的业务数据

基于 MIT 许可发布