【腾讯RapidJSON】学习笔记

介绍

RapidJSON是一个C++的高性能的JSON解析器及生成器，同时支持SAX/DOM风格的API。

项目详细介绍
RapidJSON是一个C++的JSON解析器及生成器。它的灵感来自RapidXml
RapidJSON小而全。它同时支持SAX和DOM风格的API。SAX解析器只有约500行代码
RapidJSON快。它的性能可与strlen()相比。可支持SSE2/SSE4.1加速
RapidJSON独立。它不依赖于BOOST等外部库。它甚至不依赖于STL
RapidJSON对内存友好。在大部分32/64位机器上，每个JSON值只占16或20字节（除字符串外）。它预设使用一个快速的内存分配器，令分析器可以紧凑地分配内存
RapidJSON对Unicode友好。它支持UTF-8、UTF-16、UTF-32 (大端序／小端序)，并内部支持这些编码的检测、校验及转码。例如，RapidJSON可以在分析一个UTF-8文件至DOM时，把当中的JSON字符串转码至UTF-16。它也支持代理对（surrogate pair）及”\u0000”（空字符）
兼容性
RapidJSON是跨平台的。以下是一些曾测试的平台／编译器组合：
Visual C++ 2008/2010/2013 在 Windows (32/64-bit)
GNU C++ 3.8.x 在 Cygwin
Clang 3.4 在 Mac OS X (32/64-bit) 及 iOS
Clang 3.4 在 Android NDK
用户也可以在他们的平台上生成及执行单元测试。 ——腾讯开源

安装

Linux安装比较简单，将rapidjson文件夹移动到/usr/include/就可以使用了。

用法

每个 JSON 值都储存为 Value 类，而 Document 类则表示整个 DOM，它存储了一个 DOM 树的根 Value。RapidJSON 的所有公开类型及函数都在 rapidjson 命名空间中。
例如，有这样的JSONC语言字符串（被char *json指向）：
{
"hello": "world",
"t": true ,
"f": false,
"n": null,
"i": 123,
"pi": 3.1416,
"a": [1, 2, 3, 4]
}
DOM解析
Document document;
document.Parse(json);
会形成如下图的DOM树：

提供的对对应值的操作接口

1、判断Key值是否存在：HasMember("二狗");2、判断value值的类型，命名比较规范，就不详述了，如下：    IsObject();IsBool();IsNull();IsNumber();    IsInt();IsDouble();IsArray();3、获取和设置对应的值（参考第2点，将Is换作Get/Set）。值得注意的是数组和对象值的获取需要通过循环。

示例

//json.txt{           "hello": "world",                                                                  "t": true ,    "f": false,    "n": null,    "i": 123,    "pi": 3.1416,    "a": [1, 2, 3, 4]}       

/*************************************************************************             > File Name:    test_json.cpp    > Author:       vividwei    > Mail:         [e-mail]    > Created Time: 2016年12月15日 星期四 22时29分02秒 ************************************************************************/#include <iostream>#include <string>#include <fstream>#include <rapidjson/document.h>using namespace std;using namespace rapidjson;int main(void){    string buff;    string tmp;    ifstream res("json.txt");    if (!res.is_open())    {    ┊   cerr << "open" << endl;    ┊   return -1;    }    while (!res.eof())    {    ┊   getline(res, tmp);    ┊   buff.append(tmp+'\n');                                                         }    Document document;    document.Parse(buff.c_str());    if (document["hello"].IsString())    {    ┊   cout << document["hello"].GetString() << endl;    }    return 0;                                                                      }

总结

使用和测试就是这样了，使用比较简单。以后要是需要使用C++解析和生成JSON，可以考虑使用这个库。