C++的JSON开发包,RapidJSON 1.0 正式版发布
RapidJSON是一个C++的JSON解析器及生成器。它的灵感来自RapidXml。
- RapidJSON小而全。它同时支持SAX和DOM风格的API。SAX解析器只有约500行代码。
- RapidJSON快。它的性能可与
strlen()
相比。可支持SSE2/SSE4.2加速。 - 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"
(空字符)。
在这里可读取更多特点。
JSON(JavaScript Object Notation)是一个轻量的数据交换格式。RapidJSON应该完全遵从RFC7159/ECMA-404。 关于JSON的更多信息可参考:
- Introducing JSON
- RFC7159: The JavaScript Object Notation (JSON) Data Interchange Format
- Standard ECMA-404: The JSON Data Interchange Format
兼容性
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
用户也可以在他们的平台上生成及执行单元测试。
安装
RapidJSON是只有头文件的C++库。只需把include/rapidjson
目录复制至系统或项目的include目录中。
生成测试及例子的步骤:
- 执行
git submodule update --init
去获取 thirdparty submodules (google test)。 - 下载 premake4。
- 复制 premake4 可执行文件至
rapidjson/build
(或系统路径)。 - 进入
rapidjson/build/
目录,在Windows下执行premake.bat
,在Linux或其他平台下执行premake.sh
。 - 在Windows上,生成位于
rapidjson/build/vs2008/
或/vs2010/
内的项目方案. - 在其他平台上,在
rapidjson/build/gmake/
目录执行GNUmake
(如make -f test.make config=release32
、make -f example.make config=debug32
)。 - 若成功,可执行文件会生成在
rapidjson/bin
目录。
生成Doxygen文档的步骤:
- 下载及安装Doxygen。
- 在顶层目录执行
doxygen build/Doxyfile
。 - 在
doc/html
浏览文档。
用法一览
此简单例子解析一个JSON字符串至一个document (DOM),对DOM作出简单修改,最终把DOM转换(stringify)至JSON字符串。
// rapidjson/example/simpledom/simpledom.cpp` #include "rapidjson/document.h" #include "rapidjson/writer.h" #include "rapidjson/stringbuffer.h" #include <iostream> using namespace rapidjson; int main() { // 1. 把JSON解析至DOM。 const char* json = "{\"project\":\"rapidjson\",\"stars\":10}"; Document d; d.Parse(json); // 2. 利用DOM作出修改。 Value& s = d["stars"]; s.SetInt(s.GetInt() + 1); // 3. 把DOM转换(stringify)成JSON。 StringBuffer buffer; Writer<StringBuffer> writer(buffer); d.Accept(writer); // Output {"project":"rapidjson","stars":11} std::cout << buffer.GetString() << std::endl; return 0; }
注意此例子并没有处理潜在错误。
下图展示执行过程。
RapidJSON 1.0 正式版发布,该版本在 1.0 Beta 的基础上实现了 100% 单元测试的覆盖率。
其他方面的改进包括:
-
Fixed a bug in trimming long number sequence (4824f12)
-
Fix double quote in unicode escape (#288)
-
Fix negative zero roundtrip (double only) (#289)
-
Remove an invalid Document::ParseInsitu() API (e7f1c6d)
-
Remove dead branches and add more unit tests for coverage
-
Standardize behavior of
memcpy()
andmalloc()
(0c5c153, #305, 0e8bbe5) -
Add version macros (#311)