QT开发（四十二）——DOM方式解析XML

QT开发（四十二）——DOM方式解析XML

一、DOM简介

1、DOM简介

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

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

2、XML DOM节点

    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

1、QDomDocument简介

    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会使更好的解决方案。

2、QDomDocument成员函数

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

1、QDomElement简介

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

2、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

返回属性的值

五、DOM方式操作XML文件

DOM方式解析XML文件先打开XML文件，将XML文件整体加载到内存中建立DOM树，对于XML文档的任何操作在内存中的DOM树直接操作，最后保存时将DOM树的所有节点写回XML文档。需要注意的是，通常打开XML文件，将XML文件加载到内存中建立DOM树后，XML文件就可以关闭了。如果要保存改变后的XML文档内容，需要在保存时以清空文件的方式打开XML文件，将改变后DOM树的所有节点写入XML文件即可。

1、读取XML文件

    

        

        Stanley Lippman

    

    

        

        Bruce Eckel

    

读取的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()<

2、写XML文件

   

 //打开或创建文件    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文件如下：

    

        

        Stanley Lippman

    

    

        

        Bruce Eckel

    

3、增加XML文件内容

   

 //打开文件    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();

4、删除XML文件

    

//打开文件    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

5、修改XML文件

    

//打开文件    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();

 

本文出自 “生命不息，奋斗不止” 博客，谢绝转载！