AJSON 项目启动与配置教程

1. 项目目录结构及介绍

AJSON 项目是一个用于 C++ 和 JSON 序列化的开源工具。项目结构相对简单，主要包含以下文件和目录：

ajson/
├── example1_helloworld.cpp         # 一个简单的示例文件，展示如何使用 AJSON
├── example2_basic.cpp             # 一个更复杂的示例文件，包含嵌套结构体的序列化和反序列化
├── ajson.hpp                      # AJSON 的核心头文件，包含了序列化和反序列化的主要功能
├── ajson_msd.hpp                  # 修改源数据内存策略的版本头文件
├── README.md                      # 项目说明文件，包含了项目介绍和使用方式
├── LICENSE                        # 项目使用的许可证文件
└── ...                           # 其他可能的文件和目录

• example1_helloworld.cpp 和 example2_basic.cpp：提供了如何使用 AJSON 的示例代码。
• ajson.hpp：这是主要的功能头文件，包含了序列化和反序列化的宏定义和函数。
• ajson_msd.hpp：提供了修改源数据内存策略的版本，适用于需要保持原始数据不变的场景。
• README.md：详细介绍了 AJSON 的设计动机、简介、特点、使用方式、版本更新内容等。
• LICENSE：AJSON 使用的是 BSL-1.0 许可证。

2. 项目的启动文件介绍

项目的启动文件主要是 example1_helloworld.cpp 和 example2_basic.cpp，它们是用于演示如何使用 AJSON 进行序列化和反序列化的示例。

example1_helloworld.cpp

这个文件展示了 AJSON 的基本用法，包括如何定义数据结构、如何将 JSON 文本反序列化到数据结构中，以及如何将数据结构序列化为 JSON 文本。

#include "ajson.hpp"

struct Person {
    std::string Name;
    int Age;
};

AJSON(Person, Name, Age)

int main() {
    char* json = "{\"Name\":\"Boo\", \"Age\":28}";
    Person obj;
    ajson::load_from_buff(obj, json);
    return 0;
}

example2_basic.cpp

这个文件包含了更复杂的示例，展示了如何处理嵌套结构体和 STL 容器。

3. 项目的配置文件介绍

AJSON 项目不需要特殊的配置文件。所有的配置都是通过宏定义在代码中完成的。开发者需要根据具体的项目需求，在数据结构定义中使用 AJSON 宏来指定哪些字段需要被序列化和反序列化。

在使用 AJSON 时，需要确保你的编译器支持 C++11 标准，因为 AJSON 依赖于 C++11 的一些特性。此外，由于 AJSON 不修改原始 JSON 文本，它适合用于对性能要求较高的场景。

在没有特殊配置需求的情况下，直接包含 ajson.hpp 头文件并按照示例代码编写你的数据结构和序列化逻辑即可开始使用 AJSON。