第30篇 XML（四）使用流读写XML

导语

从Qt 4.3开始引入了两个新的类来读取和写入XML文档：QXmlStreamReader和QXmlStreamWriter。 QXmlStreamReader类提供了一个快速的解析器通过一个简单的流API来读取格式良好的XML文档，它是作为Qt的SAX解析器的替代品的身份出现的，因为它比SAX解析器更快更方便。QXmlStreamReader可以从QIODevice或者QByteArray中读取数据。流读取器的基本原理就是将XML文档报告为一个记号（tokens）流，这一点与SAX相似，而它们的不同之处在于XML记号被报告的方式。在SAX中，应用程序必须提供处理器（回调函数）来从解析器获得所谓的XML事件；而对于QXmlStreamReader，是应用程序代码自身来驱动循环，在需要的时候可以从读取器中一个接一个的拉出记号。这个是通过调用readNext()函数实现的，它可以读取下一个记号，然后返回一个记号类型，然后可以使用isStartElement()和text()等函数来判断这个记号是否包含我们需要的信息。使用这种主动拉取记号的方式的最大的好处就是可以构建递归解析器，也就是可以在不同的函数或者类中来处理XML文档中的不同记号。

环境：Windows Xp + Qt 4.8.4+Qt Creator2.6.2

目录

• 一、解析XML文档
• 二、写入XML文档

正文

一、解析XML文档

1．新建Qt控制台应用，项目名称为myXmlStream，完成后将myXmlStream.pro文件的第一行代码更改为：

QT       += core  xml

然后保存该文件。

2．然后打开main.cpp文件，将内容更改如下：

#include <QCoreApplication>
#include <QFile>
#include <QXmlStreamReader>
#include <QXmlStreamWriter>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
    QFile file("../myXmlStream/my.xml");
    if (!file.open(QFile::ReadOnly | QFile::Text))
    {
        qDebug()<<"Error: cannot open file";
        return 1;
    }

    QXmlStreamReader reader;

    // 设置文件，这时会将流设置为初始状态
    reader.setDevice(&file);

    // 如果没有读到文档结尾，而且没有出现错误
    while (!reader.atEnd()) {
        // 读取下一个记号，它返回记号的类型
        QXmlStreamReader::TokenType type = reader.readNext();

        // 下面便根据记号的类型来进行不同的输出
        if (type == QXmlStreamReader::StartDocument)
            qDebug() << reader.documentEncoding() 
                                           << reader.documentVersion();
        if (type == QXmlStreamReader::StartElement) {
            qDebug() << "<" << reader.name() << ">";
            if (reader.attributes().hasAttribute("id"))
                qDebug() << reader.attributes().value("id");
        }
        if (type == QXmlStreamReader::EndElement)
            qDebug() << "</" << reader.name() << ">";
        if (type == QXmlStreamReader::Characters
                                     && !reader.isWhitespace())
            qDebug() << reader.text();
    }

    // 如果读取过程中出现错误，那么输出错误信息
    if (reader.hasError()) {
        qDebug() << "error: " << reader.errorString();
    }

    file.close();

    return a.exec();
}

可以看到流读取器就是在一个循环中通过使用readNext()来不断读取记号的，这里可以对不同的记号和不同的内容进行不同的处理，既可以在本函数中进行，也可以在其他函数或者其他类中进行。可以将前面生成的my.xml文件复制到源码目录，然后运行程序，查看效果。

二、写入XML文档

与QXmlStreamReader对应的是QXmlStreamWriter，它通过一个简单的流API提供了一个XML写入器。QXmlStreamWriter的使用是十分简单的，只需要调用相应的记号的写入函数来写入相关数据即可。

将前面主函数的内容更改为：

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
    QFile file("../myXmlStream/my2.xml");
    if (!file.open(QFile::WriteOnly | QFile::Text))
    {
       qDebug() << "Error: cannot open file";
       return 1;
    }
    QXmlStreamWriter stream(&file);
    stream.setAutoFormatting(true);
    stream.writeStartDocument();
    stream.writeStartElement("bookmark");
    stream.writeAttribute("href", "http://qt.nokia.com/");
    stream.writeTextElement("title", "Qt Home");
    stream.writeEndElement();
    stream.writeEndDocument();
    file.close();
    qDebug() << "write finished!";
    return a.exec();
}

这里使用了setAutoFormatting(true)函数来自动设置格式，这样会自动换行和添加缩进。然后使用了writeStartDocument()，该函数会自动添加首行的XML说明（即<?xmlversion="1.0" encoding="UTF-8"?>），添加元素可以使用writeStartElement()，不过，这里要注意，一定要在元素的属性、文本等添加完成后，使用writeEndElement()来关闭前一个打开的元素。在最后使用writeEndDocument()来完成文档的写入。现在大家可以运行程序了，这时会在项目目录中生成一个XML文档。

结语

数据库和XML在很多程序中都经常用到，它们的使用也总是和数据的显示联系起来，所以学习好数据库的知识也是很重要的，它们可以说是密不可分的。相关内容，大家也可以参考《Qt Creator快速入门》的相关章节以及《Qt 及Qt Quick开发实战精解》的数据管理系统的例子，里面同时应用了数据库和XML。