mirror of
https://github.com/longbridge/developers.git
synced 2026-09-19 03:34:09 +08:00
guohua.lu
58 lines
3.3 KiB
Markdown
58 lines
3.3 KiB
Markdown
---
|
||
title: 解析请求包
|
||
id: how-to-parse-request
|
||
slug: /socket/protocol/request
|
||
sidebar_position: 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` 得到具体的业务数据
|
||
:::
|