使用 C++ 處理 JSON 數據交換格式

1、摘要

JSON 的全稱爲：JavaScript Object Notation，顧名思義，JSON 是用於標記 Javascript 對象的，JSON 官方的解釋爲：JSON 是一種輕量級的數據傳輸格式。

本文並不詳細介紹 JSON 自己的細節，旨在討論如何使用 C++ 語言來處理 JSON。關於 JSON 更具體的信息，可參見 JSON 官網：http://www.json.org。

2、本文選擇處理 JSON的 C++ 庫

本文選擇一個第三方庫 jsoncpp 來解析 JSON。jsoncpp 是比較出名的 C++ JSON 解析庫。在 JSON 官網也是首推的。

下載地址爲：http://sourceforge.net/projects/jsoncpp。本文使用的 jsoncpp 版本爲：0.5.0。

3、jsoncpp 在 Windows 下的編譯

要使用第三方源碼庫，第一步少不了的就是編譯，將源碼文件編譯成咱們方便使用的動態連接庫、靜態連接庫或者靜態導入庫[1]。

jsconcpp 進行 JSON 解析的源碼文件分佈在 include/json、src/lib_json 下。其實 jsoncpp 源碼並很少，爲了方便產品管理，此處不必將其編譯爲動態連接庫或者靜態導入庫，因此咱們選擇使用靜態連接庫[2]。

jsoncpp 已經處理的很完善了，全部編譯選項都已經配置好，打開makefiles/vs71/jsoncpp.sln 即可以開始編譯（默認是使用 VS2003 編譯器的，打開時直接按照 VS2005 提示轉換便可）。

4、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中進行相應的設置便可。