一種基于QT應(yīng)用程序封裝JsonRpc2.0協(xié)議請求對象的便捷方法

來源 | 嵌入式應(yīng)用研究院

之前一直用的是cJSON庫來封裝和解析，寫久了感覺實在太丑，又難維護，于是還是研究下QT原生的QJson是否有更優(yōu)雅的方法來封裝一些Json對象，果不其然，通過閱讀QT開發(fā)文檔發(fā)現(xiàn)，QT封裝的Json非常強大，其中Json對象可以有很多種形式，我們看到qjsonobject.h中：

template?<class?Key,?class?T>?class?QMap;
typedef?QMap<QString,?QVariant>?QVariantMap;
template?<class?Key,?class?T>?class?QHash;
typedef?QHash<QString,?QVariant>?QVariantHash;

基于模板創(chuàng)建了QMap和QHash兩種容器類型，我們先來介紹QMap和QVariantMap的應(yīng)用，在介紹QVariantMap的應(yīng)用之前，先來了解QMap以及QVariant。

1、QMap

QMap是Qt庫中的一個關(guān)聯(lián)容器，它存儲鍵值對，其中每個鍵都是唯一的。這使得你可以通過鍵值來快速查找或訪問存儲在QMap中的值。

以下是一些QMap的基本操作：

插入：使用insert()函數(shù)將一個鍵值對插入到QMap中。獲取值：使用value()函數(shù)通過鍵來獲取值。查找：使用find()函數(shù)查找具有給定鍵的鍵值對。刪除：使用remove()函數(shù)刪除具有給定鍵的鍵值對。遍歷：使用iterator（如QMapIterator或constIterator）遍歷QMap中的所有鍵值對。

下面是一個簡單的QMap使用例子：

#include?<QCoreApplication>
#include?<QDebug>
#include?<QMap>

int?main(int?argc,?char?*argv[])
{
????QMap<QString,?int>?map;
????map.insert("One",?1);
????map.insert("Two",?2);
????map.insert("Three",?3);

????//?使用value()函數(shù)獲取值
????int?one?=?map.value("One");
????qDebug()?<<?"one:"?<<?one;

????//?使用constIterator遍歷QMap
????QMap<QString,?int>::const_iterator?i;
????for?(i?=?map.constBegin();?i?!=?map.constEnd();?++i)?{
????????qDebug()?<<?"Key:?"?<<?i.key()?<<?",?Value:?"?<<?i.value();
????}

????return?0;
}

運行結(jié)果：注意，QMap不保證同義詞的插入順序，即如果插入相同的鍵，第二個插入的鍵值對將出現(xiàn)在QMap的末尾。如果需要保持插入順序，可以使用QMap<QString,QList>，其中QList存儲與該鍵關(guān)聯(lián)的值。

2、QVariant

QVariant是一個可以存儲多種數(shù)據(jù)類型的類，它可以方便地在不同的函數(shù)、類、模塊之間傳遞數(shù)據(jù)。QVariant的用法非常簡單，只需要使用構(gòu)造函數(shù)、賦值操作符、setValue函數(shù)等方法將數(shù)據(jù)存儲到QVariant對象中，然后使用toXXX函數(shù)將QVariant對象轉(zhuǎn)換為指定類型的數(shù)據(jù)。例如：

#include?<QCoreApplication>
#include?<QDebug>
#include?<QVariant>
#include?<QDateTime>

int?main(int?argc,?char?*argv[])
{
????QCoreApplication?a(argc,?argv);

????//?存儲數(shù)據(jù)
????QVariant?v1?=?10;?//?存儲整數(shù)
????QVariant?v2?=?"hello";?//?存儲字符串
????QVariant?v3?=?QDateTime::currentDateTime();?//?存儲日期時間

????//?獲取數(shù)據(jù)
????int?i?=?v1.toInt();?//?將?QVariant?轉(zhuǎn)換為整數(shù)
????QString?s?=?v2.toString();?//?將?QVariant?轉(zhuǎn)換為字符串
????QDateTime?dt?=?v3.toDateTime();?//?將?QVariant?轉(zhuǎn)換為日期時間

????//?輸出數(shù)據(jù)
????qDebug()?<<?"v1?=?"?<<?i;
????qDebug()?<<?"v2?=?"?<<?s;
????qDebug()?<<?"v3?=?"?<<?dt;

????return?a.exec();
}

運行結(jié)果：

3、QVariantMap

QT的開發(fā)者基于QMap及QVariant的優(yōu)點，于是開發(fā)衍生出了QVariantMap。QVariantMap是一個Qt提供的容器類，它可以存儲一組鍵值對，其中鍵是QString類型，值是QVariant類型。QVariant是一個可以存儲多種數(shù)據(jù)類型的類，包括基本類型、Qt類型和自定義類型。QVariantMap的優(yōu)點是可以方便地使用字符串作為鍵來訪問或修改值，而不需要像QMap那樣指定鍵的類型。QVariantMap的缺點是它不能保證鍵的順序，也不能存儲重復(fù)的鍵。它也有很多應(yīng)用場景，例如：

在QML中，可以使用QVariantMap作為C++和JavaScript之間的數(shù)據(jù)交換格式，因為它可以自動轉(zhuǎn)換為JavaScript對象。在Qt中，可以使用QVariantMap作為JSON對象的表示方式，因為它可以方便地使用QJsonDocument和QJsonObject進行互相轉(zhuǎn)換。在Qt中，可以使用QVariantMap作為數(shù)據(jù)庫查詢的結(jié)果集，因為它可以方便地使用QSqlQuery和QSqlRecord進行互相轉(zhuǎn)換。在Qt中，可以使用QVariantMap作為配置文件的存儲格式，因為它可以方便地使用QSettings進行讀寫。

QVariantMap在Json對象轉(zhuǎn)換之間的應(yīng)用，例如，有一個JsonRpc2.0的請求對象:

?{
????jsonrpc:?"2.0",
????id:?1,
????method:?"Set/LedStatus",
????params:?{
????????"color":?"blue",
????????"status":?"on"
????}
?}

編寫一個程序封裝一個基于JsonRpc2.0的請求對象的方法：

QByteArray?JsonRpc2ProcotolPacket(int?Id,?QString?Method,?const?QVariantMap?&_Params)
{
????QJsonObject?RootObject;
????QJsonObject?Params?=?QVariant(_Params).toJsonObject();
????RootObject.insert("jsonrpc",?"2.0");
????RootObject.insert("id",?Id);
????RootObject.insert("method",?Method);
????RootObject.insert("params",?Params);
????QJsonDocument?JsonDoc(RootObject);
????return?JsonDoc.toJson();
}

應(yīng)用主程序調(diào)用:

#include?<QDebug>
#include?<QJsonArray>
#include?<QJsonObject>
#include?<QJsonDocument>
#include?<QCoreApplication>

/*
?*?Rpc結(jié)構(gòu)
?{
????jsonrpc:?"2.0",
????id:?1,
????method:?"Set/LedStatus",
????params:?{
????????"color":?"blue",
????????"status":?"on"
????}
?}
*/

QByteArray?JsonRpc2ProcotolPacket(int?Id,?QString?Method,?const?QVariantMap?&_Params)
{
????QJsonObject?RootObject;
????QJsonObject?Params?=?QVariant(_Params).toJsonObject();
????RootObject.insert("jsonrpc",?"2.0");
????RootObject.insert("id",?Id);
????RootObject.insert("method",?Method);
????RootObject.insert("params",?Params);
????QJsonDocument?JsonDoc(RootObject);
????return?JsonDoc.toJson();
}

int?main(int?argc,?char?*argv[])
{
????QCoreApplication?a(argc,?argv);
????//使用QVariantMap封裝參數(shù)對象部分的數(shù)據(jù)結(jié)構(gòu)
????const?QVariantMap?&ParamsObject?=?{
????????????{"color",?"blue"},
????????????{"status",?"on"}
????????};
????QByteArray?JsonStr?=?JsonRpc2ProcotolPacket(15,?"Set/LedStatus",?ParamsObject);
????qDebug()?<<?JsonStr;
????return?a.exec();
}

運行結(jié)果：

用起來簡直不要太爽！