极力推荐一个简单好用的C++JSON库

  极力推荐一个简单好用的C++JSON库CJsonObject，让使用json如使用C++原生的结构体那般方便，随心所欲。CJsonObject是个优秀的C++JSON库，也许会是你见过的最为简单易用的C++json库。CJsonObject的开源地址是https://github.com/Bwar/CJsonObject和https://gitee.com/Bwar/CJsonObject。在开源之初发布的一篇介绍CJsonObject使用的博客《轻量简单好用的C++JSON库CJsonObject》。

  CJsonObject开源一年，没有刻意推广，在GitHub上获得130多star和60多fork，事实上当初把CJsonObject开源并建立一个与cJSON的fork关系（事实上CJsonObject与github上的cJSON没有任何关系，CJsonObject使用的cJSON是基于SourceForge上版本比较老的cJSON基础上修改的）是为了多引入一些流量到Bwar倾力打造的另一开源项目Nebula。没想到，倾力打造并且写了好几篇有技术含量的博客文章来推广的Nebula无论star数量还是fork数量都比CJsonObject少（可能跟受众数量有关系）。Bwar始终认为绝大部分使用JSON的场景下，易用性与开发效率才是第一位的，而不是解析性能。在易用性上，说CJsonObject让JSON如C++原生数据结构一般并不为过，所以不避黄婆卖瓜之嫌再极力推荐！CJsonObject有良好的更新和维护，对使用者提的issue响应非常及时，开源一年增加了不少原本不支持但使用者又需要的功能特性。

  CJsonObject在Bwar的重点开源项目Nebula中大量使用，无论对Bwar自己还是对外部开发者，都有持续更新维护的需要。顺便为打个小广告，Nebula是一个强大的IoC网络框架，用于以C++快速构建高并发、分布式和弹性的消息驱动应用程序。适用于即时通讯、数据采集、实时计算、消息推送、web后台服务等应用场景，Nebula已有即时通讯、埋点数据采集及实时分析的生产应用案例。如果觉得CJsonObject不错，给Nebula也点个star，谢谢。

  CJsonObject是基于cJSON全新开发一个C++版的JSON库，CJsonObject的最大优势是轻量，简单好用，开发效率极高。CJsonObject只有4个文件，拷贝到自己代码里源码级集成即可，无须编译成库，且跨平台和编译器。与大部分json解析库访问多层嵌套json非常麻烦不同，CJsonObject对多层嵌套json的读取和生成使用非常简单。

  针对开发者在博客和CJsonObject项目的issue提的问题整理了一个FAQ如下：

FAQ

• 1. 如何遍历json的key，并取其value？

std::string strTraversingKey;
std::string strTraversingValue;
while(oJson.GetKey(strTraversingKey))
{
    if (oJson.Get(strTraversingKey, strTraversingValue))
    {
        std::cout << strTraversing << "  :  " << strTraversingValue << std::endl;
    }
}

  GetKey()遍历不适用于数组，对json数组调用GetKey()将直接返回false。调用GetKey()函数循环遍历获取当前所在层次的json key，GetKey()返回false表示已取完最后一个key，下次遍历再调用GetKey()将重新从第一个key开始获取。换一种说法，GetKey()遍历json key的返回结果为：true,true,true ... true,false; true,true,true ... true,false; true,true,true ... true,false; 想要遍历多少轮完全由用户自己决定。

  如果需要中断一次遍历并重新开始，可以调用ResetTraversing()函数重置遍历。

std::string strTraversingKey;
std::string strTraversingValue;
while(oJson.GetKey(strTraversingKey))
{
    if (strTraversingKey == "Auguest")
    {
        oJson.ResetTraversing();
        break;
    }
    if (oJson.Get(strTraversingKey, strTraversingValue))
    {
        std::cout << strTraversing << "  :  " << strTraversingValue << std::endl;
    }
}

// 因为上一个遍历中断时调用了ResetTraversing()，所以本次遍历又是从第一个key开始。如果上一个遍历中断时未调用ResetTraversing()，那这次遍历将是从上次终端的位置继续，这通常不是遍历的预期结果，因此，中断遍历时记得ResetTraversing()。
while(oJson.GetKey(strTraversingKey))
{
    if (oJson.Get(strTraversingKey, strTraversingValue))
    {
        std::cout << strTraversing << "  :  " << strTraversingValue << std::endl;
    }
}

  __注意：__对Json当前层次的key进行Add()或Delete()操作，将导致当前遍历失效，下次调用GetKey()将获取key从头开始。

• 2. Replace一个key时，是否需要原value类型与替换后value类型一致？

  Replace()函数对key进行替换，跟value类型无关。把一个value为int的替换为value为string，或将value替换为object或array都是可以的。但如非必要，建议替换后的value类型跟替换前的value类型相同。

• 3. []和()的重载有什么区别，为什么要重载这两个操作符？

  []的重载是操作JsonObject或JsonArray的，为了方便一层一层往下取嵌套的json，不适用于string、int等基本json类型；()的重载是Get()系列函数的更便捷的调用，如果十分肯定key是存在的不需要通过Get()的返回值判断是否获取成功，调用()比调用Get()编码要快，不适用于操作JsonObject或JsonArray。

  []和()返回值是不一样的，两者不能混用。

• 4. 如何用CJsonObject创建类似以下二维数组？

{
    "test":[
        [{"test":1}],
        [{"test":2}]
    ]
}

  CJsonObject对多层嵌套json的操作非常灵活方便，对嵌套json的生成和读取有许多种灵活用法。

neb::CJsonObject oTest;
oTest.AddEmptySubArray("test");
for (int i = 1; i < 3; ++i)
{
    neb::CJsonObject oDimension1;
    neb::CJsonObject oDimension2;
    oDimension2.Add("test", i);
    oDimension1.Add(oDimension2);
    oTest["test"].Add(oDimension1);
}
std::cout << oTest.ToString() << std::endl;

  这里给出的只是其中一种写法，其他几种可以参考FAQ#5。

• 5. 请问一下在使用CJsonObject如何创建如下形式的数组？

{
    "employees": [
        { "firstName":"John" , "lastName":"Doe" },
        { "firstName":"Anna" , "lastName":"Smith" },
        { "firstName":"Peter" , "lastName":"Jones" }
    ]
}

  这里给出三种生成上述json数组的方式：

neb::CJsonObject oJson;
oJson.AddEmptySubArray("employees");
oJson["employees"].Add(neb::CJsonObject("{"firstName":"John" , "lastName":"Doe"}"));
oJson["employees"].Add(neb::CJsonObject("{"firstName":"Anna" , "lastName":"Smith"}"));
oJson["employees"].Add(neb::CJsonObject("{"firstName":"Peter" , "lastName":"Jones"}"));

neb::CJsonObject oJson;
oJson.AddEmptySubArray("employees");
oJson["employees"].Add(neb::CJsonObject("{}"));
oJson["employees"][0].Add("firstName", "John");
oJson["employees"][0].Add("lastName", "Doe");
oJson["employees"].Add(neb::CJsonObject("{}"));
oJson["employees"][1].Add("firstName", "Anna");
oJson["employees"][1].Add("lastName", "Smith");
oJson["employees"].Add(neb::CJsonObject("{}"));
oJson["employees"][2].Add("firstName", "Peter");
oJson["employees"][2].Add("lastName", "Jones");

neb::CJsonObject oJson;
neb::CJsonObject oJohn;
neb::CJsonObject oAnna;
neb::CJsonObject oPeter;
oJohn.Add("firstName", "John");
oJohn.Add("lastName", "Doe");
oAnna.Add("firstName", "Anna");
oAnna.Add("lastName", "Smith");
oPeter.Add("firstName", "Peter");
oPeter.Add("lastName", "Jones");
oJson.AddEmptySubArray("employees");
oJson["employees"].Add(oJohn);
oJson["employees"].Add(oAnna);
oJson["employees"].Add(oPeter);