第三方庫 jsoncpp 讀寫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"

 

測試示例：

 

#include <iostream>
#include <sstream>
#include <exception>
#include "jsoncpp.hpp"

int main (int argc, char ** argv) {

    Json::Value root,task1,task2;

    //////////////////////////////////
    //  encoding test
    /////////////////////////////////
    task1["int"] = 123456;
    task1["double"] = 99.88;
    task1["string"] = "aaa";
    task1["bool"] = true;


    task2["int"] = 222222;
    task2["double"] = 77.88;
    task2["string"] = "bbb";
    task1["bool"] = false;

    root["resource"] = "/tasks/29";
    root["method"] = "GET";
    // list of 2 tasks
    root["body"][0] = task1;
    root["body"][1] = task2;

    std::ostringstream  ostrm;
    ostrm<<root;
    std::cout<<ostrm.str()<<std::endl;

    //////////////////////////////////
    //  decoding test
    /////////////////////////////////
    std::string content(ostrm.str());
    std::istringstream istrm(content);
    Json::Value root1;
    istrm>>root1;

    std::cout<<root1["body"]<<std::endl;
    // try to decode a non-exist key
    if (root1["body"][0]["string1"] == Json::nullValue)
        std::cout<<"Not found string1"<<std::endl;

    // invalid structure
    try {
        std::cout<<root1["body"]["not list"]["string"].asDouble()<<std::endl;
    } catch (std::exception & ex) {
        std::cout<<"!!!!"<<ex.what()<<std::endl;
    }
    // fail to decode an invalid double field, and get an exception
    try {
        std::cout<<root1["body"][1]["string"].asDouble()<<std::endl;
    } catch (std::exception & ex) {
        std::cout<<"!!!!"<<ex.what()<<std::endl;
    }
    // normally decoding
    std::cout<<"get double:"<<root1["body"][1]["double"].asDouble()<<std::endl;
    std::cout<<"get double:"<<root1["body"][0]["bool"].asBool()<<std::endl;
    return 0;
}

 

追加遍歷：

for(int i=0;i<root1["body"].size();i++){
    std::cout<<"body:"<<i<<" "<<root1["body"][i]["double"]<<std::endl;
    std::cout<<"body:"<<i<<" "<<root1["body"][i]["int"]<<std::endl;
}

 

 

26

可見，上述代碼已經解析出了 json 字符串。

注：Jason庫在項目中主要用來將協議數據轉化成網絡間文本協議，並與服務器進行交互。

--------------------------------------

[1]：使用第三方源碼最簡單的方法是直接將文件加入工程，但這樣不利於源碼、軟件產品管理，對於一般軟件開發來說，不建議使用。

 

[2]：如果真需要編譯成動態鏈接庫、靜態導入庫的話，可以使用 VS 新建一個工程屬性，然后在 Project --> Properties中進行相應的設置即可。

 

本文來自CSDN博客，轉載請標明出處：http://blog.csdn.net/xt_xiaotian/archive/2010/06/04/5648388.aspx