找回密码
 立即注册
收起左侧

第27篇 Qt5之XML(一)使用DOM读取XML文档

6
回复
18530
查看
[复制链接]
累计签到:1568 天
连续签到:1 天
来源: 2017-8-16 23:47:07 显示全部楼层 |阅读模式

版权声明

该文章原创于Qt开源社区(www.qter.org),作者yafeilinux,转载请注明出处!


导语


XML(ExtensibleMarkup Language,可扩展标记语言),是一种类似于HTML的标记语言,但它的设计目的是用来传输数据,而不是显示数据。XML的标签没有被预定义,用户需要在使用时自行进行定义。XML是W3C(万维网联盟)的推荐标准。相对于数据库表格的二维表示,XML使用的树形结构更能表现出数据的包含关系,作为一种文本文件格式,XML简单明了的特性使得它在信息存储和描述领域非常流行。
       在Qt中提供了Qt XML模块来进行XML文档的处理,这里主要提供了两种解析方法: DOM方法,可以进行读写;SAX方法,可以进行读取。从Qt 5开始,Qt XML模块不再进行维护,而是推荐使用Qt Core模块中基于流的方法,分别使用QXmlStreamReader和QXmlStreamWriter进行读取和写入。这一节我们先来讲解一下DOM的方法。要在项目中使用Qt XML模块,需要在项目文件(.pro文件)中添加QT += xml一行代码。


环境:Windows 7 + Qt 5.8.0(包含Qt Creator 4.2.1)



目录

一、XML文档示例
二、使用DOM读取XML文档内容




正文


一、XML文档示例

下面是一个规范的XML文档:


  1. <?xml version="1.0"encoding="UTF-8"?>
  2. <library>
  3.    <book id="01">
  4.        <title>Qt</title>
  5.        <author>shiming</author>
  6.    </book>
  7.    <book id="02">
  8.        <title>Linux</title>
  9.        <author>yafei</author>
  10.    </book>
  11. </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控制台应用QtConsole Application,项目名称为mydom。

2.完成后打开mydom.pro项目文件,将第一行代码更改为:

QT       += core xml

       然后保存该文件。

3.打开main.cpp文件,更改内容如下:
  1. #include <QCoreApplication>
  2. #include <QtXml>

  3. int main(int argc, char *argv[])
  4. {
  5.     QCoreApplication a(argc, argv);
  6.    
  7.     // 新建QDomDocument类对象,它代表一个XML文档
  8.     QDomDocument doc;
  9.     // 建立指向“my.xml”文件的QFile对象
  10.     QFile file("my.xml");
  11.     // 以只读方式打开
  12.     if (!file.open(QIODevice::ReadOnly)) return 0;
  13.     // 将文件内容读到doc中
  14.     if (!doc.setContent(&file)) { file.close(); return 0; }
  15.     // 关闭文件
  16.     file.close();
  17.     // 获得doc的第一个节点,即XML说明
  18.     QDomNode firstNode = doc.firstChild();
  19.     // 输出XML说明
  20.     qDebug() << firstNode.nodeName()
  21.              << firstNode.nodeValue();
  22.    
  23.     return a.exec();
  24. }
复制代码


4.然后先点击一下Qt Creator左下角的锤子图标来构建项目,这样会在源码目录旁生成构建目录,比如这里是build-mydom-Desktop_Qt_5_8_0_MinGW_32bit-Debug,我们进入该目录,然后新建一个文本文档,如下图所示。


       下面将其文件名更改为my.xml,注意一定要更改扩展名,一些电脑中扩展名可能自动隐藏了,可以去“工具→文件夹选项→查看”中修改。提示信息选择“是”即可。如下图所示。


       更改完成后使用记事本打开my.xml文件,然后将前面的xml文档内容添加进去,保存退出即可。如下图所示。




5.现在运行程序,效果如下图所示。


       如果大家不愿意看到字符串两边的引号,可以将源码中得qDebug()语句更改如下:

qDebug() << qPrintable(firstNode.nodeName())
             << qPrintable(firstNode.nodeValue());

       运行程序,效果如下图所示。



6.下面在main()函数的return a.exec();一行代码前继续添加如下代码:


  1. QDomElement docElem = doc.documentElement();  //返回根元素
  2. QDomNode n = docElem.firstChild();   //返回根节点的第一个子节点
  3. //如果节点不为空
  4. while(!n.isNull())
  5. {
  6.    if (n.isElement())  //如果节点是元素
  7.    {
  8.       QDomElement e = n.toElement();  //将其转换为元素
  9.       qDebug() << qPrintable(e.tagName())   //返回元素标记
  10.          << qPrintable(e.attribute("id"));  //返回元素id属性的值
  11.     }
  12.       n = n.nextSibling();  //下一个兄弟节点
  13. }
复制代码


这里使用了firstChild()函数和nextSibling()函数,然后利用while()循环来实现对所有子元素的遍历。运行程序,效果如下图所示。




7.下面更改源码中得if()语句的内容,输出所有子节点的内容:

  1. if (n.isElement())  //如果节点是元素
  2. {
  3.     QDomElement e = n.toElement();
  4.     qDebug() << qPrintable(e.tagName())
  5.             << qPrintable(e.attribute("id"));
  6.     // 获得元素e的所有子节点的列表
  7.     QDomNodeList list = e.childNodes();
  8.     // 遍历该列表
  9.     for(int i=0; i<list.count(); i++)
  10.     {
  11.        QDomNode node = list.at(i);
  12.        if(node.isElement())
  13.            qDebug() << "   " << qPrintable(node.toElement().tagName())
  14.                              <<qPrintable(node.toElement().text());
  15.     }
  16. }
复制代码


这里使用了childNodes()函数获得了元素所有子节点的列表,然后通过遍历这个列表实现了遍历其所有子元素。运行程序,效果如下图所示。




结语


通过上面的例子,我们实现了对一个XML文档的读取。可以看到,在QDom中,是将整个XML文件读到内存中的doc对象中的。然后使用节点(QDomNode )操作doc对象,像XML说明、元素、属性、文本等等都被看做是节点,这样就使得操作XML文档变得很简单,我们只需通过转换函数将节点转换成相应的类型,如:
QDomElement e =n.toElement();
在下一节我们将讲述XML文件的创建和写入。



源码下载:




本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x
回复

使用道具 举报

累计签到:18 天
连续签到:1 天
2017-8-31 22:01:49 显示全部楼层
firstchild那部分,我的qt读取不到<?xml version="1.0"encoding="UTF-8"?>,屏幕无显示。
删除这一行后,可以读到library
回复 支持 反对

使用道具 举报

累计签到:1568 天
连续签到:1 天
2017-8-31 22:24:07 显示全部楼层
kangyang94 发表于 2017-8-31 22:01
firstchild那部分,我的qt读取不到,屏幕无显示。
删除这一行后,可以读到library ...

下载源码试试。
回复 支持 反对

使用道具 举报

累计签到:18 天
连续签到:1 天
2017-9-1 10:34:24 显示全部楼层

源码也是无法读取<?xml version="1.0"encoding="UTF-8"?>这一行
回复 支持 反对

使用道具 举报

累计签到:1568 天
连续签到:1 天
2017-9-4 21:11:00 显示全部楼层
kangyang94 发表于 2017-9-1 10:34
源码也是无法读取这一行

你是不是xml文件有问题,试试这个吧

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x
回复 支持 反对

使用道具 举报

累计签到:9 天
连续签到:1 天
2017-9-29 10:02:38 显示全部楼层
<?xml version="1.0"encoding="UTF-8"?>
少了个空格 <?xml version="1.0" encoding="UTF-8"?>
1.0 和enconding之间要有个空格不然读不出来
回复 支持 反对

使用道具 举报

累计签到:1568 天
连续签到:1 天
2017-10-9 23:10:00 显示全部楼层
咸鱼不是雨 发表于 2017-9-29 10:02
少了个空格
1.0 和enconding之间要有个空格不然读不出来

嗯。本来有的,发帖的时候消失了。
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

公告
可以关注我们的微信公众号yafeilinux_friends获取最新动态,或者加入QQ会员群进行交流:190741849、186601429(已满) 我知道了