Qt：QDom解析XML总结 Qt+XML界面设计（上）

最近也是一直在用Qt+XML+qss开发界面，所以总结一下这套前端的架构模式。主要的构成就是用xml写出界面需要用到的控件以及布局，利用Qt中的QDom类对xml进行解析，解析并获取xml中参数后，创建Qt相关的控件，并且在qss中设计出具体的控件样式。最后得到一套完整的Qt+XML+qss界面架构模型，在整个模型中，界面的绘制直接依靠xml去实现即可，少部分代码添加进解析程序中，复用性尚可。

目录

QDom简介

XML DOM节点

QDomDocument

QDomElement

QDomAttr

Qt读取XML的用法

---

QDom简介

QDom其实是Qt中一个很大的类，写一天可能也写不完，其中包含着QDomcument,QDomNode,QDomElement,QDomNodeList等类，这些类是实现解析出XML的关键。我们以这几个类为切入点介绍这个QDom里面的各个类的复杂关系网。

DOM是Document Object Model的简写，即XML文档对象模型，是由W3C提出的一种处理XML文档的标准接口。

 DOM 一次性读入整个XML文档，在内存中构造为一棵树（DOM树）将XML文件表示成一棵树，便于随机访问其中的节点，但消耗内存相对多一些。能够在这棵树上进行导航，比如移动到下一节点或者返回上一节点，也可以对这棵树进行修改，或者是直接将这颗树保存为硬盘上的一个 XML 文件。

• XML DOM节点

XML 文档中的每个成分都是一个节点,整个文档是一个文档节点,每个XML 标签是一个元素节点,包含在XML元素中的文本是文本节点, 每一个XML属性是一个属性节点,注释属于注释节点。

QDomDocument

该QDomDocument类表示XML文档。

该QDomDocument类代表整个XML文档。从概念上讲，它是文档树的根，并提供对文档数据的主要访问。

由于元素，文本节点，注释，处理指令等不能在文档上下文之外存在，因此文档类还包含创建这些对象所需的工厂功能。创建的节点对象具有ownerDocument()函数，该函数将它们与在其上下文中创建的文档相关联。最常使用的DOM类是QDomNode，QDomDocument，QDomElement和QDomText。

解析的XML在内部由对象树表示，可以使用各种QDom类访问这些对象。所有QDom类仅引用内部树中的对象。一旦删除引用了它们的最后一个QDom对象和QDomDocument本身，DOM树中的内部对象将被删除。

元素，文本节点等的创建是使用此类中提供的各种工厂功能完成的。使用QDom类的默认构造函数只会导致无法操纵或将其插入Document的空对象。

• QDomDocument成员函数

 

QDomDocument::QDomDocument(const QString &name)

构造函数

QDomAttr QDomDocument::createAttribute(const QString &name)

创建一个能够插入到元素的名为name的新属性

QDomCDATASection QDomDocument::createCDATASection(const QString &value)

创建一个能插入文档的值为value的新CDATA段

QDomComment QDomDocument::createComment(const QString &value)

创建一个能插入文档的值为value的新注释

QDomDocumentFragment QDomDocument::createDocumentFragment()

创建一个持有文档部分内容的文档段

QDomElement QDomDocument::createElement(const QString &tagName)

创建一个能插入DOM树的名为tagName的新元素

QDomElement QDomDocument::createElementNS(const QString &nsURI, const QString &qName)

创建一个能插入DOM树的支持命名空间的名为qName的新元素，命名空间为nsURI

QDomEntityReference QDomDocument::createEntityReference(const QString &name)

创建一个能插入文档的名为name的新实体引用

QDomProcessingInstruction QDomDocument::createProcessingInstruction(const QString &target, const QString &data)

创建一个能插入文档的新的说明，设置说明的目标为target，数据为data

QDomText QDomDocument::createTextNode(const QString &value)

创建一个能插入文档树的值为value的新文本节点

QDomDocumentType QDomDocument::doctype() const

返回文档的文档类型

QDomElement QDomDocument::documentElement() const

返回文档的根元素

QDomElement QDomDocument::elementById(const QString &elementId)

返回ID为elementId的元素

QDomNodeList QDomDocument::elementsByTagName(const QString &tagname) const

返回包含tagname文档的所有元素的节点链表

QDomImplementation QDomDocument::implementation() const

返回QDomImplementation对象

QDomNode QDomDocument::importNode(const QDomNode &importedNode, bool deep)

从另一个文档导入importedNode节点到文档，如果deep为true，导入importedNode节点的子树，否则导入importedNode节点。

QDomNode::NodeType QDomDocument::nodeType() const

返回节点类型

bool QDomDocument::setContent(const QByteArray &data, bool namespaceProcessing, QString *errorMsg = Q_NULLPTR, int *errorLine = Q_NULLPTR, int *errorColumn = Q_NULLPTR)

从字节数组数据data解析XML文档，并设置为文档的内容

QByteArray QDomDocument::toByteArray(int indent = 1) const

返回解析后的文档的文本内容的UTF-8格式的字节数组数据

QString QDomDocument::toString(int indent = 1) const

返回解析后的文档的文本内容

QDomElement

QDomElement表示DOM树中的一个元素节点。元素有一个标签名和0个或多个属性。

• QDomElement成员函数

QString QDomElement::attribute(const QString &name, const QString &defValue = QString()) const

返回元素的名字为name的属性，如果不存在，返回defValue默认值

QDomAttr QDomElement::attributeNode(const QString &name)

返回元素中名字为name的属性的QDomAttr对象

QDomNamedNodeMap QDomElement::attributes() const

返回元素中所有属性的通过名字访问属性节点的集合

QDomNodeList QDomElement::elementsByTagName(const QString &tagname) const

返回元素名为tagname的元素的所有子节点的前序遍历的节点链表

bool QDomElement::hasAttribute(const QString &name) const

如果元素中有名字为name的属性，返回true

void QDomElement::removeAttribute(const QString &name)

删除元素中名字为name的属性

void QDomElement::setAttribute(const QString &name, const QString &value)

在元素中添加一个名字为name，值为value的属性，如果已经存在，使用value替换值

void QDomElement::setTagName(const QString &name)

设置元素的标签名为name

QString QDomElement::tagName() const

返回元素的标签名

QString QDomElement::text() const

返回元素的文本

QDomAttr

QDomAttr表示元素的属性

QString QDomAttr::name() const

返回属性的名字

QDomElement QDomAttr::ownerElement() const

返回属性所属的元素节点

void QDomAttr::setValue(const QString &v)

设置属性的值为v

bool QDomAttr::specified() const

如果属性已经由用户设置，返回true

QString QDomAttr::value() const

返回属性的值

Qt读取XML的用法

1 创建一个QDomDocument类对象，代表整个XML文档

QDomDocument doc;

2 使用QFile打开要读取得xml文档，使用QDomDocument类的setContent()函数来设置整个文档的内容，它会将XML解析成一个DOM树,并保存在内存中

QFile file("..\\myDOM1\\my.xml");
    if (!file.open (QIODevice::ReadOnly)) {
        qDebug() << "open file" << "my.xml" << "failed,error:" << file.errorString();
        return 0;
    }
    //将文件内容读到doc中
    if (! doc.setContent(&file)) {
        qDebug() << "parse file failed at line" << errLin << ",col" << errCol << "," << strError;
        file.close ();
        return 0;
    }
    file.close ();

3 获取根节点元素,QDomDocument类也是QDomNode的子类，使用firstChild()函数可以获得它的第一个子节点

//获得doc的第一个节点,即XML说明
QDomNode firstNode = doc.firstChild ();
qDebug() << qPrintable(firstNode.nodeName()) << qPrintable(firstNode.nodeValue ());

 使用documentElement()可以获得他的根节点，这是访问XML文档的入口，返回一个QDomElement的脆响，这也是QDomNode的子类

//返回根节点元素
QDomElement docElem = doc.documentElement();

 

后面就可以通过QDomNode来遍历整个文档

QDomNode的函数

firstChild()获得第一个子节点

lastChild()获得最后一个节点

childNodes()获取该节点的所有孩子节点的一个列表

nextSibling()获取下一个兄弟节点

previousSibling()获取前一个兄弟节点.

//返回根元素的第一个子节点
    QDomNode n=docElem.firstChild ();
    while (!n.isNull ()) {
        if (n.isElement ()) {
            //将其转换为元素
            QDomElement e = n.toElement ();
            //返回元素标记和id属性的值，tagName()来获取元素节点的标签名，attribute()来获取元素节点指定的属性的值，
            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 ()) {//使用text()来获取其中的文本内容
                    qDebug() << qPrintable(node.toElement().tagName ()) << qPrintable(node.toElement ().text ());
                }
            }
        }
        n = n.nextSibling ();//nextSibling()获取下一个兄弟节点
    }

void test::output()
{
	QFile data("../test1.xml");
	if (!data.open(QIODevice::ReadOnly))
	{
		qDebug() << "open failed" << data.errorString() << endl;
	}
	QDomDocument doc;
	QString errorInfo;
	int errorRow;
	int errorCol;
	if (!doc.setContent(&data, &errorInfo, &errorRow, &errorCol))
	{
		qDebug() << "error info:" << errorInfo << QString("errorRow:%1,errorCol:%2").arg(errorRow).arg(errorCol);
	}
	else
	{
		QDomNode firstChild = doc.firstChild();
		qDebug() << firstChild.nodeName();
		qDebug() << firstChild.nodeValue();

		QMap<QString, QString>dataMap;

		QDomElement rootElemtent = doc.documentElement();
		qDebug() << rootElemtent.tagName();
		qDebug() << rootElemtent.text();

		QDomNode childNode = rootElemtent.firstChild();
		qDebug() << childNode.nodeName();
		qDebug() << childNode.nodeValue();
		while (!childNode.isNull())
		{
			if (childNode.isElement())
			{
				QDomElement element = childNode.toElement();
				QDomNodeList nodeList = element.childNodes();
				for (int i = 0; i < nodeList.count(); i++)
				{
					QDomNode node = nodeList.at(i);
					qDebug() << node.nodeName();
					qDebug() << node.toElement().tagName();
					qDebug() << node.toElement().text();
					dataMap.insert(node.toElement().tagName(), node.toElement().text());
				}
			}
			childNode.nextSibling();
		}
	}
}

最后来测试一下这些都对应的哪些东西：把右边的xml文件导入到程序中即可拆成左边的节点名称了，在初始化qt的控件就可以了。