QJson相关类和其他容器

g52822828282

821人浏览 · 2025-09-17 09:44:51

g52822828282 · 2025-09-17 09:44:51 发布

QJson

`QJsonValue`

• 是什么：JSON 值的基础单元。一个 `QJsonValue` 对象可以封装 JSON 支持的任何一种数据类型：`null`, `bool`, `double`, `string`, `array`, `object`。

• 常用函数：

• 构造函数：`QJsonValue(bool b)`, `QJsonValue(double n)`, `QJsonValue(const QString &s)`, `QJsonValue(const QJsonArray &a)`, `QJsonValue(const QJsonObject &o)`。

• 类型判断：`isBool()`, `isDouble()`, `isString()`, `isArray()`, `isObject()`, `isNull()`, `isUndefined()`。

• 类型转换/获取值：`toBool()`, `toDouble()`, `toString()`, `toArray()`, `toObject()`。

• 注意：在转换前最好先用 `is...()` 函数判断类型，否则可能得到默认值（如 `false`, `0`, 空字符串等）。

`QJsonObject`

• 是什么：表示一个 JSON 对象（`{ "key": value, ... }`）。它是一个键值对的集合，其中键（key）是 `QString`，值（value）是 `QJsonValue`。本质上非常像一个 `QMap＜QString, QJsonValue＞`。

• 常用函数：

• 插入/修改：`insert(const QString &key, const QJsonValue &value)` 或使用 `operator[]`，例如 `jsonObject["name"] = "Alice";`。

• 获取值：`value(const QString &key)` 或 `operator[]`。`value()` 函数更安全，如果键不存在，会返回一个 `Undefined` 类型的 `QJsonValue`。

• 检查键是否存在：`contains(const QString &key)`。 • 获取所有键：`keys()`，返回一个 `QStringList`。

• 获取大小：`size()` 或 `count()`。

• 移除键值对：`remove(const QString &key)`。

`QJsonArray`

• 是什么：表示一个 JSON 数组（`[ value1, value2, ... ]`）。它是一个 `QJsonValue` 的有序列表，非常像 `QList＜QJsonValue＞`。

• 常用函数：

• 添加元素：`append(const QJsonValue &value)` 或 `push_back()`。 • 插入元素：`insert(int i, const QJsonValue &value)`。

• 获取元素：`at(int i)` 或 `operator[]`。

• 获取大小：`size()` 或 `count()`。

• 移除元素：`removeAt(int i)`。

• 遍历：可以使用 C++11 的 range-based for循环 (`for (const QJsonValue &val : jsonArray)`）或传统的索引循环。

`QJsonDocument`

• 是什么：JSON 文档的容器。一个完整的、有效的JSON文本要么是一个对象，要么是一个数组。`QJsonDocument` 就是用来包装这个顶层对象或数组，并负责与外部世界（如 `QString` 或 `QByteArray`）进行转换。

• 常用函数：

• 从JSON文本创建 (解析): • `static QJsonDocument fromJson(const QByteArray &json, QJsonParseError *error = nullptr)`。这是最常用的解析函数。传入包含JSON文本的字节数组，如果解析出错，错误信息会存入 `error` 对象。

• `static QJsonDocument fromVariant(const QVariant &variant)`：从 `QVariantMap` 或 `QVariantList` 创建。

• 生成JSON文本:

• `QByteArray toJson(JsonFormat format = Indented) const`。将文档转换为字节数组。`format` 可以是 `Indented` (带缩进，易读) 或 `Compact` (无空格，节省空间)。

• 获取顶层元素：

• `isObject()` / `isArray()`：判断顶层元素是对象还是数组。

• `object()`：如果顶层是对象，返回 `QJsonObject`。

• `array()`：如果顶层是数组，返回 `QJsonArray`。

• 设置顶层元素：

• `setObject(const QJsonObject &object)`。

• `setArray(const QJsonArray &array)`。

QVariantMap` 是什么：

`QVariantMap` 是 `QMap＜QString, QVariant＞` 的一个 `typedef`（类型别名）。它是一个键为 `QString`、值为 `QVariant` 的映射。

`QVariant` 是一个可以存储多种 Qt 数据类型的联合体类（如 `int`, `QString`, `QColor`, `QList` 等）。

• 与 `QJsonObject` 的区别与联系：

• `QJsonObject` 的值必须是 `QJsonValue`，其类型范围严格受限于 JSON 标准。

• `QVariantMap` 的值是 `QVariant`，可以存储任何 Qt 已知的数据类型，范围远大于 JSON。

• 转换：由于结构上的相似性，Qt 提供了非常方便的转换方法。

• `QVariantMap` -> `QJsonObject`:

QVariantMap map;
map["name"] = "Bob";
map["age"] = 30;

QJsonObject jsonObj = QJsonObject::fromVariantMap(map);

• `QJsonObject` -> `QVariantMap`:

QJsonObject jsonObj; // 假设已有数据
QVariantMap map = jsonObj.toVariantMap();

• `QVariantList` -> `QJsonArray`:

`QVariantList` (`QList＜QVariant＞`) 也可以轻松转换为 `QJsonArray`。

QVariantList list;
list.append(1);
list.append("apple");
QJsonArray jsonArr = QJsonArray::fromVariantList(list);

QVariantList newList = jsonArr.toVariantList();

为什么需要这种转换？在很多 Qt 应用中，数据模型可能使用 `QVariantMap` 和 `QVariantList` 来存储，因为它们更通用。当需要将这些数据序列化为 JSON 字符串，就可以先将它们转换为 `QJsonObject` / `QJsonArray`，然后再用 `QJsonDocument` 生成字符串。反之亦然。