简述

DOM（Document Object Model - 文档对象模型）定义了访问和操作 XML 文档的标准方法。

DOM 把 XML 文档作为树结构来查看，能够通过 DOM 树来访问所有元素。可以修改或删除它们的内容，并创建新的元素。元素及其文本、属性都被认为是节点。

• 简述
• 详细说明
• 使用
  • 生成
  • 解析
• 更多参考

详细说明

QDomDocument 类表示一个 XML 文档。

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

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

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

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

QDomDocument 类具有创建文档数据的多个函数，例如：createElement()、createTextNode()、createComment()、createCDATASection()、createProcessingInstruction()、createAttribute() 和 createEntityReference()。这些函数中的一些具有支持命名空间的版本，即：createElementNS() 和 createAttributeNS()。createDocumentFragment() 函数用于保存文档的各部分，这对于处理复杂文档很有用。

文档的整个内容使用 setContent() 设置。此函数解析的字符串，作为一个 XML 文档以及创建表示文档的 DOM 树传递。根元素可以使用 documentElement() 来获取，文档的文本表示可以使用 toString() 获取。

注意：如果 XML 文档较大，DOM 树可能最终会保留大量内存。对于这样的文档，QXmlStreamReader 或 QXmlQuery 类可能是更好的解决方案。

可以使用 importNode() 将来自另一个文档的节点插入到文档中。

可以根据 elementsByTagName() 或 elementsByTagNameNS() 获取具有特定标记的所有元素的列表。

使用

为了便于演示，使用上节生成的格式化 XML（Blogs.xml）：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!--纯正开源之美，有趣、好玩、靠谱。。。-->
<?xml-stylesheet type="text/css" href="style.css"?>
<Blogs Version="1.0">
 <Blog>
  <作者>一去丶二三里</作者>
  <主页>http://blog.csdn.net/liang19890820</主页>
  <个人说明>青春不老，奋斗不止！</个人说明>
 </Blog>
</Blogs>

详细说明见： Qt之生成XML（QXmlStreamWriter）

生成

函数 writeXML() 主要用于生成 XML，将生成的内容写入 Blogs.xml 文件中：

void writeXML() {
    QDomDocument doc;

    QDomProcessingInstruction xmlInstruction = doc.createProcessingInstruction("xml", "version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"");
    QDomComment comment = doc.createComment(QString::fromLocal8Bit("纯正开源之美，有趣、好玩、靠谱。。。"));
    QDomProcessingInstruction styleInstruction = doc.createProcessingInstruction("xml-stylesheet", "type=\"text/css\" href=\"style.css\"");
    doc.appendChild(xmlInstruction);  // 开始文档（XML 声明）
    doc.appendChild(comment);  // 注释
    doc.appendChild(styleInstruction);  // 处理指令

    // 根元素 <Blogs>
    QDomElement root = doc.createElement("Blogs");
    root.setAttribute("Version", "1.0");  // 属性
    doc.appendChild(root);

    // 元素 <Blog>
    QDomElement child = doc.createElement("Blog");
    root.appendChild(child);

    // 元素 <作者>、<主页>、<个人说明>
    QDomElement author = doc.createElement(QString::fromLocal8Bit("作者"));
    QDomElement home = doc.createElement(QString::fromLocal8Bit("主页"));
    QDomElement instruction = doc.createElement(QString::fromLocal8Bit("个人说明"));
    child.appendChild(author);
    child.appendChild(home);
    child.appendChild(instruction);

    // 元素的文本数据
    QDomText authorText = doc.createTextNode(QString::fromLocal8Bit("一去丶二三里"));
    QDomText homeText = doc.createTextNode("http://blog.csdn.net/liang19890820");
    QDomText instructionText = doc.createTextNode(QString::fromLocal8Bit("青春不老，奋斗不止！"));
    author.appendChild(authorText);
    home.appendChild(homeText);
    instruction.appendChild(instructionText);

    // 保存 XML 文件
    QString strFile("Blogs.xml");
    QFile file(strFile);
    if (file.open(QFile::WriteOnly | QFile::Text)) { // 只写模式打开文件
        QTextStream out(&file);
        doc.save(out, QDomNode::EncodingFromDocument);
        file.close();
    }
}

首先，根据 QDomDocument 构造一个 DOM 文档。通过调用其工厂方法 create…() 创建对应的节点，然后利用 appendChild() 进行添加，进而构建一个对象树。

解析

函数 readXML() 主要用于解析 XML，将 Blogs.xml 文件中的内容解析为节点：

void readXML() {
    QDomDocument doc;
    QFile file("Blogs.xml");
    if (!file.open(QIODevice::ReadOnly))
        return;
    if (!doc.setContent(&file)) {
        file.close();
        return;
    }
    file.close();

    /**********根元素 <Blogs>**********/
    QDomElement root = doc.documentElement();
    qDebug() << root.tagName();

    if (root.hasAttribute("Version"))  // 属性
        qDebug() << root.attribute("Version");

    /**********根元素之上（XML 声明、注释等）**********/
    QDomNode node = root.previousSibling();
    while (!node.isNull()) {
        switch (node.nodeType()) {
        case QDomNode::ProcessingInstructionNode : {
            QDomProcessingInstruction instruction = node.toProcessingInstruction();
            qDebug() << instruction.target() << instruction.data();
            if (QString::compare(instruction.target(), "xml") == 0) { // 开始文档（XML 声明）
                // ...
            } else if (QString::compare(instruction.target(), "xml-stylesheet") == 0) { // 处理指令
                // ...
            }
            break;
        }
        case QDomNode::CommentNode : {
            QDomComment comment = node.toComment();
            qDebug() << comment.data();
            break;
        }
        default:
            break;
        }
        node = node.previousSibling();
    }

    /**********元素 <Blog>**********/
    node = root.firstChild();  // 返回根节点的第一个子节点
    while (!node.isNull()) {
        if (node.isElement()) {
            QDomElement element = node.toElement();  // 尝试将节点转换为元素
            if (!element.isNull()) {  // 节点的确是一个元素
                qDebug() << element.tagName();

                /**********遍历元素 <作者>、<主页>、<个人说明>**********/
                QDomNodeList list = element.childNodes();
                for (int i = 0; i < list.count(); i++) {
                    node = list.at(i);
                    if (node.isElement()) {
                        element = node.toElement();
                        qDebug() << element.tagName() << element.text();
                        if (QString::compare(element.tagName(), QStringLiteral("作者")) == 0) {
                            // ...
                        } else if (QString::compare(element.tagName(), QStringLiteral("主页")) == 0) {
                            // ...
                        } else if (QString::compare(element.tagName(), QStringLiteral("个人说明")) == 0) {
                            // ...
                        }
                    }
                }
            }
        }
        node = node.nextSibling();
    }
}

和 XML 的生成类似，读取是写入的逆过程。读取的入口根据 QDomDocument 调用 documentElement() 返回的根元素。通过根元素，可以获取到任何我们想要的节点，例如：通过 previousSibling() 向上查找兄弟节点；同理，也可以调用 nextSibling() 向下查找。示例中，我们使用 while() 循环，利用 nextSibling() 反复查找根节点 <Blogs>下的所有 <Blog> 子节点 。在读取 <Blog> 的过程中，通过 childNodes() 返回其下的所有节点，然后进行遍历，tagName() 返回标签的名称，text() 则返回相应的内容。

注意：进行解析的时候，尽可能的判断节点的类型，通过调用 nodeType() 或者 isElement() 函数均可。

更多参考

• XML
• Qt之XML
• Qt之生成XML（QXmlStreamWriter）
• Qt之解析XML（QXmlStreamReader）
• Qt之解析XML元素（QXmlStreamReader）
• Qt之XML（SAX）