使用 C++ 處理 JSON 資料交換格式 .

使用 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中進行相應的設定即可。