Qt QJsonDocument以及与QJsonArray、QJsonObject、QJsonValue的关联

0、说明

　　QJsonDocument类提供了read/write JSON文档的方法。

　　用QJsonDocument::fromJson()方法，可以从将一个JSON文件（或者QByteArray数据）转换为QJsonDocument，用QJsonDocument::toJson()则能起到相反的用法。在此过程中的语法解析是很高效的，并且可以将JSON转换为Qt使用的二进制数据。

　　可以用 !isNull()来知晓被解析文档的合法性；用isArray()、isObject()来检查这个Doc是否包含一个Array或Object。如果要提取这些Array与Object，可以通过调用array()、object()来实现，之后就能对Array、Object进行相关操作。

　　一个Doc也可以从一个二进制数据中提取，使用fromBinaryData()、fromRawData()。

1、模块和加载项

2、构造

3、静态字段

    {
        "Array": [
            true,
            999,
            "string"
        ],
        "Key": "Value",
        "null": null
    }

    {"Array":[true,999,"string"],"Key":"Value","null":null}

4、静态方法

5、实例方法

6、应用

1）从一个QJsonObject格式的QByteArray中，读取某个字段的数据（该数据是一个List），存入某个自定义类中：QByteArray → QJsonDocument → QJsonArray → class

有一个QByteArray，类似下边这种格式：

{"status":0,"result":[{"x":20.0,"y":120.0},{"x":30.0,"y":121.0}]}

要求

读取result字段值，得到一个QJsonArray，该array的每一项都是一个QJsonValue，提取每一项的x、y字段，存入一个QJsonObject对象中，再把所有这些QJsonObject，加上一个ID项，存入一个QJsonArray中：

①QByteArray → QJsonDocument：QJsonDocument::fromJson( QByteArray )

QJsonDocument doc = QJsonDocument::fromJson(data);//data就是上文的QByteArray

②QJsonDocument → QJsonArray（result字段对应的值是一个List）：QJsonDocument.[Key].toArray()

QJsonArray resultArray = doc["result"].toArray();

③提取Array中的每一项中的x、y，存入相同数量的QJsonObject中，并为每个QJsonObject都添加一个ID字段；这些QJsonObject在生成后就加入到一个QJsonArray中

 1 QJsonArray newArray={};
 2 for(int i=0;i<resultArray.size();i++){　　 //Array中的每一项都是一个QJsonValue，可以用toT()方法把它转化为对应的类型
 3     //由于这里是K-V类型，所以要提取其中的K和V，只能先转化为QJsonObject
 4     QJsonObject jobj = resultArray[i].toObject();
 5     double x = jobj["x"].toDouble();
 6     double y = jobj["y"].toDouble();
 7     int id = i;
 8 
 9     //用字段构建QJsonObject
10     QJsonObject obj;
11     obj.insert("X",x);
12     obj.insert("Y",y);
13     obj.insert("ID",id);
14     //把QJsonObject放入QJsonArray中
15     newArray.append(obj);
16 }

2）x,y → QJsonObject → QJsonArray(以QJsonObject为元素) → QJsonDocument → Json文件

说明：有一系列的x,y，每对x,y是一个QJsonObject的属性，用这些x,y构造QJsonObject；

再把这些QJsonObject作为QJsonArray的元素存入QJsonArray中；

将这个QJsonArray存入QJsonDocument中；

最后用Json文件保存这个QJsonDocument。

①x,y → QJsonObject：

1 QJsonObject obj;
2 obj.insert("x",x);
3 obj.insert("y",y);

②QJsonObject存入QJsonArray中，作为Array的一个元素：

1 QJsonArray newArray={};
2 
3 //之前的obj语句
4 ...
5 
6 newArray.append(obj);

③QJsonArray → QJsonDocument：

QJsonDocument jsonDoc(newArray);

④QJsonDocument → Json文档：

1 　　QFile file("C:\\Users\\Le\\Desktop\\stationavg.json");
2     if(!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
3         qDebug()<<"File open error!";
4         return 0;
5     }
6     file.write(jsonDoc.toJson());
7     file.flush();
8     file.close();

3)有两个List，将它们存入同一个json文件中：2个List → 2个QJsonArray → QJsonObject的两项 → QJsonDocument → json文件

①List → QJsonArray

1     //直接用List作为参数构造QJsonArray即可
2     QJsonArray sedId = {7,8,9,11,12,13,14,15,17,...,95,98,101,102};
3     QJsonArray numberTransfer={-1,-1,-1,-1,43,30,26,29,...,4,-1,-1,61,54};

②QJsonArray → QJsonObject的一项

1     //每个Array作为QJsonObject的一项，一共两项
2     QJsonObject obj;
3     obj.insert("totalstation",sedId);
4     obj.insert("numbertransfer",numberTransfer);

③QJsonObject → QJsonDocument

QJsonDocument doc = QJsonDocument(obj);

④QJsonDocument → json文件

1 　　QFile file("C:\\Users\\Administrator\\Desktop\\totalstation.json");
2     if(!file.open(QIODevice::WriteOnly | QIODevice::Text)){
3         qDebug()<<"文件打开错误";
4         return 0;
5     }
6     file.write(doc.toJson(QJsonDocument::Compact));//设置数据组织形式
7     file.flush();
8     file.close();

4）反向执行3）中的步骤，由一个json文件得到两个QList：json文档 → QJsonDoc → QJsonObject → 两个QJsonArray → 两个QList<int>

①json文档 → QJsonDocument

 1 　　QFile file("C:\\Users\\Le\\Desktop\\totalstation.json");
 2     if(!file.open(QIODevice::ReadOnly | QIODevice::Text)){
 3         qDebug()<<"文件打开错误";
 4         return 0;
 5     }
 6 
 7     QJsonParseError * error = nullptr;
 8     QJsonDocument doc = QJsonDocument::fromJson(file.readAll(),error);
 9     if(error){
10         qDebug()<<"json error";
11         return 0;
12     }
13     file.close();

②QJsonDocument → QJsonObject

QJsonObject obj = doc.object();

③QJsonObject → 两个QJsonArray

1     QJsonArray sedId_JA = obj["totalstation"].toArray();
2     QJsonArray numberTransfer_JA = obj["numbertransfer"].toArray();

之所以要用toArray()，是因为直接用obj['key']提取到的是QJsonValue类型

④QJsonArray → QList

这里同样也需要用toInt()，因为QJsonArray中存储的也是QJsonValue类型

1 　　QList<int> sedId={};
2     QList<int> numberTransfer={};
3 
4     foreach(QJsonValue v,sedId_JA){
5         sedId<<v.toInt();
6     }
7     foreach(QJsonValue v,numberTransfer_JA){
8         numberTransfer<<v.toInt();
9     }

7、QJsonArray、QJsonObject、QJsonValue、QJsonDocument之间的关系

①QJsonDocument

QJsonDocument是与Json文档/QByteArray最接近的类，由于它继承自QIODevice，所以可以用QIODevice提供的一系列读写接口函数进行Json读写。

一个QJsonDocument中只能包含一个Object或Array，可以用isArray()、isObject()来检查。检查完成后，可以用array()、object()将该QJsonDocument转换为QJsonArray或QJsonObject。

Object是指，Doc中存储了一系列的K-V对；

Array是指，Doc中存储了一个List。

方法

1）QByteArray → QJsonDocument：QJsonDocument::fromJson(QByteArray)

QJsonDocument → QByteArray：QJsonDocument::toJson()

2）QJsonDucument → QJsonArray ：array()

3）QJsonDocument → QJsonObject：object()

4）为某个空Doc，填充Array数据：setArray( QJsonArray )

5）为某个空Doc，填充Object数据：setObject( QJsonObject )

②QJsonObject

一个QJsonObject从逻辑上看就是一个Map或Dict，其中存储了许多K-V对。

用size()可以知道K-V对的数量，由此可以循环访问每个K-V对。

用 [ key ]或value( key )方法提取key对应的value，这里的Value就是QJsonValue。

③QJsonArray

一个QJsonArray从逻辑上看就是一个List，实际上它与QList的用法基本相同，只是其中存储的数据都是QJsonValue。

用size()可以知道List的大小，由此可以循环访问每个元素。

用[ i ]或at( i )方法提取指定位置处的元素，这里的元素就是QJsonValue类型。

④QJsonValue

QJsonValue与我们常见的那些变量没什么不同，它只是作为QJsonObject和QJsonArray的基本元素而已，可以用toT()将一个QJsonValue转换为指定基本类型。

如果QJsonValue本身格式就是一个Map，其中存放了若干K-V对，那么可以通过toObject()把它转化为专门存放K-V对的类型——QJsonObject。

如果QJsonValue本身格式就是一个List，其中存放了若干元素，那么可以通过toArray()把它转化为逻辑上的List类型——QJsonArray。

本栏目推荐文章
• 50个常用的Qt开源库
• Qt/C++编写视频监控系统83-自定义悬浮条信息
• QT开发 2024最新版本优雅的使用vscode开发QT
• Qt中的QImage类和OpenCV中的cv::Mat类之间的相互转换
• 【C++/Qt】lambda表达式的简单应用
• socket（二）使用QT实现简单连接
• FramelessWindow实现qt无边框窗口
• QT开发 QT5.15.2安装(换源极速安装)
• 【C++/Qt】QLCDNumber-电子时钟实战
• Qt源码分析

QJsonDocument QJsonObject QJsonArray QJsonValue Qtqjsondocument qjsonobject qjsonarray qjsonvalue qjsonvalue qt qjsonobject qjsonvalue qjsonobject incomplete variable typte qjsondocument qjsonarray qt qt5 qt6