第27篇 XML（一）使用DOM读取XML文档
使用DOM读取XML文档版权声明该文章原创于Qter开源社区（www.qter.org），作者yafeilinux，转载请注明出处！
导语XML(ExtensibleMarkup Language，可扩展标记语言)，是一种类似于HTML的标记语言，但它的设计目的是用来传输数据，而不是显示数据。XML的标签没有被预定义，用户需要在使用时自行进行定义。XML是W3C（万维网联盟）的推荐标准。相对于数据库表格的二维表示，XML使用的树形结构更能表现出数据的包含关系，作为一种文本文件格式，XML简单明了的特性使得它在信息存储和描述领域非常流行。 在Qt中提供了QtXml模块来进行XML文档的处理，我们在Qt帮助中输入关键字QtXml Module，可以看到该模块的类表。这里主要提供了三种解析方法： DOM方法，可以进行读写；SAX方法，可以进行读取；基于流的方法，分别使用QXmlStreamReader和QXmlStreamWriter进行读取和写入。要在项目中使用QtXml模块，还需要在项目文件（.pro文件）中添加QT += xml一行代码。这一节我们先来讲解一下DOM的方法。
环境：Windows Xp + Qt 4.8.4+QtCreator 2.6.2
目录一、XML文档示例二、使用DOM读取XML文档内容
正文
一、XML文档示例下面是一个规范的XML文档：
<?xml version="1.0" encoding="UTF-8"?><library> <book id="01"> <title>Qt</title> <author>shiming</author> </book> <book id="02"> <title>Linux</title> <author>yafei</author> </book></library>
每个XML文档都由XML说明（或者称为XML序言）开始，它是对XML文档处理的环境和要求的说明，比如这里的<?xmlversion="1.0" encoding="UTF-8"?>，其中xml version=“1.0”，表明使用的XML版本号，这里字母是区分大小写的；encoding=“UTF-8”是使用的编码，指出文档是使用何种字符集建立的，默认值为Unicode编码。XML文档内容由多个元素组成，一个元素由起始标签<标签名>和终止标签</标签名>以及两个标签之间的内容组成，而文档中第一个元素被称为根元素，比如这里的<library></library>，XML文档必须有且只有一个根元素。元素的名称是区分大小写的，元素还可以嵌套，比如这里的library、book、title和author等都是元素。元素可以包含属性，用来描述元素的相关信息，属性名和属性值在元素的起始标签中给出，格式为<元素名 属性名=“属性值”>，如<book id=“01”>，属性值必须在单引号或者双引号中。在元素中可以包含子元素，也可以只包含文本内容，比如这里的<title>Qt</title>中的Qt就是文本内容。
二、使用DOM读取XML文档内容Dom（Document Object Model，即文档对象模型）把XML文档转换成应用程序可以遍历的树形结构，这样便可以随机访问其中的节点。它的缺点是需要将整个XML文档读入内存，消耗内存较多。在Qt中使用QDomProcessingInstruction类来表示XML说明，元素对应QDomElement类，属性对应QDomAttr类，文本内容由QDomText类表示。所有的DOM节点，比如这里的说明、元素、属性和文本等，都使用QDomNode来表示，然后使用对应的isProcessingInstruction()、isElement()、isAttr()和isText()等函数来判断是否是该类型的元素，如果是，那么就可以使用toProcessingInstruction()、toElement()、toAttr()和toText()等函数转换为具体的节点类型。 下面来演示一个例子，将读取前面介绍的XML文档的内容。
1.新建Qt控制台应用，项目名称为myDom。
2.完成后打开myDom.pro项目文件，将第一行代码更改为：QT += core xml 然后保存该文件。
3.打开main.cpp文件，更改内容如下：#include <QCoreApplication>
#include <QtXml>
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
// 新建QDomDocument类对象，它代表一个XML文档
QDomDocument doc;
// 建立指向“my.xml”文件的QFile对象
QFile file("my.xml");
// 以只读方式打开
if (!file.open(QIODevice::ReadOnly)) return 0;
// 将文件内容读到doc中
if (!doc.setContent(&file))
{ file.close(); return 0; }
// 关闭文件
file.close();
// 获得doc的第一个节点，即XML说明
QDomNode firstNode = doc.firstChild();
// 输出XML说明
qDebug() << firstNode.nodeName() << firstNode.nodeValue();
return a.exec();
}
4.然后先点击一下Qt Creator左下角的锤子图标来构建项目，这样会在源码目录旁生成构建目录，比如这里是myDom-build-桌面-Debug，我们进入该目录，然后新建一个文本文档，如下图所示。
下面将其文件名更改为my.xml，注意一定要更改扩展名，一些电脑中扩展名可能自动隐藏了，可以去“工具→文件夹选项→查看”中修改。提示信息选择“是”即可。如下图所示。
更改完成后使用记事本打开my.xml文件，然后将前面的xml文档内容添加进去，保存退出即可。如下图所示。
5.现在运行程序，效果如下图所示。
如果大家不愿意看到字符串两边的引号，可以将源码中得qDebug()语句更改如下：qDebug() << qPrintable(firstNode.nodeName()) << qPrintable(firstNode.nodeValue()); 运行程序，效果如下图所示。
6.下面在main()函数的return a.exec();一行代码前继续添加如下代码：QDomElement docElem = doc.documentElement();//返回根元素QDomNode n = docElem.firstChild(); //返回根节点的第一个子节点//如果节点不为空while(!n.isNull()){ if (n.isElement())//如果节点是元素 { QDomElement e = n.toElement();//将其转换为元素 qDebug() << qPrintable(e.tagName()) //返回元素标记 << qPrintable(e.attribute("id"));//返回元素id属性的值 } n = n.nextSibling();//下一个兄弟节点}这里使用了firstChild()函数和nextSibling()函数，然后利用while()循环来实现对所有子元素的遍历。运行程序，效果如下图所示。
7.下面更改源码中得if()语句的内容，输出所有子节点的内容：if (n.isElement())//如果节点是元素{ QDomElement e = n.toElement(); qDebug() << qPrintable(e.tagName()) << qPrintable(e.attribute("id")); // 获得元素e的所有子节点的列表 QDomNodeList list = e.childNodes(); // 遍历该列表 for(int i=0; i<list.count(); i++) { QDomNode node = list.at(i); if(node.isElement()) qDebug() << " " << qPrintable(node.toElement().tagName()) <<qPrintable(node.toElement().text()); }}这里使用了childNodes()函数获得了元素所有子节点的列表，然后通过遍历这个列表实现了遍历其所有子元素。运行程序，效果如下图所示。
结语通过上面的例子，我们实现了对一个XML文档的读取。可以看到，在QDom中，是将整个XML文件读到内存中的doc对象中的。然后使用节点（QDomNode ）操作doc对象，像XML说明，元素，属性，文本等等都被看做是节点，这样就使得操作XML文档变得很简单，我们只需通过转换函数将节点转换成相应的类型，如QDomElement e =n.toElement();在下一节我们将讲述XML文件的创建和写入。
涉及到的源码：
上一篇：第26篇 数据库（六）SQL关系表格模型QSqlRelationalTableModel
下一篇： 第28篇 XML（二）使用DOM创建和操作XML文档
返回：系列教程目录
非常好的文章，学习中:) 为什么#include <QtXml>这个头文件添加不了 夏叫兽 发表于 2013-5-27 22:49 static/image/common/back.gif
为什么#include 这个头文件添加不了
你在pro项目文件中添加 QT += xml 了吗？ yafeilinux 发表于 2013-5-27 23:20 static/image/common/back.gif
你在pro项目文件中添加 QT += xml 了吗？
按你教程里是 QT +=corexml，现在看的话可能是你的笔误吧，呵呵。 夏叫兽 发表于 2013-5-28 19:33 static/image/common/back.gif
按你教程里是 QT +=corexml，现在看的话可能是你的笔误吧，呵呵。
不是啊。QT += core是默认就有的，core是核心模块；
然后我们又加了一个xml模块，其实就是再写一行QT+= xml
这里只是把两个写在了一起，就是QT += core xml了，两个中间有个空格。 为什么我用这个代码出来的串口什么字符都没有 调味料 发表于 2013-6-13 20:44 static/image/common/back.gif
为什么我用这个代码出来的串口什么字符都没有
下载后面的源码运行的吗？ yafeilinux 发表于 2013-6-13 21:55 static/image/common/back.gif
下载后面的源码运行的吗？
是的，出来一个窗口 什么字符都没有 调味料 发表于 2013-6-13 22:04 static/image/common/back.gif
是的，出来一个窗口 什么字符都没有
你需要按照第4步，将写好的xml文件放里面啊，不然当然没有东西显示了。 yafeilinux 发表于 2013-6-13 22:06 static/image/common/back.gif
你需要按照第4步，将写好的xml文件放里面啊，不然当然没有东西显示了。
已经放了好的，这个我当然知道。 但是还是不显示 调味料 发表于 2013-6-13 22:21 static/image/common/back.gif
已经放了好的，这个我当然知道。 但是还是不显示
那就不应该了啊，自己调试一下吧，看看是哪里的问题！这些代码在很多版本上测试都是没有问题的。最有可能的错误还是xml文件放错位置了。 yafeilinux 发表于 2013-6-13 22:35 static/image/common/back.gif
那就不应该了啊，自己调试一下吧，看看是哪里的问题！这些代码在很多版本上测试都是没有问题的。最有可能 ...
同样的情况什么都显示不出来
sj小新 发表于 2013-8-15 12:40 static/image/common/back.gif
同样的情况什么都显示不出来
应该是文件生成和路径问题，如果xml文件创建正确了，应该可以读出的。
先学习下一节吧，那里面是用代码自动生成xml文档的，应该不会出错了，回头再看看这里是哪里出错了。
也可以下载源码测试。 <?xml version="1.0"encoding="UTF-8"?>
encoding 前需要加空格 就可以了 noway 发表于 2013-8-19 21:49 static/image/common/back.gif
encoding 前需要加空格 就可以了
:lol谢谢分享。果然有效 noway 发表于 2013-8-19 21:49 static/image/common/back.gif
encoding 前需要加空格 就可以了
确实有效，但是初学者不知道为什么这样 渤海之子 发表于 2014-4-23 16:29 static/image/common/back.gif
确实有效，但是初学者不知道为什么这样
这只是由于这个网页排版的问题，少了空格。原本是有空格的。 请版主尽快修改下XML文件代码，第一行<?xml version="1.0"encoding="UTF-8"?>的encoding前应该有个空格，要不然下载的程序业运行不了，控制台一闪而过 oudiqianbi 发表于 2014-10-22 16:09 static/image/common/back.gif
请版主尽快修改下XML文件代码，第一行的encoding前应该有个空格，要不然下载的程序业运行不了，控制台一闪 ...
嗯。这个是发帖的时候格式问题，大家可以下载源码测试。
页:
[1]
2