Json与Tcp帧之间的转换

JSON 与 TCP 帧之间的转换**,本质上就是应用层协议的封装(Encoding)(Decoding)。**

很多机器人 SDK、后端服务器、物联网设备都会做这一层。下面以一个完整流程说明。

一、为什么需要转换?

JSON 只是一个字符串,例如:

{

"seq": 1,

"command": "move",

"speed": 0.5

}

但是 TCP 并不知道哪里是一条完整消息。

TCP 是字节流协议(Stream):

发送:

JSON1

JSON2

JSON3

↓

TCP

↓

接收:

JSON1JSON2JSON3

或者:

JSON1

↓

TCP

↓

第一次收到:

{

"seq"

第二次收到:

":1,"command"

第三次收到:

":"move"...}

也就是说:

TCP 不保证一次 send() 对应一次 recv()。

所以必须自己定义"一帧(Frame)"。

二、什么叫 TCP 帧(Frame)

帧就是:

一条完整消息的数据格式。

例如:

+----------------+

| Frame 1 |

+----------------+

| Frame 2 |

+----------------+

| Frame 3 |

+----------------+

TCP 负责运输。

帧由应用层定义。

三、最常见的两种封包方式

方法一:长度字段(最常见)

很多 SDK 都采用这种方式。

例如:

长度(4字节)

JSON数据

假设 JSON:

复制代码
{"cmd":"move"}

长度:

14

发送:

+------------+-------------------+

| 00 00 00 0E| {"cmd":"move"} |

+------------+-------------------+

服务器收到:

先读4字节

↓

知道后面还有14字节

↓

继续读取14字节

↓

解析JSON

整个过程如下:

JSON

↓

计算长度

↓

前面加4字节长度

↓

TCP发送

接收:

TCP

↓

读取长度

↓

读取正文

↓

JSON

↓

QJsonDocument::fromJson()

方法二:分隔符

例如:

{"cmd":"move"}\n

发送:

{"cmd":"move"}\n

{"cmd":"stop"}\n

{"cmd":"left"}\n

服务器一直读:

buffer += socket.readAll();

当发现:

\n

说明:

一条消息结束。

于是:

取出

↓

{"cmd":"move"}

↓

解析JSON

四、JSON → TCP 帧(编码)

假设:

cpp 复制代码
QJsonObject obj;
obj["seq"] = 1;
obj["command"] = "move";
obj["speed"] = 0.5;

第一步:

生成 JSON

cpp 复制代码
QByteArray json =
QJsonDocument(obj).toJson(QJsonDocument::Compact);

得到:

cpp 复制代码
{"seq":1,"command":"move","speed":0.5}

第二步:

封装 Frame。

如果使用换行协议:

cpp 复制代码
json.append('\n');

变成:

{"seq":1,"command":"move","speed":0.5}\n

第三步:

发送

cpp 复制代码
socket.write(json);

流程:

QJsonObject

↓

QJsonDocument

↓

QByteArray

↓

追加 '\n'

↓

socket.write()

五、TCP 帧 → JSON(解码)

收到:

{"seq":1,"command":"move","speed":0.5}\n

读取:

cpp 复制代码
buffer += socket.readAll();

寻找:

\n

找到以后:

QString line

↓

{"seq":1,"command":"move","speed":0.5}

然后:

cpp 复制代码
QJsonDocument doc =
QJsonDocument::fromJson(line.toUtf8());

得到:

cpp 复制代码
QJsonObject obj = doc.object();

然后:

cpp 复制代码
obj["command"].toString();

得到:

move

流程:

socket.readAll()

↓

buffer

↓

找到 '\n'

↓

取出一行

↓

QJsonDocument::fromJson()

↓

QJsonObject

↓

command

六、为什么要单独做这一层?

将 JSON 与 TCP 的转换独立出来(例如 Protocol::encode() / Protocol::decode())有几个好处:

职责分离:业务代码只负责构造命令,不需要关心网络传输细节。

易于维护:如果通信协议从"换行分隔"改成"长度前缀",只需要修改协议层,业务层几乎不用改动。

便于测试:协议编码和解码可以独立编写单元测试。

方便扩展:未来可以将 JSON 替换为 Protobuf、MessagePack 等序列化格式,而不影响上层 API。

相关推荐
峥嵘life5 分钟前
Android16 热点「网络共享」开关的设计与实现
服务器·网络·microsoft
15Moonlight37 分钟前
Linux网络(12):Reactor 模式
linux·网络
张小姐的猫1 小时前
【基于 WebSocket 的多用户网页五子棋】—— 整合封装服务器模块设计实现1️⃣
服务器·websocket·网络协议
nice_lcj5201 小时前
【从零理解计算机网络 · 04】TCP 三次握手:为什么恰好是三次
java·后端·tcp/ip·计算机网络·面试·tcp·三次握手
其实防守也摸鱼14 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
优化Henry16 小时前
LTE 站点 S1 链路反复闪断导致小区频闪退服故障排查
运维·网络·学习·信息与通信·tdd
心之王者71616 小时前
Linux 进程信号:从产生、阻塞到捕捉与子进程回收
linux·服务器·网络
.痞老板.16 小时前
java ee--网络编程套接字
网络·java-ee·php
manageengine16 小时前
服务器 CPU 100% 怎么排查:8 条命令从现象定位到根因
运维·服务器·cpu
2401_8685347817 小时前
逻辑网络设计
网络·python