在C++程序运行过程中，经常会产生一些需要长期保存的动态配置项，比如用户自定义的界面参数、功能开关状态、连接配置信息等，将这些内容持久化到XML文件中是常见且实用的方案。TinyXML作为轻量级的XML解析库，能够很便捷地完成XML文件的创建、节点和属性的操作，非常适合处理这类简单配置场景。
TinyXML环境准备
首先需要获取TinyXML的源码，将tinyxml.h、tinyxml.cpp、tinyxmlerror.cpp、tinyxmlparser.cpp四个文件加入到自己的项目工程中，编译时一起参与编译即可，不需要额外的依赖库。如果是使用CMake管理项目，也可以将这几个源文件直接加入add_executable的源文件列表中。
动态配置项持久化核心思路
持久化动态配置项到XML的核心流程分为两步：
- 写入配置：程序运行时获取动态配置项的值，创建或打开XML文件，生成对应的XML节点和属性，将配置值赋值给属性，最后保存文件。
- 读取配置：程序启动时打开XML文件，定位到对应的配置节点，读取属性值，赋值给程序中的配置变量。
XML属性写入实现
下面是将动态配置项写入XML的示例代码，假设我们要保存三个配置项：窗口宽度、窗口高度、是否开启日志功能。
#include <iostream>
#include "tinyxml.h"
// 写入动态配置到XML文件
bool WriteConfigToXml(int winWidth, int winHeight, bool enableLog) {
// 创建XML文档对象
TiXmlDocument doc;
// 创建声明节点
TiXmlDeclaration* decl = new TiXmlDeclaration("1.0", "utf-8", "");
doc.LinkEndChild(decl);
// 创建根节点
TiXmlElement* root = new TiXmlElement("Config");
doc.LinkEndChild(root);
// 创建窗口配置子节点
TiXmlElement* winNode = new TiXmlElement("Window");
// 设置属性，保存动态配置值
winNode->SetAttribute("width", winWidth);
winNode->SetAttribute("height", winHeight);
root->LinkEndChild(winNode);
// 创建日志配置子节点
TiXmlElement* logNode = new TiXmlElement("Log");
logNode->SetAttribute("enable", enableLog ? "true" : "false");
root->LinkEndChild(logNode);
// 保存文件
bool ret = doc.SaveFile("config.xml");
if (!ret) {
std::cerr << "保存配置文件失败" << std::endl;
return false;
}
return true;
}
int main() {
// 模拟程序运行时的动态配置值
int dynamicWinWidth = 1280;
int dynamicWinHeight = 720;
bool dynamicEnableLog = true;
// 调用写入函数
if (WriteConfigToXml(dynamicWinWidth, dynamicWinHeight, dynamicEnableLog)) {
std::cout << "配置写入成功" << std::endl;
}
return 0;
}
运行上述代码后，会生成config.xml文件，内容如下：
<?xml version="1.0" encoding="utf-8" ?>
<Config>
<Window width="1280" height="720" />
<Log enable="true" />
</Config>
XML属性读取实现
接下来是读取XML中配置项到程序变量的代码，对应上面的写入逻辑：
#include <iostream>
#include <string>
#include "tinyxml.h"
// 从XML文件读取配置到变量
bool ReadConfigFromXml(int& winWidth, int& winHeight, bool& enableLog) {
TiXmlDocument doc;
// 加载XML文件
if (!doc.LoadFile("config.xml")) {
std::cerr << "加载配置文件失败" << std::endl;
return false;
}
// 获取根节点
TiXmlElement* root = doc.RootElement();
if (root == nullptr) {
std::cerr << "配置文件根节点不存在" << std::endl;
return false;
}
// 读取窗口配置
TiXmlElement* winNode = root->FirstChildElement("Window");
if (winNode != nullptr) {
winNode->QueryIntAttribute("width", &winWidth);
winNode->QueryIntAttribute("height", &winHeight);
}
// 读取日志配置
TiXmlElement* logNode = root->FirstChildElement("Log");
if (logNode != nullptr) {
const char* enableStr = logNode->Attribute("enable");
if (enableStr != nullptr) {
enableLog = (std::string(enableStr) == "true");
}
}
return true;
}
int main() {
// 定义配置变量
int winWidth = 0;
int winHeight = 0;
bool enableLog = false;
// 调用读取函数
if (ReadConfigFromXml(winWidth, winHeight, enableLog)) {
std::cout << "读取配置成功：" << std::endl;
std::cout << "窗口宽度：" << winWidth << std::endl;
std::cout << "窗口高度：" << winHeight << std::endl;
std::cout << "日志开关：" << (enableLog ? "开启" : "关闭") << std::endl;
}
return 0;
}
常见问题说明
属性值类型处理
TinyXML的属性值默认是字符串类型，数值类型的配置需要使用QueryIntAttribute、QueryDoubleAttribute等接口转换为对应类型，布尔值可以存储为true/false字符串再手动转换。
文件不存在的处理
读取配置时如果XML文件不存在，可以在程序中判断后使用默认配置，同时自动生成默认的配置文件，避免程序启动报错。
中文内容处理
如果需要保存中文配置项，需要注意XML文件的编码设置，建议统一使用UTF-8编码，同时TinyXML在读取时也能正确解析UTF-8格式的中文内容。