C boost::archive 详解序列化库的全面指南一、C boost::archive引言1、 boost::archive 核心概念1.1 、什么是 Archive1.2 、序列化函数serialize()2、快速入门一个简单的例子3、 不同存档格式详解3.1、 文本存档 (text_oarchive / text_iarchive)3.2、 二进制存档 (binary_oarchive / binary_iarchive)3.3、 XML 存档 (xml_oarchive / xml_iarchive)4、序列化复杂数据类型4.1、 标准库容器 (std::vector, std::map, 等)4.2 、继承和多态指针序列化4.3 、版本控制5、 高级技巧与最佳实践5.1、 拆分 save 和 load5.2、 序列化到内存缓冲区5.3、性能优化6、常见问题与陷阱7、总结二、使用步骤1、下载库2、Visual Studio新建工程3、将源码解压到工程目录下4、添加路径5、测试代码一、C boost::archive引言在 C 开发中数据持久化、网络传输和进程间通信常常需要将复杂的内存对象转换为可以存储或传输的字节流这个过程就是序列化Serialization。反之从字节流重建内存对象的过程称为反序列化Deserialization。手动实现这些功能不仅繁琐而且容易出错尤其是在处理继承、指针和复杂数据结构时。Boost C 库提供了一个强大、灵活且高效的序列化解决方案boost::archive。作为 Boost.Serialization 库的核心组件boost::archive定义了数据流进出的抽象接口支持多种存档格式如二进制、文本、XML并能够与标准容器、智能指针以及用户自定义类型无缝协作。1、 boost::archive 核心概念1.1 、什么是 Archive在 Boost.Serialization 的语境中Archive存档是一个扮演“中介”角色的类。它负责在序列化时将 C 对象的状态数据成员输出到一个流如文件、内存缓冲区、网络套接字在反序列化时从一个流中读取数据并重建对象。boost::archive本身是一个模板类和一系列具体实现的基类。我们通常使用的是它的派生类例如boost::archive::text_oarchive用于输出序列化到文本格式。boost::archive::text_iarchive用于从文本格式输入反序列化。boost::archive::binary_oarchive/binary_iarchive用于二进制格式。boost::archive::xml_oarchive/xml_iarchive用于 XML 格式。1.2 、序列化函数serialize()要使一个类可序列化你需要为其定义一个serialize成员函数或一个独立的serialize自由函数。这个函数是boost::archive与你的类进行“对话”的桥梁。serialize函数通常接受两个参数一个 Archive 类型的引用。一个版本号unsigned int用于处理类的版本演化。在函数体内你使用操作符由 Archive 类重载来指定需要序列化的成员变量。这个操作符在序列化输出和反序列化输入时的行为是智能的。2、快速入门一个简单的例子让我们从一个最简单的例子开始序列化一个包含基本数据类型的结构体。#includefstream#includeiostream#includeboost/archive/text_oarchive.hpp#includeboost/archive/text_iarchive.hpp// 1. 包含序列化支持的头文件#includeboost/serialization/serialization.hpp// 2. 定义可序列化的类classPerson{public:Person()default;// 反序列化需要默认构造函数Person(std::string n,inta):name(n),age(a){}// 3. 声明序列化函数为友元使其能访问私有成员friendclassboost::serialization::access;// 4. 定义序列化函数模板templateclassArchivevoidserialize(Archivear,constunsignedintversion){arname;// 使用 操作符序列化每个成员arage;}voidprint()const{std::coutName: name, Age: agestd::endl;}private:std::string name;intage;};intmain(){// 创建对象Personalice(Alice,30);Person bob;std::coutBefore serialization:std::endl;alice.print();// --- 序列化到文件 ---{std::ofstreamofs(person.txt);// 创建文本输出存档并关联到文件流boost::archive::text_oarchiveoa(ofs);// 使用 操作符将对象写入存档oaalice;}// 作用域结束存档和文件流自动刷新并关闭// --- 从文件反序列化 ---{std::ifstreamifs(person.txt);boost::archive::text_iarchiveia(ifs);// 使用 操作符从存档读取对象iabob;}std::cout\nAfter deserialization:std::endl;bob.print();// 输出: Name: Alice, Age: 30return0;}代码解析包含头文件boost/archive/text_oarchive.hpp和.../text_iarchive.hpp分别用于文本格式的输出和输入存档。boost/serialization/serialization.hpp提供了基础支持。使类可序列化将boost::serialization::access声明为友元类这样serialize函数即使是模板就能访问类的私有成员。定义模板函数serialize(Archive ar, ...)。函数体内的ar member;语句是序列化的核心。对于输出存档oarchive它写入数据对于输入存档iarchive它读取数据。使用存档创建一个文件流ofstream/ifstream。实例化一个存档对象如text_oarchive并将文件流作为构造参数传入。使用操作符将对象序列化到存档或使用操作符从存档反序列化对象。运行此程序后会生成一个person.txt文件其内容类似于22 serialization::archive 19 0 0 5 Alice 30这些数字是 Boost.Serialization 库的内部格式信息。3、 不同存档格式详解boost::archive支持多种格式各有优劣适用于不同场景。3.1、 文本存档 (text_oarchive/text_iarchive)特点生成人类可读勉强可读的文本文件。便于调试因为你可以用文本编辑器查看序列化后的数据。缺点文件体积较大序列化/反序列化速度较慢。适用场景配置存储、需要人工检查数据的场景、跨平台且对大小不敏感的数据交换。3.2、 二进制存档 (binary_oarchive/binary_iarchive)特点生成紧凑的二进制文件。体积小速度快。缺点文件不可读且对平台字节序Endianness敏感。在不同字节序的机器间传输可能需要额外处理。适用场景高性能要求的本地存储、进程间通信、网络传输配合字节序处理。#includeboost/archive/binary_oarchive.hpp#includeboost/archive/binary_iarchive.hpp// 用法与文本存档完全相同只需替换类型名std::ofstreamofs(data.bin,std::ios::binary);boost::archive::binary_oarchiveoa(ofs);oamyObject;3.3、 XML 存档 (xml_oarchive/xml_iarchive)特点生成标准的 XML 文件。可读性最好易于被其他语言如 Python, Java或工具解析。缺点文件体积最大速度最慢。适用场景需要与其他系统交互、作为配置文件、需要人工编辑和验证的数据。#includeboost/archive/xml_oarchive.hpp#includeboost/archive/xml_iarchive.hpp// XML 存档需要为顶层对象指定一个名称std::ofstreamofs(data.xml);boost::archive::xml_oarchiveoa(ofs);oaboost::serialization::make_nvp(PersonObject,alice);// 使用 make_nvp 命名生成的data.xml文件会包含清晰的标签结构。4、序列化复杂数据类型4.1、 标准库容器 (std::vector,std::map, 等)Boost.Serialization 已经为大多数 STL 容器提供了开箱即用的支持只需包含对应的头文件。#includeboost/serialization/vector.hpp#includeboost/serialization/map.hpp#includeboost/serialization/string.hppclassCompany{std::vectorPersonemployees;std::mapint,std::stringprojects;// ...templateclassArchivevoidserialize(Archivear,constunsignedintversion){aremployees;arprojects;}};4.2 、继承和多态指针序列化序列化派生类对象并通过基类指针进行恢复是 Boost.Serialization 的强大功能之一。这需要使用BOOST_CLASS_EXPORT宏为每个可多态序列化的派生类注册一个唯一的标识符。在序列化和反序列化代码中使用boost::serialization::base_object来正确序列化基类部分。存档必须通过基类指针或引用来操作对象。#includeboost/serialization/export.hppclassShape{public:virtual~Shape()default;virtualvoiddraw()const0;private:friendclassboost::serialization::access;templateclassArchivevoidserialize(Archivear,constunsignedintversion){// 基类可能有一些数据成员}};classCircle:publicShape{public:Circle(doubler0.0):radius(r){}voiddraw()constoverride{std::coutCircle rradiusstd::endl;}private:doubleradius;friendclassboost::serialization::access;templateclassArchivevoidserialize(Archivear,constunsignedintversion){// 首先序列化基类部分arboost::serialization::base_objectShape(*this);arradius;}};// 关键注册派生类BOOST_CLASS_EXPORT(Circle)// 使用智能指针序列化#includememory#includeboost/serialization/shared_ptr.hppintmain(){std::shared_ptrShapeshapestd::make_sharedCircle(5.0);std::shared_ptrShapeloaded_shape;{std::ofstreamofs(shape.bin);boost::archive::binary_oarchiveoa(ofs);oashape;// 序列化基类指针实际存储的是 Circle}{std::ifstreamifs(shape.bin);boost::archive::binary_iarchiveia(ifs);ialoaded_shape;// 反序列化自动创建 Circle 对象}loaded_shape-draw();// 输出: Circle r5return0;}4.3 、版本控制当类的结构发生变化如增加、删除或重命名成员时版本控制至关重要。serialize函数的第二个参数version就是为此设计的。classMyClass{intoldData;std::string newData;// 在版本1中添加的成员templateclassArchivevoidserialize(Archivear,constunsignedintversion){aroldData;if(version1){arnewData;// 只有存档版本1时才序列化此成员}// 对于版本当前版本的情况可以在这里添加加载旧数据的逻辑}};// 告诉 Boost 这个类的当前版本号BOOST_CLASS_VERSION(MyClass,1)5、 高级技巧与最佳实践5.1、 拆分save和load对于非常复杂的类或者序列化和反序列化逻辑差异很大时可以将serialize拆分为独立的save和load函数。templateclassArchivevoidsave(Archivear,constunsignedintversion)const{ardata;}templateclassArchivevoidload(Archivear,constunsignedintversion){ardata;// 可以在这里做一些初始化工作}BOOST_SERIALIZATION_SPLIT_MEMBER()// 这个宏必须放在类定义末尾5.2、 序列化到内存缓冲区有时你需要将对象序列化到内存而不是文件例如用于网络发送。#includesstream#includeboost/archive/text_oarchive.hpp#includeboost/archive/text_iarchive.hppstd::stringstream ss;// 内存流// 序列化到字符串流{boost::archive::text_oarchiveoa(ss);oamyObject;}std::string serialized_strss.str();std::coutSerialized data: serialized_strstd::endl;// 从字符串流反序列化{std::stringstreamss2(serialized_str);boost::archive::text_iarchiveia(ss2);iamyRestoredObject;}5.3、性能优化使用二进制存档这是提升速度、减小体积最直接的方法。预分配容器大小对于std::vector等在load函数中可以先读取大小并reserve避免多次重新分配。避免序列化冗余数据只序列化真正需要持久化的状态数据计算得出的临时数据可以忽略。6、常见问题与陷阱缺少默认构造函数反序列化时对象是先默认构造然后通过load填充数据。因此可序列化的类通常需要一个公开或受保护的默认构造函数。指针和深拷贝序列化一个裸指针默认只保存它的地址值这通常不是你想要的结果。对于拥有所有权的指针应使用boost::serialization::shared_ptr或unique_ptr需要 C11 及以上支持来确保深拷贝和正确的内存管理。静态成员变量静态成员不属于对象状态不会被自动序列化。如果需要保存必须手动处理。循环引用对象图中存在循环引用时使用shared_ptr可以正确序列化和反序列化避免内存泄漏。跨平台兼容性二进制存档在 x86 和 ARM 等不同字节序的机器间不兼容。解决方案是使用文本或 XML 存档或者在序列化前统一转换为网络字节序。编译器与 Boost 版本尽量保证序列化和反序列化两端使用相同版本的编译器和 Boost 库特别是对于复杂的模板类。7、总结boost::archive作为 Boost.Serialization 库的引擎为 C 提供了工业级、非侵入式的序列化能力。通过定义简单的serialize函数开发者可以轻松地将复杂的对象图持久化到文件、内存或网络。核心优势类型安全在编译期检查序列化逻辑。非侵入式可以通过友元或自由函数为第三方类添加序列化支持无需修改其源码。高度可扩展支持自定义存档格式、序列化优化和版本管理。与 STL 深度集成标准容器和智能指针都能完美工作。在选择存档格式时应根据需求权衡调试/互操作→ 选XML或文本。性能/存储空间→ 选二进制。二、使用步骤1、下载库访问链接https://www.boost.org/2、Visual Studio新建工程3、将源码解压到工程目录下新建一个main.cpp文件将下载的压缩包解压到main.cpp同级目录并改名为boost4、添加路径5、测试代码#includeiostream#includefstream#includestring#includevector#includeboost/serialization/string.hpp#includeboost/serialization/vector.hpp#includeboost/serialization/access.hpp#includeboost/archive/binary_oarchive.hpp#includeboost/archive/binary_iarchive.hppusingnamespacestd;// // 1. 自定义结构体可序列化// structStudent{intid;string name;vectorintscores;// 让 boost 能访问私有成员friendclassboost::serialization::access;// 序列化函数固定写法templateclassArchivevoidserialize(Archivear,constunsignedintversion){arid;// 序列化/反序列化 idarname;// 序列化/反序列化 namearscores;// 序列化/反序列化 vector}};// // 2. 序列化对象 → 文件// voidsave(constStudents,conststringfilename){ofstreamofs(filename,ios::binary);boost::archive::binary_oarchiveoa(ofs);oas;// 写入对象cout序列化完成endl;}// // 3. 反序列化文件 → 对象// voidload(Students,conststringfilename){ifstreamifs(filename,ios::binary);boost::archive::binary_iarchiveia(ifs);ias;// 读取对象cout反序列化完成endl;}// // 主函数测试// intmain(){// 1. 创建测试对象Student stu;stu.id1001;stu.name张三;stu.scores{90,85,95};// 2. 序列化到文件save(stu,student.dat);// 3. 清空反序列化回来Student stu2;load(stu2,student.dat);// 4. 输出验证coutID: stu2.idendl;cout姓名: stu2.nameendl;cout成绩: ;for(intx:stu2.scores)coutx ;coutendl;return0;}运行结果序列化完成 反序列化完成 ID:1001姓名:张三 成绩:908595C:\Users\徐鹏\Desktop\新建文件夹\Project2\x64\Debug\Project2.exe(进程3160)已退出代码为0(0x0)。 要在调试停止时自动关闭控制台请启用“工具”-“选项”-“调试”-“调试停止时自动关闭控制台”。 按任意键关闭此窗口...