关闭

c++中rapidjson库下载安装及使用

5346人阅读 评论(0) 收藏 举报

rapidjson库官网地址:http://www.oschina.net/news/61812/rapidjson-1-0-final

rapidjson库下载网地址:https://github.com/miloyip/rapidjson

rapidjson库安装及使用教程中文解释网站:http://rapidjson.org/zh-cn/

如何安装rapidjson库:

高效的 C++ JSON 解析/生成器,提供 SAX 及 DOM 风格 API

Tencent is pleased to support the open source community by making RapidJSON available.

Copyright (C) 2015 THL A29 Limited, a Tencent company, and Milo Yip. All rights reserved.

Build 状态

Linux Windows Coveralls
lin-badge
win-badge
cov-badge

简介

RapidJSON 是一个 C++ 的 JSON 解析器及生成器。它的灵感来自 RapidXml

  • RapidJSON 小而全。它同时支持 SAX 和 DOM 风格的 API。SAX 解析器只有约 500 行代码。
  • RapidJSON 快。它的性能可与 strlen() 相比。可支持 SSE2/SSE4.2 加速。
  • RapidJSON 独立。它不依赖于 BOOST 等外部库。它甚至不依赖于 STL。
  • RapidJSON 对内存友好。在大部分 32/64 位机器上,每个 JSON 值只占 16 字节(除字符串外)。它预设使用一个快速的内存分配器,令分析器可以紧凑地分配内存。
  • 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 的更多信息可参考:

v1.1 中的亮点 (2016-8-25)

  • 加入 JSON Pointer 功能,可更简单地访问及更改 DOM。
  • 加入 JSON Schema 功能,可在解析或生成 JSON 时进行校验。
  • 加入 放宽的 JSON 语法 (注释、尾随逗号、NaN/Infinity)
  • 使用 C++11 范围 for 循环 去遍历 array 和 object。
  • 在 x86-64 架构下,缩减每个 Value 的内存开销从 24 字节至 16 字节。

其他改动请参考 change log.

兼容性

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 目录中。

RapidJSON 依赖于以下软件:

  • CMake 作为通用生成工具
  • (optional)Doxygen 用于生成文档
  • (optional)googletest 用于单元及性能测试

生成测试及例子的步骤:

  1. 执行 git submodule update --init 去获取 thirdparty submodules (google test)。
  2. 在 rapidjson 目渌下,建立一个 build 目录。
  3. build 目录下执行 cmake .. 命令以设置生成。Windows 用户可使用 cmake-gui 应用程序。
  4. 在 Windows 下,编译生成在 build 目录中的 solution。在 Linux 下,于 build 目录运行 make

成功生成后,你会在 bin 的目录下找到编译后的测试及例子可执行文件。而生成的文档将位于 build 下的 doc/html 目录。要执行测试,请在 build 下执行 make testctest。使用 ctest -V 命令可获取详细的输出。

我们也可以把程序库安装至全系统中,只要在具管理權限下从 build 目录执行 make install 命令。这样会按系统的偏好设置安装所有文件。当安装 RapidJSON 后,其他的 CMake 项目需要使用它时,可以通过在 CMakeLists.txt 加入一句 find_package(RapidJSON)

用法一览

此简单例子解析一个 JSON 字符串至一个 document (DOM),对 DOM 作出简单修改,最终把 DOM 转换(stringify)至 JSON 字符串。

// rapidjson/example/simpledom/simpledom.cpp`
#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}";
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;
}

注意此例子并没有处理潜在错误。

下图展示执行过程。

simpledom.png
simpledom

还有许多 例子 可供参考:

  • DOM API
    • tutorial: DOM API 的基本使用方法。
  • SAX API
    • simplereader: 使用 Reader 解析 JSON 时,打印所有 SAX 事件。
    • condense: 移除 JSON 中所有空白符的命令行工具。
    • pretty: 为 JSON 加入缩进与换行的命令行工具,当中使用了 PrettyWriter
    • capitalize: 把 JSON 中所有字符串改为大写的命令行工具。
    • messagereader: 使用 SAX API 去解析一个 JSON 报文。
    • serialize: 使用 SAX API 去序列化 C++ 对象,生成 JSON。
    • jsonx: 实现了一个 JsonxWriter,它能把 SAX 事件写成 JSONx(一种 XML)格式。这个例子是把 JSON 输入转换成 JSONx 格式的命令行工具。
  • Schema API
  • 进阶
    • prettyauto: pretty 的修改版本,可自动处理任何 UTF 编码的 JSON。
    • parsebyparts: 这例子中的 AsyncDocumentParser 类使用 C++ 线程来逐段解析 JSON。
    • filterkey: 移取使用者指定的键值的命令行工具。
    • filterkeydom: 如上的工具,但展示如何使用生成器(generator)去填充一个 Document

1
0
查看评论

rapidjson初探——使用C++解析json

刚开始想用jsoncpp的,发现这东西相当不友好,VS2013就是编译不了,于是就弃坑了 发现rapidjson超级好用,只需要包含头文件,也就是可以跨平台 虽然写很复杂的功能的时候可能需要自己封装一些接口,但是写简单的json解析完全够用了 如果是有一个文件,里面有json格式的字符串 那...
  • SteelBasalt
  • SteelBasalt
  • 2016-05-01 15:43
  • 7756

[rapidjson]_[C/C++]_[rapidjson库使用简单介绍]

场景: 1.cpp的json有很多,其中哟jsoncpp等,rapidjson是一个比较好的选择,特别是开发跨平台应用时,因为它只有头文件. 2.再用cpp生成html网页时,通过json数据和javascript来控制页面内容是常见的方案. 3.官网: http://code.google....
  • infoworld
  • infoworld
  • 2013-07-30 11:12
  • 45017

jsonc库使用

jsonc库使用 作者:wangkangluo1 | 出处:博客园 | 2011/12/15 15:12:28 | 阅读58次 原文地址:   1: 下载json-c库源码文件 json-c-0.9.tar.gz 2: 编译 3: jso...
  • wenyue043
  • wenyue043
  • 2015-08-24 13:46
  • 447

rapidjson使用总结

rapidjson是腾讯的开源json解析框架,用c++实现。由于全部代码仅用header file实现,所以很容易集成到项目中。 rapidjson的性能是很出色的,其作者[Milo Yipz](https://github.com/miloyip)做了28个C/C++ JSON库的评测,[这个...
  • elloop
  • elloop
  • 2015-11-18 16:13
  • 41290

RapidJSON的使用

关于RapidJSON rapidjson项目地址:https://github.com/miloyip/rapidjson 项目下载完成后,打开readme.md文件,查看项目说明。 RapidJSON is a header-only C++ library. Just copy the ...
  • linchaolong
  • linchaolong
  • 2015-02-03 09:49
  • 4748

初学C++ 使用json对象----------rapidjson

RapidJSON是一个只有头文件的C++ JSON库,只需要拷贝“include/rapidjson”目录到工程包含路径下即可使用。rapidjson库下载网地址:https://github.com/miloyip/rapidjsonrapidjson优点: 1.简单,易操作,RapidJSO...
  • uriel_chiang
  • uriel_chiang
  • 2016-11-28 22:14
  • 554

如何使用rapidjson库进行json格式的封装及解析

一,字符串json封装及及解析的实例 #include "rapidjson/document.h" #include "rapidjson/prettywriter.h"   #include "rapidjson/writer...
  • wangqing_12345
  • wangqing_12345
  • 2016-08-29 15:34
  • 8614

c++解析json文件: Rapidjson

#include "rapidjson/document.h" #include "rapidjson/prettywriter.h" #include "rapidjson/filestream.h" #include #includ...
  • u013242491
  • u013242491
  • 2014-10-05 00:30
  • 1645

C++ 封装RapidJson把一个类Json序列化和反序列化

很多人都知道rapidjson这个json库,大家也都知道他的高效,可是你一定也对他的使用方法,函数API接口感受到非常不适应,你一定非常怀念使用java和C#对一个实体类的那么轻松加简单的直接json序列化,是的本篇博客将免费开源一个我自己平时做项目研发使用的一个RapidJsonHelper类,...
  • lightspear
  • lightspear
  • 2017-02-02 17:28
  • 3317

[常用第三方库]RapidJSON

RapidJSON是一个C++的高性能的JSON解析器及生成器,同时支持SAX/DOM风格的API。简介RapidJSON是一个C++的JSON解析器及生成器。它的灵感来自RapidXmlRapidJSON小而全。它同时支持SAX和DOM风格的API。SAX解析器只有约500行代码RapidJSON...
  • ouyangshima
  • ouyangshima
  • 2017-05-03 01:27
  • 966
    个人资料
    • 访问:189459次
    • 积分:3083
    • 等级:
    • 排名:第13416名
    • 原创:121篇
    • 转载:6篇
    • 译文:0篇
    • 评论:26条
    文章分类
    最新评论