桌面应用 / 系统课时
解析 JSON 对象和数组
解析 JSON 对象和数组
本篇学习如何在 Qt 6 中解析网络接口返回的 JSON 数据。通过 QJsonDocument、QJsonObject 和 QJsonArray,可以将文本格式的响应转换为可访问的数据结构,并安全读取对象字段和数组元素。
学习目标
- 理解 Qt JSON 类之间的关系和解析流程
- 掌握使用 QJsonDocument 解析对象与数组数据
- 能够处理接口返回中的字段读取和类型转换
使用 Qt JSON 类处理接口响应
网络接口通常返回 JSON 文本,例如用户信息、商品列表或配置数据。Qt 不直接通过字符串操作 JSON,而是提供了一组专用类处理结构化数据。
常用类型之间的关系如下:
| 类型 | 作用 |
|---|---|
| QJsonDocument | JSON 文档入口,负责文本与 JSON 结构转换 |
| QJsonObject | 表示 JSON 对象,访问键值对 |
| QJsonArray | 表示 JSON 数组,访问有序元素 |
| QJsonValue | 表示单个 JSON 值 |
解析流程通常是先使用 QJsonDocument::fromJson() 将响应文本转换为文档,再根据根节点类型获取对象或数组。
解析 JSON 对象数据
接口返回对象时,最外层通常使用花括号,例如:
{
"id": 1001,
"name": "Qt User",
"active": true
}可以通过 QJsonObject 按字段名称读取数据。
#include <QCoreApplication>
#include <QJsonDocument>
#include <QJsonObject>
#include <QDebug>
int main(int argc, char *argv[])
{
QCoreApplication app(argc, argv);
QByteArray jsonData = R"({"id":1001,"name":"Qt User","active":true})";
QJsonDocument document = QJsonDocument::fromJson(jsonData);
QJsonObject object = document.object();
int id = object.value("id").toInt();
QString name = object.value("name").toString();
bool active = object.value("active").toBool();
qDebug() << id << name << active;
return 0;
}预期输出
1001 "Qt User" true读取字段时,应根据实际 JSON 类型调用对应转换方法,例如数字使用 toInt(),字符串使用 toString()。如果字段不存在,QJsonValue 会返回空值,需要根据业务决定是否使用默认值。
解析 JSON 数组数据
接口返回列表数据时,根节点通常是数组,例如:
[
{"id":1,"name":"A"},
{"id":2,"name":"B"}
]此时需要先通过 QJsonDocument 获取 QJsonArray,再遍历每个元素。
QJsonArray array = document.array();
for (const QJsonValue &value : array) {
QJsonObject item = value.toObject();
qDebug() << item.value("id").toInt()
<< item.value("name").toString();
}预期输出
1 "A"
2 "B"数组中的元素类型可能不同,实际开发中应先判断 QJsonValue 的类型,再进行转换,避免因为格式变化导致读取异常。
处理嵌套 JSON 结构
真实接口经常同时包含对象和数组,例如用户对象中包含订单列表:
{
"user":"Tom",
"orders":[
{"id":1},
{"id":2}
]
}解析时需要逐层进入对应结构:先获取对象,再读取数组字段,最后处理数组元素。
在 Qt 项目中,JSON 解析代码通常放在网络请求完成回调中。解析前应检查 JSON 文档是否有效,例如判断 fromJson() 返回的错误信息,避免接口返回 HTML 或错误文本时产生误判。
选择对象还是数组的判断方式
当接口格式不固定时,可以先判断文档根节点类型:
if (document.isObject()) {
QJsonObject object = document.object();
qDebug() << "object response";
} else if (document.isArray()) {
QJsonArray array = document.array();
qDebug() << "array response";
}预期结果
根据接口返回格式输出 object response 或 array response掌握对象和数组解析后,网络层返回的数据就可以转换为 Qt 程序中的业务模型。后续开发中应结合接口文档固定字段约束,并对缺失字段和类型变化做好兼容处理。