Qt中的JSON操作_2: JSON在Qt中的使用（QJsonValue数据类型包装与转换、QJsonObject 封装对象、QJsonArray封装数组、QJsonDocument转换字符串）

接上篇：Qt中的JSON操作_1: JSON的基本知识介绍，本篇介绍JSON在Qt中封装的类及其使用方法。

Json 类	介绍
QJsonDocument	它封装了一个完整的 JSON 文档，并且可以从 UTF-8 编码的基于文本的表示以及 Qt 自己的二进制格式读取和写入该文档。
QJsonArray	JSON 数组是一个值列表。可以通过从数组中插入和删除 QJsonValue 来操作该列表。
QJsonObject	JSON 对象是键值对的列表，其中键是唯一的字符串，值由 QJsonValue 表示。
QJsonValue	该类封装了 JSON 支持的数据类型。

QJsonDocument的作用：
上文知JSON一共有两种格式，即JSON数组和JSON对象，它们最终要利用JSON完成序列化，将数据转换为对应的字符串，或者有另外一种情况是字符串转换为JSON数组和JSON对象。QJsonDocument就起到了转换器的作用，是转换的纽带。其过程如下图所示

QJsonArray的作用： 封装了Json里的数组。
QJsonObject的作用： 封装了Json里的对象。
QJsonValue的作用： 是对前面调到的数据类型的包装，C++中针对不同的数据类型有不同的声明，QJsonValue类是利用构造函数将各种数据类型进行了统一化，包装成一种类型，操作更为简单。

（1）各种类型可以通过 QJsonValue 的构造函数被封装为一个类对象:

查看其帮助文档可以看到，通过不同的重载构造函数，将不同的数据类型，构造成为统一的数据类型，相当于将其放到了一个箱子里，实现了数据类型的统一。

（2）如果我们得到一个 QJsonValue 对象，如何判断内部封装的到底是什么类型的数据呢？
这时候就需要调用相关的判断函数了，具体如下：

// 是否是Json数组
bool isArray() const;
// 是否是Json对象
bool isObject() const;
// 是否是布尔类型
bool isBool() const;
// 是否是浮点类型(整形也是通过该函数判断)
bool isDouble() const;
// 是否是空值类型
bool isNull() const;
// 是否是字符串类型
bool isString() const;
// 是否是未定义类型(无法识别的类型)
bool isUndefined() const;

（3）通过判断函数得到对象内部数据的实际类型之后，如果有需求就可以再次将其转换为对应的基础数据类型。
对应的 API 函数如下：

// 转换为Json数组
QJsonArray toArray(const QJsonArray &defaultValue) const;
QJsonArray toArray() const;
// 转换为布尔类型
bool toBool(bool defaultValue = false) const;
// 转换为浮点类型
double toDouble(double defaultValue = 0) const;
// 转换为整形
int toInt(int defaultValue = 0) const;
// 转换为Json对象
QJsonObject toObject(const QJsonObject &defaultValue) const;
QJsonObject toObject() const;
// 转换为字符串类型
QString toString() const;
QString toString(const QString &defaultValue) const;

通过上述三种函数可以方便的将数据打包为QJsonValue类型，后利用is方法判定数据类型，最后利用to方法转换为原始数据。

（1）如何创建空的 Json 对象，里面不包含任何的键值对

QJsonObject::QJsonObject();	// 构造空对象

（2）将键值对添加到空对象中（key和value是成对出现组成元素的，排列顺序按照键值的大小升序排列）

iterator QJsonObject::insert(const QString &key, const QJsonValue &value);

（3）获取对象中键值对个数

int QJsonObject::count() const;
int QJsonObject::size() const;
int QJsonObject::length() const;

（4）通过 key 得到 value

//通过Key值去取值
QJsonValue QJsonObject::value(const QString &key) const;    // utf8
QJsonValue QJsonObject::value(QLatin1String key) const;	    // 字符串不支持中文
//通过重载[]操作符 只需要在[]中写入字符串类型的key值
QJsonValue QJsonObject::operator[](const QString &key) const;
QJsonValue QJsonObject::operator[](QLatin1String key) const;

（5）删除键值对，通过Key值去查找，删除整个键值对

void QJsonObject::remove(const QString &key); //没有返回值
QJsonValue QJsonObject::take(const QString &key);	// 返回key对应的value值

（6）通过 key 进行查找

iterator QJsonObject::find(const QString &key); //得到的是迭代器类型的数据块，使用与指针类似
bool QJsonObject::contains(const QString &key) const; //返回是否存在

（7）遍历，方式有三种：

• 使用相关的迭代器函数
• 使用 [] 的方式遍历，类似于遍历数组，[] 中是键值
• 先得到对象中所有的键值，在遍历键值列表，通过 key 得到 value 值

QStringList QJsonObject::keys() const;  
//(1)得到当前Json对象里所有的key值，返回key值字符串的集合
//(2)得到key值就可以对字符串数组进行遍历，依次取出Key
//(3)通过Key值取出value，再进行数据转换就可以得到原始数据

(1)创建空的 Json 数组

QJsonArray::QJsonArray();

(2)添加数据

void QJsonArray::append(const QJsonValue &value);	// 在尾部追加
void QJsonArray::insert(int i, const QJsonValue &value); // 插入到 i 的位置之前
//放到迭代器对应位置的前边
iterator QJsonArray::insert(iterator before, const QJsonValue &value); 
void QJsonArray::prepend(const QJsonValue &value); // 添加到数组头部
void QJsonArray::push_back(const QJsonValue &value); // 添加到尾部
void QJsonArray::push_front(const QJsonValue &value); // 添加到头部

(3)计算数组元素的个数

int QJsonArray::count() const;
int QJsonArray::size() const;

(4)从数组中取出某一个元素的值

QJsonValue QJsonArray::at(int i) const;
QJsonValue QJsonArray::first() const; // 头部元素
QJsonValue QJsonArray::last() const; // 尾部元素
QJsonValueRef QJsonArray::operator[](int i); //通过[]得到位置元素的引用

(5)从数组中取出某一个元素的值

QJsonValue QJsonArray::at(int i) const;
QJsonValue QJsonArray::first() const; // 头部元素
QJsonValue QJsonArray::last() const; // 尾部元素
QJsonValueRef QJsonArray::operator[](int i);

(6)删除数组中的某一个元素

iterator QJsonArray::erase(iterator it);    // 基于迭代器删除
void QJsonArray::pop_back();           // 删除尾部
void QJsonArray::pop_front();          // 删除头部
void QJsonArray::removeAt(int i);      // 删除i位置的元素
void QJsonArray::removeFirst();        // 删除头部
void QJsonArray::removeLast();         // 删除尾部
QJsonValue QJsonArray::takeAt(int i);  // 删除i位置的原始, 并返回删除的元素的值

(7)Josn 数组的遍历，常用的方式有两种：

• 可以使用迭代器进行遍历（和使用迭代器遍历 STL 容器一样）
• 可以使用数组的方式遍历（for循环）

(1) QJsonObject 或者 QJsonArray --> 字符串（序列化）
1）创建 QJsonDocument 对象

QJsonDocument::QJsonDocument(const QJsonObject &object);
QJsonDocument::QJsonDocument(const QJsonArray &array);

可以看出，通过构造函数就可以将实例化之后的 **QJsonObject 或者 QJsonArray ** 转换为 QJsonDocument 对象了。

2）将文件对象中的数据进行序列化

// 二进制格式的json字符串
QByteArray QJsonDocument::toBinaryData() const;	 
// 文本格式
QByteArray QJsonDocument::toJson(JsonFormat format = Indented) const;	

通过调用 toxxx() 方法就可以得到文本格式或者二进制格式的 Json 字符串了

3）使用得到的字符串进行数据传输，或者磁盘文件持久化

(2) 字符串 -->QJsonObject 或者 QJsonArray
一般情况下，通过网络通信或者读磁盘文件就会得到一个 Json 格式的字符串，如果想要得到相关的原始数据就需要对字符串中的数据进行解析，具体解析流程如下：
1）将得到的 Json 格式字符串通过 QJsonDocument 类的静态函数转换为 QJsonDocument 类对象

[static] QJsonDocument QJsonDocument::fromBinaryData(const QByteArray &data, DataValidation validation = Validate);
// 参数文件格式的json字符串
[static] QJsonDocument QJsonDocument::fromJson(const QByteArray &json, QJsonParseError *error = Q_NULLPTR);

2）将文档对象转换为 json 数组 / 对象

// 判断文档对象中存储的数据是不是数组
bool QJsonDocument::isArray() const;
// 判断文档对象中存储的数据是不是json对象
bool QJsonDocument::isObject() const
    
// 文档对象中的数据转换为json对象
QJsonObject QJsonDocument::object() const;
// 文档对象中的数据转换为json数组
QJsonArray QJsonDocument::array() const;

3）通过调用 QJsonArray , QJsonObject 类提供的 API 读出存储在对象中的数据。

关于 Qt 中 Json 数据对象以及字符串之间的转换的操作流程是固定的，我们在编码过程中只需要按照上述模板处理即可，相关的操作是没有太多的技术含量可言的。

声明： 本篇是在以下视频及链接基础上学习并稍微做了补充，感谢原博主！
学习视频地址：Json简介学习视频
学习笔记网址：笔记网址