DOM是Document Object Model的简写,即XML文档对象模型,是由W3C提出的一种处理XML文档的标准接口。
DOM 一次性读入整个XML文档,在内存中构造为一棵树(DOM树)将XML文件表示成一棵树,便于随机访问其中的节点,但消耗内存相对多一些。能够在这棵树上进行导航,比如移动到下一节点或者返回上一节点,也可以对这棵树进行修改,或者是直接将这颗树保存为硬盘上的一个 XML 文件。
XML 文档中的每个成分都是一个节点,整个文档是一个文档节点,每个XML 标签是一个元素节点,包含在XML元素中的文本是文本节点, 每一个XML属性是一个属性节点,注释属于注释节点。
QT中使用QDomDocument来表示XML文档,QDomElement表示XML文档的元素,QDomProcessingInstruction表示XML处理指令,QDomAttr表示元素的属性,QDomText表示XML文档中的文本数据。所有的DOM节点如处理指令、元素、属性和文本数据等,都使用QDomNode来表示,然后使用对应的 isProcessingInstruction()、isElement()、isAttr()和isText()等函数来判断是否是该类型的节点,如果是,那么就可以使用toProcessingInstruction()、toElement()、toAttr()和toText()等函数转换为具体类型的节点。
文本数据总是存储在文本节点中,元素节点的文本数据是存储在文本节点中的。
QDomDocument类用于显示XML文档,是文档树的根节点,提供了对文档数据的主要访问。由于元素、文本节点、注释、说明等不能在文档外部,QDomDocument包含了创建这些对象的工厂函数。
需要解析的XML文档在内部显示为一棵被QDOM其它类访问的对象树。所有的QDOM类只能引用对象树中的对象。一旦或是QDomDocument根节点被删除,DOM树中的所有内部对象将被删除。
元素、文本节点等的创建由QDomDocument类提供的工厂函数完成。使用默认的QDOM类的构造函数只能得到一个不能操作、插入文档的空对象。
QDomDocument类有多个用于创建文档数据的函数,如createElement、createTextNode、createComment、createCDATASection、createProcessingInstruction、createAttribute和createEntityReference。这些函数中的一些支持命名空间的版本。createDocumentFragment函数为了持有文档中的部分内容,对于操作复杂文档是很有用的。
设置文档的整体内容使用setContent()函数。setContent函数通过XML文档和创建显示文档的DOM树来解析文档。
对于较大的XML文档,DOM树会占用较大的内存空间。对于较大的XML文档,使用QXmlStreamReader或QXmlQuery会使更好的解决方案。
QDomDocument::QDomDocument(const QString &name)
QDomDocument::QDomDocument(const QDomDocumentType &doctype)
QDomDocument::QDomDocument(const QDomDocument &x)
构造函数
QDomAttr QDomDocument::createAttribute(const QString &name)
创建一个能够插入到元素的名为name的新属性
QDomAttr QDomDocument::createAttributeNS(const QString &nsURI, const QString &qName)
创建一个能够插入到元素的支持命名空间的新属性,名字为qName,命名空间为nsURI
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文档的所有元素的节点链表
QDomNodeList QDomDocument::elementsByTagNameNS(const QString &nsURI, const QString &localName)
返回包含本地名为localName、命名空间为nsURI的文档的所有元素的节点链表
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文档,并设置为文档的内容
bool QDomDocument::setContent(const QString &text, bool namespaceProcessing, QString *errorMsg = Q_NULLPTR, int *errorLine = Q_NULLPTR, int *errorColumn = Q_NULLPTR)
从字符串text中读取XML文档,如果成功解析了内容,返回true
bool QDomDocument::setContent(QIODevice *dev, bool namespaceProcessing, QString *errorMsg = Q_NULLPTR, int *errorLine = Q_NULLPTR, int *errorColumn = Q_NULLPTR)
从设备dev中读取XML文档,如果成功解析了内容,返回true
bool QDomDocument::setContent(QXmlInputSource *source, bool namespaceProcessing, QString *errorMsg = Q_NULLPTR, int *errorLine = Q_NULLPTR, int *errorColumn = Q_NULLPTR)
从QXmlInputSource中读取XML文档,如果成功解析了内容,返回true
QByteArray QDomDocument::toByteArray(int indent = 1) const
返回解析后的文档的文本内容的UTF-8格式的字节数组数据
QString QDomDocument::toString(int indent = 1) const
返回解析后的文档的文本内容
QDomElement表示DOM树中的一个元素节点。元素有一个标签名和0个或多个属性。
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表示元素的属性
QString QDomAttr::name() const
返回属性的名字
QDomElement QDomAttr::ownerElement() const
返回属性所属的元素节点
void QDomAttr::setValue(const QString &v)
设置属性的值为v
bool QDomAttr::specified() const
如果属性已经由用户设置,返回true
QString QDomAttr::value() const
返回属性的值
DOM方式解析XML文件先打开XML文件,将XML文件整体加载到内存中建立DOM树,对于XML文档的任何操作在内存中的DOM树直接操作,最后保存时将DOM树的所有节点写回XML文档。需要注意的是,通常打开XML文件,将XML文件加载到内存中建立DOM树后,XML文件就可以关闭了。如果要保存改变后的XML文档内容,需要在保存时以清空文件的方式打开XML文件,将改变后DOM树的所有节点写入XML文件即可。
<?xml version="1.0" encoding="UTF-8"?>
<library>
<book time="2013/6/13" id="1">
<title>C++ primer</title>
<author>Stanley Lippman</author>
</book>
<book time="2007/5/25" id="2">
<title>Thinking in Java</title>
<author>Bruce Eckel</author>
</book>
</library>
读取的XML文件的代码如下:
//打开或创建文件 QFile file("test.xml"); if(!file.open(QFile::ReadOnly)) return; QDomDocument doc; //设置test.xml到文档 if(!doc.setContent(&file)) { file.close(); return; } file.close(); //返回根节点 QDomElement root=doc.documentElement(); qDebug()<<root.nodeName(); //获得第一个子节点 QDomNode node=root.firstChild(); while(!node.isNull()) //如果节点不空 { if(node.isElement()) //如果节点是元素 { //转换为元素 QDomElement e=node.toElement(); qDebug()<<e.tagName()<<" "<<e.attribute("id")<<" "<<e.attribute("time"); QDomNodeList list=e.childNodes(); for(int i=0;i<list.count();i++) { QDomNode n=list.at(i); if(node.isElement()) qDebug()<<n.nodeName()<<":"<<n.toElement().text(); } } //下一个兄弟节点 node=node.nextSibling(); }
//打开或创建文件 QFile file("test.xml"); //QIODevice::Truncate表示清空原来的内容 if(!file.open(QFile::WriteOnly|QFile::Truncate)) return; QDomDocument doc; //添加处理命令 QDomProcessingInstruction instruction; instruction=doc.createProcessingInstruction("xml", "version=\"1.0\" encoding=\"UTF-8\""); doc.appendChild(instruction); //添加根节点 QDomElement root=doc.createElement("library"); doc.appendChild(root); //添加第一个子节点及其子元素 QDomElement book=doc.createElement("book"); //方式一:创建属性 其中键值对的值可以是各种类型 book.setAttribute("id",1); //方式二:创建属性 值必须是字符串 QDomAttr time=doc.createAttribute("time"); time.setValue("2013/6/13"); book.setAttributeNode(time); QDomElement title=doc.createElement("title"); //创建子元素 QDomText text; //设置括号标签中间的值 text=doc.createTextNode("C++ primer"); book.appendChild(title); title.appendChild(text); QDomElement author=doc.createElement("author"); //创建子元素 text=doc.createTextNode("Stanley Lippman"); author.appendChild(text); book.appendChild(author); //添加节点book做为根节点的子节点 root.appendChild(book); //添加第二个子节点及其子元素 book=doc.createElement("book"); book.setAttribute("id",2); time=doc.createAttribute("time"); time.setValue("2007/5/25"); book.setAttributeNode(time); title=doc.createElement("title"); text=doc.createTextNode("Thinking in Java"); book.appendChild(title); title.appendChild(text); author=doc.createElement("author"); text=doc.createTextNode("Bruce Eckel"); author.appendChild(text); book.appendChild(author); root.appendChild(book); //输出到文件 QTextStream out_stream(&file); doc.save(out_stream,4); //缩进4格 file.close();
写入XML文件如下:
<?xml version="1.0" encoding="UTF-8"?>
<library>
<book time="2013/6/13" id="1">
<title>C++ primer</title>
<author>Stanley Lippman</author>
</book>
<book time="2007/5/25" id="2">
<title>Thinking in Java</title>
<author>Bruce Eckel</author>
</book>
</library>
//打开文件 QFile file("test.xml"); if(!file.open(QFile::ReadOnly)) return; //增加一个一级子节点以及元素 QDomDocument doc; if(!doc.setContent(&file)) { file.close(); return; } file.close(); QDomElement root=doc.documentElement(); QDomElement book=doc.createElement("book"); book.setAttribute("id",3); book.setAttribute("time","1813/1/27"); QDomElement title=doc.createElement("title"); QDomText text; text=doc.createTextNode("Pride and Prejudice"); title.appendChild(text); book.appendChild(title); QDomElement author=doc.createElement("author"); text=doc.createTextNode("Jane Austen"); author.appendChild(text); book.appendChild(author); root.appendChild(book); if(!file.open(QFile::WriteOnly|QFile::Truncate)) return; //输出到文件 QTextStream out_stream(&file); doc.save(out_stream,4); //缩进4格 file.close();
//打开文件 QFile file("test.xml"); if(!file.open(QFile::ReadOnly)) return; //删除一个一级子节点及其元素,外层节点删除内层节点于此相同 QDomDocument doc; if(!doc.setContent(&file)) { file.close(); return; } file.close(); QDomElement root=doc.documentElement(); QDomNodeList list=doc.elementsByTagName("book"); //由标签名定位 for(int i=0;i<list.count();i++) { QDomElement e=list.at(i).toElement(); if(e.attribute("time")=="2007/5/25") root.removeChild(list.at(i)); } if(!file.open(QFile::WriteOnly|QFile::Truncate)) return; //输出到文件 QTextStream out_stream(&file); doc.save(out_stream,4); //缩进4格 file.close();
//打开文件 QFile file("test.xml"); if(!file.open(QFile::ReadOnly)) return; //更新一个标签项,如果知道xml的结构,直接定位到那个标签上定点更新 //或者用遍历的方法去匹配tagname或者attribut,value来更新 QDomDocument doc; if(!doc.setContent(&file)) { file.close(); return; } file.close(); QDomElement root=doc.documentElement(); QDomNodeList list=root.elementsByTagName("book"); QDomNode node=list.at(list.size()-1).firstChild(); QDomNode oldnode=node.firstChild(); node.firstChild().setNodeValue("Emma"); QDomNode newnode=node.firstChild(); node.replaceChild(newnode,oldnode); if(!file.open(QFile::WriteOnly|QFile::Truncate)) return; //输出到文件 QTextStream out_stream(&file); doc.save(out_stream,4); //缩进4格 file.close();
本文出自 “生命不息,奋斗不止” 博客,谢绝转载!
原文地址:http://9291927.blog.51cto.com/9281927/1879135