longbridge__developers/docs/socket/protocol/how-to-parse-request.md

title, id, slug, sidebar_position

title	id	slug	sidebar_position
解析请求包	how-to-parse-request	/socket/protocol/request	4

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

:::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_code	8	1	指令 cmd 值
request_id	32(uint32)	4	请求 id，同一个连接的 id 需要唯一，从 1 开始，到达 4294967295 后从新开始。
timeout	16(uint16)	2	timeout 单位毫秒，最大 60000（60s）
body_len	24(uint32)	3	body 长度，单位：字节，最大 16 MB 数据；如果 gzip 为 1，该值为 body 压缩后的长度
body	可变长度，由 body_len 决定	可变长度	body，最大 16 MB
nonce	64	8	仅当包头中的 verify 为 1 时存在
signature	128	16	仅当包头中的 verify 为 1 时存在

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