c++怎么使用Cereal库进行对象序列化_C++对象序列化与Cereal库使用_技术教程

Cereal是C++中轻量高效的序列化库，通过包含头文件引入，支持JSON、XML和二进制格式。1. 安装只需将cereal/include添加到包含路径；2. 类需定义serialize函数，可使用CEREAL_NVP命名成员；3. 用cereal::JSONOutputArchive写入JSON文件；4. 用cereal::JSONInputArchive从文件读取反序列化；5. 支持STL容器如vector、map的嵌套序列化；6. 二进制归档更高效但不可读。

在C++中实现对象序列化，Cereal 是一个轻量、高效且头文件驱动的库，支持将C++对象轻松转换为JSON、XML或二进制格式，并能反序列化还原。它不需要宏或代码生成器，使用现代C++特性（如模板和SFINAE）自动处理类型推导。

1. 安装与引入 Cereal 库

Cereal 是纯头文件库，无需编译，直接包含即可使用。

• 下载地址：https://github.com/USCiLab/cereal • 使用方式：解压后将 cereal/include 目录添加到编译器的包含路径中。

在项目中引入：

#include 
#include 
#include 
#include 
// 根据需要包含其他类型支持

2. 基本序列化操作：定义 serialize 函数

要让类支持序列化，需在类中提供 serialize 成员函数，或通过 serialize 非成员函数进行特化。

示例：一个简单的 Person 类

class Person {
public:
    std::string name;
    int age;

    // 序列化接口
    template 
    void serialize(Archive& ar) {
        ar(CEREAL_NVP(name), CEREAL_NVP(age));  // NVP 添加命名信息（对 JSON/XML 有用）
    }
};

若类不能修改（如第三方类），可使用非成员函数：

namespace cereal {
template 
void serialize(Archive& ar, Person& p) {
    ar(CEREAL_NVP(p.name), CEREAL_NVP(p.age));
}
}

3. 将对象保存为 JSON 文件

使用 json_oarchive 将对象写入 JSON 文件：

#include 

int main() {
    Person p{"Alice", 30};

    std::ofstream os("person.json");
    cereal::JSONOutputArchive archive(os);
    archive(CEREAL_NVP(p));

    return 0;
}

生成的 person.json 内容：

{
  "p": {
    "name": "Alice",
    "age": 30
  }
}

4. 从 JSON 文件恢复对象

使用 json_iarchive 读取并反序列化：

int main() {
    Person p;

    std::ifstream is("person.json");
    cereal::JSONInputArchive archive(is);
    archive(p);  // 注意：这里不需要 CEREAL_NVP，除非结构嵌套

    std::cout << "Name: " << p.name << ", Age: " << p.age << std::endl;

    return 0;
}

5. 支持 STL 容器与嵌套对象

Cereal 原生支持 vector、map、string 等 STL 类型，嵌套序列化非常自然。

struct Company {
    std::string name;
    std::vector employees;

    template 
    void serialize(Archive& ar) {
        ar(CEREAL_NVP(name), CEREAL_NVP(employees));
    }
};

序列化整个公司数据：

Company c{"TechCo"};
c.employees.push_back({"Bob", 25});
c.employees.push_back({"Charlie", 35});

std::ofstream os("company.json");
cereal::JSONOutputArchive archive(os);
archive(c);

6. 二进制序列化（更高效）

若追求性能，可用二进制格式：

// 写入二进制
std::ofstream os("data.bin", std::ios::binary);
cereal::BinaryOutputArchive out_ar(os);
out_ar(p);

// 读取二进制
std::ifstream is("data.bin", std::ios::binary);
cereal::BinaryInputArchive in_ar(is);
in_ar(p);

二进制格式更快、体积小，但不具备可读性。

基本上就这些。Cereal 使用简洁，只需定义 serialize 方法，选择合适的归档类型（JSON、XML、Binary），就能完成对象持久化。注意确保所有成员类型都支持序列化，必要时手动实现 serialize。不复杂但容易忽略细节，比如 NVP 的使用和头文件包含。