WWJSON - 高性能C++ JSON构建库

CI Status C++17 Header-only

WWJSON是一个仅头文件的C++ JSON构建库，专注于高性能JSON字符串生成而无需DOM树构造。该库提供了简单、轻量级的JSON序列化方式，通过直接字符串操作实现高性能，特别适合需要快速构建JSON响应的应用场景。

🚀 核心特性

  • 🚀 高性能: 直接字符串操作，无需DOM树构建开销
  • 🎯 轻量级: 头文件only设计，无运行时依赖
  • 🛡️ 类型安全: 支持C++17编译期类型检查
  • 🔧 高度可配置: 支持自定义字符串类型和序列化配置
  • 📦 易于集成: 标准CMake包，支持find_package
  • 🧪 完整测试: 丰富的单元测试 + 性能基准测试

📋 快速开始

安装要求

  • C++标准: C++17 或更高版本
  • 编译器: GCC 7+, Clang 6+, MSVC 2017+
  • 构建系统: CMake 3.15+

基本用法

#include "wwjson.hpp"

int main() {
    wwjson::RawBuilder builder;
    builder.BeginObject();
    builder.AddMember("name", "wwjson");
    builder.AddMember("version", 1.0);
    builder.AddMember("features", [&]() {
        auto arr = builder.ScopeArray();
        arr.AddItem("fast");
        arr.AddItem("simple");
        arr.AddItem("header-only");
    });
    builder.EndObject();
    
    std::string json = builder.GetResult();
    // {"name":"wwjson","version":1,"features":["fast","simple","header-only"]}
    return 0;
}

CMake集成

# 查找包
find_package(wwjson 1.0 REQUIRED)

# 链接到你的目标
target_link_libraries(your_target PRIVATE wwjson::wwjson)

🎯 适用场景

  • Web API响应: 快速生成JSON API响应
  • 日志记录: 高效结构化日志输出
  • 配置管理: 生成配置文件和参数
  • 消息队列: 序列化数据传输格式
  • 数据导出: 将内存数据转换为JSON格式

🔬 质量保证

  • ✅ 单元测试: 完备的测试用例，覆盖所有API
  • ✅ 性能基准: 与yyjson等主流库对比测试
  • ✅ CI/CD: GitHub Actions自动化测试
  • ✅ 内存安全: 无内存泄漏，RAII模式
  • ✅ 类型安全: 编译期类型检查

📊 性能特点

  • 小整数优化: 0-99范围使用查表法，显著提升序列化速度
  • 小范围浮点优化: [0, 9999.9999]范围内快速序列化
  • 智能转义: 仅在必要时进行字符转义，减少开销
  • 内存预分配: 支持预估大小，减少内存重分配

📚 文档列表

📄 许可证

本项目采用 MIT License 开源协议。

👥 致谢

  • couttast - 轻量级测试框架
  • yyjson - 性能对比参考
  • xyjson - 更易用 yyjson 封装，辅助验证工具

注意: WWJSON专注于JSON构建（序列化），不包含解析功能。如需JSON解析功能，建议结合其他专门的解析库使用。