RapidJSON教程：从基础解析到DOM操作实战-优快云博客

RapidJSON教程：从基础解析到DOM操作实战

rapidjson A fast JSON parser/generator for C++ with both SAX/DOM style API 项目地址: https://gitcode.com/gh_mirrors/ra/rapidjson

快速认识RapidJSON

RapidJSON是一个高效的C++ JSON解析器和生成器，专注于性能和易用性。它提供了DOM（Document Object Model）和SAX（Simple API for XML）两种风格的API，本教程将重点介绍DOM风格的API使用。

基础JSON解析

1. 解析JSON字符串

首先我们需要包含必要的头文件：

#include "rapidjson/document.h"
#include "rapidjson/prettywriter.h"

RapidJSON提供了两种解析JSON的方式：

常规解析：创建新的缓冲区存储解码后的字符串

if (document.Parse(json).HasParseError())
    return 1;

原地解析(ParseInsitu)：直接在源字符串中解码，效率更高但会修改源字符串

char buffer[sizeof(json)];
memcpy(buffer, json, sizeof(json));
if (document.ParseInsitu(buffer).HasParseError())
    return 1;

原地解析通常比常规解析快，因为它避免了分配额外内存和复制字符串的开销。

访问JSON数据

2. 访问文档中的值

解析完成后，我们可以通过多种方式访问JSON数据：

// 检查成员是否存在并获取值
assert(document.HasMember("hello"));
assert(document["hello"].IsString());
printf("hello = %s\n", document["hello"].GetString());

// 使用查找成员的方式（更高效）
Value::MemberIterator hello = document.FindMember("hello");
assert(hello != document.MemberEnd());

RapidJSON提供了丰富的数据类型检查方法：

assert(document["t"].IsBool());  // 布尔值
assert(document["i"].IsInt());   // 整数
assert(document["pi"].IsDouble()); // 浮点数
assert(document["n"].IsNull());  // null值

对于数组类型的处理：

const Value& a = document["a"];
assert(a.IsArray());
for (SizeType i = 0; i < a.Size(); i++)
    printf("a[%d] = %d\n", i, a[i].GetInt());

修改JSON数据

3. 修改文档内容

RapidJSON允许我们灵活地修改已解析的JSON文档：

修改现有值：

document["i"] = f20;  // 修改整数值

向数组添加元素：

Value& a = document["a"];
Document::AllocatorType& allocator = document.GetAllocator();
for (int i = 5; i <= 10; i++)
    a.PushBack(i, allocator);

设置字符串值：

// 简单方式（适合字面量）
document["hello"] = "rapidjson";

// 高效方式（指定长度避免strlen调用）
document["hello"].SetString("rapidjson", 9);

// 需要分配器的方式（适合动态字符串）
char buffer2[10];
int len = sprintf(buffer2, "%s %s", "Milo", "Yip");
author.SetString(buffer2, static_cast<SizeType>(len), document.GetAllocator());

生成JSON字符串

4. 将DOM转换为JSON字符串

最后，我们可以将修改后的DOM转换回JSON字符串：

StringBuffer sb;
PrettyWriter<StringBuffer> writer(sb);
document.Accept(writer);
puts(sb.GetString());

PrettyWriter会生成格式化的JSON输出，如果需要紧凑格式，可以使用Writer代替。

最佳实践建议

内存管理：RapidJSON使用分配器管理内存，修改文档时通常需要传递分配器参数。
类型安全：始终检查值的类型后再进行操作，避免运行时错误。
性能考虑：
- 对于只读操作，使用const Value&引用
- 对于频繁访问的成员，先保存引用
- 考虑使用ParseInsitu提高解析速度
字符串处理：
- 静态字符串使用简单赋值
- 动态字符串使用带分配器的SetString