介紹

該庫為輕量級的c++ json解析與構造庫，源碼很短，適合學習，覺得不錯的點個star。

提供了的功能：

• json字符串解析為c++對象（JSONArray和JSONObject）
• c++對象中獲取key-value值
• c++對象轉(zhuǎn)化為json字符串

除此之外，由于json支持了多種數(shù)據(jù)類型，還可以將JSONArray對象看成是python的list，JSONObject看成是python的dict，庫中提供了方便操作的api函數(shù)。例如以下初始化方法，

JSONArray arr = {123.4, "dfsdf", 23, nullptr}; // 類似于python的list
JSONArray arr2 = LIST(1.23, "sdfsdg", 234, nullptr); //提供一個LIST初始化宏，類似于python的list
JSONObject obj = {
    {"test obj", {"key", "value"}},
    {"int number", 2},
    {"float number", 34.3},
    {"my string", "fsdfsdg"},
    {"nullptr", nullptr},
    {"emptylist", {}},
}; // 可以看成是python的dict
JSONObject obj2 = OBJECT(
            KEYVALUE("username", "hhk"),
            KEYVALUE("obj", OBJECT(
                    KEYVALUE("abcd", LIST(1,2.3, "hahahaha")),
                    KEYVALUE("obj", OBJECT(
                            KEYVALUE("key", "this is obj.obj.key' s value")
                    ))
            )),
            KEYVALUE("null", nullptr),
            KEYVALUE("list", LIST(1, "qwerty", 2.34, OBJECT(
                            KEYVALUE("key", "this is a key"),
                            KEYVALUE("key2", "this is a key2"),
                    ))),
    		);  // 提供了一個初始化宏，類似于python的dict
// 注：使用OBJECT LIST初始化宏的目的是為了替代{}來進行初始化，因為有時候大括號看起來會不夠直觀。

實現(xiàn)該庫的一些技巧：

• 參考boost any.hpp ，實現(xiàn)一個可以在容器里容納任意類型的對象

• typeid 進行類型的判斷

• 使用了很多遞歸方法

編譯

編譯依賴：

• cmake
• gcc

如果是windows平臺推薦使用cygwin套件（可以在windows下編譯linux軟件），配合clion，開發(fā)起來挺方便的。

例如windows平臺下（linux下類似），編譯靜態(tài)庫的方法如下，編譯成功后在build目錄下生成libSimpleJson.a靜態(tài)庫。

編譯測試程序方法如下：(-lSimpleJson參數(shù)表示鏈接libSimpleJson.a靜態(tài)庫)

提供方便的API

這里Json支持的類型有int, float, double, const char* , string, nullptr(cpp中的空指針)

1. JSON Array

   • 使用 [] 操作符寫入數(shù)據(jù)，可以使用cout直接打印輸出

     JSONArray test1(2); // 初始化分配大小，可以會自動拓展容量
     test1[0] = nullptr;
     test1[1] = "this is const char*";
     test1[2] = 12324.5;
     test1[5] = "中文字符串";
     cout << test1 << endl;

   • 初始化列表構造函數(shù)與鏈式操作

     JSONArray arr = {123.4, "dfsdf", 23, nullptr}; // 初始化列表 
     arr[0] = 12.314;
     arr[2] = 2335;
     arr[3] = "字符串";
     arr[6] = obj;  // json對象
     arr.add(123456) // 整數(shù)
        .add(234.235236) //浮點數(shù)
        .add("字符串") //字符串
        .add(nullptr); // null測試

   • get方法獲取數(shù)值

     例如?float f = test1.get(2);?，如果類型不正確的話會拋出異常

   • toString方法轉(zhuǎn)換為字符串，toString可選參數(shù)，代表縮進的數(shù)量。

     例如?test1.toString(4)?表示4空格縮進

2. JSON Object

   • 使用 [] 來寫入數(shù)據(jù)

     // 使用[] 操作對象
     JSONObject test2;
     test2["float"] = 123.456;
     test2["int"] = 24;
     test2["string"] = "this is a string";
     test2["array"] = test1;
     test2["nullptr"] = nullptr;
     cout << test2 << endl;

   • 更加復雜的初始化方法

     這種方法看起來比較直觀，支持object和array的嵌套使用，這是我自己想出來的，有興趣的朋友可以看下我的實現(xiàn)方法，討論下有沒有更加優(yōu)秀的實現(xiàn)方式。

     // obj初始化方法
     JSONObject obj = {
         {"test obj", {"key", "value"}},
         {"int number", 2},
         {"float number", 34.3},
         {"my string", "fsdfsdg"},
         {"nullptr", nullptr},
         {"emptylist", {}},
         {"列表嵌套列表", {1,2.3, "sdf", {1,2.242, "float"}}}, // 列表嵌套
         {"列表嵌套對象和列表", {
             {{"key1", 1234}}, // 被認為是對象
             {"key1", 1234}, // 被認為是列表
             1.23,
             234325
         }},
         {"對象", { // 所有的值都是{key, value}對則認為是嵌套對象
             {"a obj", 1234566},
             {"b obj", "b obj value"},
         }}
     };

     這種方法有時候還是有點不夠直觀，所以我弄了一個宏，使得編寫json時更加直觀

     JSONObject context = OBJECT(
                 KEYVALUE("username", "hhk"),
                 KEYVALUE("obj", OBJECT(
                         KEYVALUE("abcd", LIST(1,2.3, "hahahaha")),
                         KEYVALUE("obj", OBJECT(
                                 KEYVALUE("key", "this is obj.obj.key' s value")
                         ))
                 )),
                 KEYVALUE("null", nullptr),
                 KEYVALUE("list", LIST(1, "qwerty", 2.34, OBJECT(
                                 KEYVALUE("key", "this is a key"),
                                 KEYVALUE("key2", "this is a key2"),
                         ))),
                 KEYVALUE("list1", LIST(1,2,3,4,5)),
                 KEYVALUE("list2", LIST(1,2,3)),
                 KEYVALUE("obj2", OBJECT(
                         KEYVALUE("key1", "value1"),
                         KEYVALUE("key2", 222),
                         KEYVALUE("key3", 333),
                 )),
                 KEYVALUE("a", "111"),
                 KEYVALUE("b", "222"),
                 KEYVALUE("c", "333"),
         );

     這里有三個宏，分別是OBJECT，KEYVALUE， LIST。

   • 支持鏈式add的操作

     obj["int"] = 12325;
     obj["float"] = 24235.235235;
     obj["string"] = "this is a string2";
     obj["null"] = nullptr;
     
     obj.add("int", 123) // 整數(shù)
         .add("float", 23.2324) // 浮點數(shù)
         .add("string", "this is a string") // 英文字符串
         .add("中文", "這是中文字符串。。。") // 中文字符串
         .add("symbols  ",.[]@!#$%^", "含有特殊符號"") // 特殊符號
         .add("list", {1, 2.34, "english string", 123.4, "中文字符串"}) // 列表
         .add("this is null", nullptr) // null測試
         .add("object", {{"key1", "value1"}, {"key2", 223}, {"key3", 23.4}}); // 對象

   • get 方法獲取數(shù)值

     例如，?obj->get("string")?可以獲取到鍵為string的值。

   • toString方法輸出字符串，參數(shù)為縮進的數(shù)量

     例如4空格縮進如下(obj.toString(4))

     

     無縮進（obj.toString(-1)）

     

     無空格縮進(?obj.toString(0))

     

3. 字符串轉(zhuǎn)換為json對象

   由于我們不知道字符串是array還是object，我們使用JSONBase類來接受返回的結果。

   （JSONBase中有isJSONArray 和 isJSONArray 方法，可以方便我們進行類型判斷）

   例如以下,

   string parse_str = R"({"name" : "hhk" , "key1": "valu"e1 ","key2":[1,2,"asd",{"sadf": 123, "sb": 12.3}, 123.3]})";
   JSONBase* a = JSONBase::parse(parse_str);
   cout << *a << endl;
   JSONObject *b = dynamic_cast(a); //類型轉(zhuǎn)換
   cout << b->get("key1") << endl;
   cout << b->get("key2").get(1) << endl;

   parse方法用于不知道字符串是array還是object，parse_obj方法返回JSONObject，parse_arr方法返回JSONArray。（parse_obj,parse_arr用于明確知道字符串的類型）

   如果字符串不是json字符串，則拋出JSONParseException異常。