QXmlStreamReader、QXmlStreamWriter和QDomElement区别

原创于 2025-10-23 14:45:41 发布 · 925 阅读

14 ·

CC 4.0 BY-SA版权

文章标签：

#c++ #Qt

Qt 专栏收录该内容

36 篇文章

订阅专栏

Qt 框架中这三个用于处理 XML 的核心类：QXmlStreamReader、QXmlStreamWriter 和 QDomElement。它们代表了两种截然不同的 XML 处理哲学。

核心区别概览

特性	QXmlStreamReader / QXmlStreamWriter	QDomElement
处理模型	基于流（Push/Pull）	基于树（DOM）
内存使用	极低，一次只处理一个节点	高，整个 XML 文档被加载到内存树中
访问方式	顺序、只读（Reader）	随机访问，可任意读写节点
性能	非常高，适合处理大文件	较低，大文件会消耗大量内存和时间
易用性	中等，需要手动控制读取状态	高，API 直观，类似操作树结构
修改 XML	不能直接修改，需用 Writer 重新生成	可以直接修改节点内容、属性和结构

详细介绍

1. QXmlStreamReader（基于流的读取器）

哲学：像用望远镜读一个很长的卷轴，你一次只能看到当前的一小部分，但可以非常快地从头读到尾。

工作原理：

它逐个读取 XML 令牌，如 StartDocument、StartElement、Characters（文本）、EndElement、EndDocument 等。
你通过一个循环来驱动读取过程，并检查当前的 tokenType() 来决定如何处理。
它是只读和单向的，一旦读过某个节点，就无法再回去访问它（除非重新开始）。

核心优势：

内存效率极高：无论 XML 文件有多大（几个GB），它都只占用常量级别的内存，因为它不会在内存中构建整个文档的映像。
速度快：没有构建树结构的开销。

典型使用场景：

解析从网络下载的大型 XML 数据（如 RSS 订阅、大型数据库导出文件）。
读取配置文件（虽然 QSettings 更常用，但对于复杂结构，XML 是选择之一）。
任何你只需要顺序读取并提取数据，而不需要随机访问或修改的场合。

代码示例：

QFile file("data.xml");
file.open(QIODevice::ReadOnly);
QXmlStreamReader reader(&file);

while (!reader.atEnd()) {
    QXmlStreamReader::TokenType type = reader.readNext();
    
    if (type == QXmlStreamReader::StartElement) {
        // 遇到开始标签
        QString elementName = reader.name().toString();
        
        if (elementName == "book") {
            // 读取元素的属性
            QString id = reader.attributes().value("id").toString();
            qDebug() << "Found book with id:" << id;
        } else if (elementName == "title") {
            // 读取下一个令牌，它应该是文本内容
            reader.readNext();
            qDebug() << "Title is:" << reader.text().toString();
        }
    }
}
if (reader.hasError()) {
    qDebug() << "XML error:" << reader.errorString();
}
file.close();

2. QXmlStreamWriter（基于流的写入器）

哲学：像一个抄写员，你告诉他“开始写一个元素，写属性，写文本，结束元素”，他按顺序一笔一划地写下去。

工作原理：

你通过调用一系列方法（如 writeStartElement(), writeAttribute(), writeTextElement(), writeEndElement()）来按顺序生成 XML。
它负责确保生成的 XML 格式良好（例如，正确关闭标签）。
它不会修改已有的 XML，而是从头开始创建一个新的 XML 流。

核心优势：

内存效率高：和 Reader 一样，它在写入过程中不需要在内存中构建整个文档树。
速度快：直接写入输出设备（如文件、网络套接字）。

典型使用场景：

导出大量数据为 XML 格式。
生成要发送到网络服务的 XML 请求。
与 QXmlStreamReader 配对使用，用于转换或过滤 XML 数据。

代码示例：

QFile file("output.xml");
file.open(QIODevice::WriteOnly);
QXmlStreamWriter writer(&file);
writer.setAutoFormatting(true); // 让输出的 XML 有缩进，更易读

writer.writeStartDocument();
writer.writeStartElement("library");
    writer.writeStartElement("book");
    writer.writeAttribute("id", "1");
        writer.writeTextElement("title", "Qt Programming");
        writer.writeTextElement("author", "Max Master");
    writer.writeEndElement(); // 结束 book
    writer.writeStartElement("book");
    writer.writeAttribute("id", "2");
        writer.writeTextElement("title", "Advanced C++");
        writer.writeTextElement("author", "Alex Expert");
    writer.writeEndElement(); // 结束 book
writer.writeEndElement(); // 结束 library
writer.writeEndDocument();

file.close();

3. QDomElement（文档对象模型元素）

哲学：像把一个乐高模型整个拆开，把所有零件都摆在桌子上。你可以随意拿起、修改、移动或组合任何一个零件。

工作原理：

首先使用 QDomDocument 将整个 XML 文档加载到内存中，形成一个节点树。
QDomElement 是这棵树中的一个节点。你可以通过它来访问其父节点、子节点、兄弟节点、属性和文本。
整个树结构都保留在内存中，允许你进行随机、全方位的访问和修改。

核心优势：

API 直观易用：操作方式非常符合人们对“文档树”的直觉。
功能强大：可以轻松地进行复杂的查询、修改、插入和删除操作。

主要缺点：

内存消耗大：整个 XML 树都存储在内存中，对于大文件来说，这可能是个问题。
解析速度慢：构建整个 DOM 树需要时间和内存。

典型使用场景：

处理小的、结构复杂的 XML 配置文件。
需要频繁修改 XML 结构或内容的应用程序。
需要随机访问文档中不同部分的场景（例如，根据 ID 查找特定元素）。
对性能要求不苛刻，但追求开发效率的场合。

代码示例：

QFile file("data.xml");
file.open(QIODevice::ReadOnly);
QDomDocument doc;
doc.setContent(&file); // 整个文档被解析并加载到内存树中
file.close();

// 获取根元素
QDomElement root = doc.documentElement();
// 查找所有 "book" 标签
QDomNodeList books = root.elementsByTagName("book");

for (int i = 0; i < books.count(); ++i) {
    QDomElement book = books.at(i).toElement();
    // 读取属性
    QString id = book.attribute("id");
    // 获取第一个 "title" 子元素的文本
    QString title = book.firstChildElement("title").text();
    qDebug() << "Book" << id << "title is:" << title;
    
    // 修改：给每个 book 添加一个 price 元素
    QDomElement priceElem = doc.createElement("price");
    QDomText priceText = doc.createTextNode("29.99");
    priceElem.appendChild(priceText);
    book.appendChild(priceElem); // 直接修改内存中的树
}

// 将修改后的 DOM 树写回文件
file.open(QIODevice::WriteOnly);
QTextStream out(&file);
doc.save(out, 4); // 缩进为 4
file.close();

总结与如何选择

追求性能和内存效率，处理大文件，只需读取？
-> 选择 QXmlStreamReader。
需要生成（写入）大的 XML 文件？
-> 选择 QXmlStreamWriter。
需要频繁、随机地修改 XML 的结构和内容，且文件不大？
-> 选择 QDomElement（和 QDomDocument）。
需要同时满足高性能和随机访问？
- 可以考虑在 QXmlStreamReader 中只提取关键信息（如 ID）并建立索引，然后有选择地处理。
- 或者考虑其他第三方库，如 SAX 解析器（Qt 的旧版 QXmlSimpleReader 也属于此类），但 StreamReader 通常是 Qt 中的首选流式解析器。