使用 C++ 處理 JSON 數據交換格式
一、摘要
JSON 的全稱為:JavaScript Object Notation,顧名思義,JSON 是用於標記 Javascript 對象的,JSON官方的解釋為:JSON 是一種輕量級的數據傳輸格式。
本文並不詳細介紹 JSON 本身的細節,旨在討論如何使用 C++ 語言來處理 JSON。關於 JSON 更具體的信息,可參見 JSON 官網:http://www.json.org。
二、本文選擇處理 JSON的 C++ 庫
本文選擇一個第三方庫 jsoncpp 來解析 JSON。jsoncpp 是比較出名的 C++ JSON 解析庫。在 JSON官網也是首推的。
下載地址為:http://sourceforge.net/projects/jsoncpp。本文使用的 jsoncpp 版本為:0.5.0。
三、jsoncpp 在 Windows 下的編譯
要使用第三方源碼庫,第一步少不了的就是編譯,將源碼文件編譯成我們方便使用的動態鏈接庫、靜態鏈接庫或者靜態導入庫[1]。
jsconcpp 進行 JSON 解析的源碼文件分布在 include/json、src/lib_json 下。其實 jsoncpp 源碼並不多,為了方便產品管理,此處沒必要將其編譯為動態鏈接庫或者靜態導入庫,所以我們選擇使用靜態鏈接庫[2]。
jsoncpp 已經處理的很完善了,所有編譯選項都已經配置好,打開makefiles/vs71/jsoncpp.sln 便可以開始編譯(默認是使用 VS2003 編譯器的,打開時直接按照 VS2005 提示轉換即可)。
四、jsoncpp 使用詳解
jsoncpp 主要包含三種類型的 class:Value、Reader、Writer。jsoncpp 中所有對象、類名都在namespace Json 中,包含 json.h 即可。
Json::Value 只能處理 ANSI 類型的字符串,如果 C++ 程序是用 Unicode 編碼的,最好加一個 Adapt類來適配。
1、Value
Json::Value 是jsoncpp 中最基本、最重要的類,用於表示各種類型的對象,jsoncpp 支持的對象類型可見 Json::ValueType 枚舉值。
可如下是用 Json::Value 類:
Json::Value json_temp; // 臨時對象,供如下代碼使用
json_temp["name"] = Json::Value("huchao");
json_temp["age"] = Json::Value(26);
Json::Value root; // 表示整個 json 對象
root["key_string"] = Json::Value("value_string"); // 新建一個 Key(名為:key_string),賦予字符串值:"value_string"。
root["key_number"] = Json::Value(12345); // 新建一個 Key(名為:key_number),賦予數值:12345。
root["key_boolean"] = Json::Value(false); // 新建一個 Key(名為:key_boolean),賦予bool值:false。
root["key_double"] = Json::Value(12.345); // 新建一個 Key(名為:key_double),賦予double 值:12.345。
root["key_object"] = Json_temp; // 新建一個 Key(名為:key_object),賦予json::Value 對象值。
root["key_array"].append("array_string"); // 新建一個 Key(名為:key_array),類型為數組,對第一個元素賦值為字符串:"array_string"。
root["key_array"].append(1234); // 為數組 key_array 賦值,對第二個元素賦值為:1234。
Json::ValueType type = root.type(); // 獲得 root 的類型,此處為 objectValue 類型。
注:跟C++ 不同,JavaScript 數組可以為任意類型的值,所以 jsoncpp 也可以。
如上幾個用法已經可以滿足絕大部分 json 應用了,當然 jsoncpp 還有一些其他同能,比如說設置注釋、比較 json 大小、交換 json 對象等,都很容易使用,大家自己嘗試吧。
2、Writer
如上說了 Json::Value 的使用方式,現在到了該查看剛才賦值內容的時候了,查看 json 內容,使用Writer 類即可。
Jsoncpp 的 Json::Writer 類是一個純虛類,並不能直接使用。在此我們使用 Json::Writer 的子類:Json::FastWriter、Json::StyledWriter、Json::StyledStreamWriter。
顧名思義,用 Json::FastWriter 來處理 json 應該是最快的,下面我們來試試。
Json::FastWriter fast_writer;
std::cout << fast_writer.write(root) << std::endl;
輸出結果為:
{"key_array":["array_string",1234],"key_boolean":false,"key_double":12.3450,"key_number":12345,"key_object":{"age":26,"name":"huchao"},"key_string":"value_string"}
再次顧名思義,用 Json::StyledWriter 是格式化後的 json,下面我們來看看 Json::StyledWriter 是怎樣格式化的。
Json::StyledWriter styled_writer;
std::cout << styled_writer.write(root) << std::endl;
輸出結果為:
{
"key_array" : [ "array_string", 1234 ],
"key_boolean" : false,
"key_double" : 12.3450,
"key_number" : 12345,
"key_object" : {
"age" : 26,
"name" : "huchao"
},
"key_string" : "value_string"
}
3、Reader
Json::Reader 是用於讀取的,說的確切點,是用於將字符串轉換為 Json::Value 對象的,下面我們來看個簡單的例子。
Json::Reader reader;
Json::Value json_object;
const char* json_document = "{/"age/" : 26,/"name/" : /"huchao/"}";
if (!reader.parse(json_document, json_object))
return 0;
std::cout << json_object["name"] << std::endl;
std::cout << json_object["age"] << std::endl;
輸出結果為:
"huchao"
26
可見,上述代碼已經解析出了 json 字符串。
--------------------------------------
[1]:使用第三方源碼最簡單的方法是直接將文件加入工程,但這樣不利於源碼、軟件產品管理,對於一般軟件開發來說,不建議使用。
[2]:如果真需要編譯成動態鏈接庫、靜態導入庫的話,可以使用 VS 新建一個工程屬性,然後在Project --> Properties中進行相應的設置即可。