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