tinyxml的设计结构分析

关于tinyxml的剖析：

下面是名为 example.xml的文档，后续的剖析都会以这个xml文档为例：

example.xml

(1)tinyxml把xml文档建立成一棵DOM(Document Object Model)树，具体实现用的是firstchild–nextsibling tree，下面是对该树的模型的一个简单介绍：

firstchild-nextsibling是一种多叉树常用的实现方法，每个结点只需要知道它的第一个孩子结点(first child node)和它的下一个兄弟结点(next sibling node)，这样一整棵树的结构就会建立起来，也可以用根结点的指针为起点来对整棵树进行遍历。在tinyxml中，每个结点保存了它的first child, last child,  next sibling, previous sibling, parent这五个与它相关的结点的指针，这样便可提供更加方便的遍历接口。下面是对上面的example.xml的内容所建立的DOM树：

DOM tree

上图中 蓝色的指向first child, 红色的指向last child， 绿色的指向next sibling, 紫色的指向previoud sibling， 黑色的指向parent

(2)tinyxml 把一篇xml文档里的各个元素抽象成如下图所示的对象：

TinyXml Object Model

• TiXmlBase: 所有tinyxml中的对象的公共基类，实现了一些公共的操作，比如字符编码转换等，另外还定义了一些公共的数据结构，比如错误类型等。
• TiXmlNode: 是DOM树中结点元素的基类型，它定义了DOM树结点的一些特征数据以及一些相关的操作。
• TiXmlDocument:对应于XML文档整体的一个对象，一棵DOM的根结点是TiXmlDocument类型，而且基它结点不能为TiXmlDocument类型。(example.xml)
• TiXmlDeclaration:对应于XML文档开始部分声明部分的对象，它主要包含version,  encode, standalone三个方面的数据信息以及相关的操作。(<?xml version=”1.0″ standalone=no>)
• TiXmlComment: 对应于XML文档中的注释部分的对象，它主要包含注释的内容以及相关的操作。(<!– Our to do list data –> )
• TiXmlElement:对应于XML文档中普通的元素的对象，每个元素有一个对应的名字，另外还可以有一些属性。TiXmlElement包含了这些相关信息及其操作。 ( <ToDo>  <Item priority=”1″>  <bold> <Item priority=”2″>)
• TiXmlText: 对应于XML文档中元素中的文本信息的对象，它实现了文本信息相关的操作。（Go to the ， Toy store!， Do bills）
• TiXmlAttributeSet: XML文档中某个元素的所有属性的集合，它是TiXmlElement的一部分，它用来管理该元素的所有属性。
• TiXmlAttribute: XML文档中的元素的属性所对应的对象。它是一个name-value pair对象，name是属性名，value是属性值。
• TiXmlUnknown: 所有的用上面的对象不能表示的内容所对应的对象。

example.xml文档和上面定义的对象可以得到如下的对应关系：

 

 

使用的简单总结：

  TinyXML是一个开源的解析 XML的解析库，能够用于 C++，能够在 Windows或 Linux中编译。这个解析库的模型通过解析 XML文件，然后在内存中生成 DOM模型，从而让我们很方便的遍历这课 XML树。
    注：DOM模型即文档对象模型，是将整个文档分成多个元素（如书、章、节、段等），并利用树型结构表示这些元素之间的顺序关系以及嵌套包含关系（理解html语言的读者会很容易理解这种树状模型）。               
    如下是一个XML片段：
     <Persons>
        <Person ID="1">
            <name>周星星</name>
            <age>20</age>
        </Person>
        <Person ID="2">
            <name>白晶晶</name>
            <age>18</age>
        </Person>
    </Persons>
    在TinyXML中，根据XML的各种元素来定义了一些类：
        TiXmlBase：整个TinyXML模型的基类。
                 TiXmlAttribute：对应于XML中的元素的属性。
                 TiXmlNode：对应于DOM结构中的节点。
                         TiXmlComment：对应于XML中的注释。
                         TiXmlDeclaration：对应于XML中的申明部分，即<？versiong="1.0" ?>。
                         TiXmlDocument：对应于XML的整个文档。
                        TiXmlElement：对应于XML的元素。
                         TiXmlText：对应于XML的文字部分。
                         TiXmlUnknown：对应于XML的未知部分。 
        TiXmlHandler：定义了针对XML的一些操作。
    那我们如何使用这些类以及他们的方法来操纵我们的XML呢？请看下面。
    一、读取XML(假设我们的Xml文档中的内容与上面的Xml内容一样)
    //创建一个XML的文档对象。
    TiXmlDocument *myDocument = new TiXmlDocument("填上你的Xml文件名");
    myDocument->LoadFile();
    //获得根元素，即Persons。
    TiXmlElement *RootElement = myDocument.RootElement();
    //输出根元素名称，即输出Persons。
    cout << RootElement->Value() << endl;
    //获得第一个Person节点。
    TiXmlElement *FirstPerson = RootElement->FirstChildElement();
    //获得第一个Person的name节点和age节点和ID属性。
    TiXmlElement *NameElement = FirstPerson->FirstChildElement();
    TiXmlElement *AgeElement = NameElement->NextSiblingElement();
    TiXmlAttribute *IDAttribute = FirstPerson->FirstAttribute();
    //输出第一个Person的name内容，即周星星；age内容，即20；ID属性，即1。
    cout << NameElement->FirstChild()->Value << endl;
    cout << AgeElement->FirstChild()->Value << endl;
    cout << IDAttribute->Value() << endl;
    
    看，读取XML是不是很简单阿，和Java的XML解析库非常的相似，就是名字改了一下而已。
    二、生成XML内容
    //创建一个XML的文档对象。
    TiXmlDocument *myDocument = new TiXmlDocument();
    //创建一个根元素并连接。
    TiXmlElement *RootElement = new TiXmlElement("Persons");
    myDocument->LinkEndChild(RootElement);
    //创建一个Person元素并连接。
    TiXmlElement *PersonElement = new TiXmlElement("Person");
    RootElement->LinkEndChild(PersonElement);
    //设置Person元素的属性。
    PersonElement->SetAttribute("ID", "1");
    //创建name元素、age元素并连接。
    TiXmlElement *NameElement = new TiXmlElement("name");
    TiXmlElement *AgeElement = new TiXmlElement("age");
    PersonElement->LinkEndChild(NameElement);
    PersonElement->LinkEndChild(AgeElement);
    //设置name元素和age元素的内容并连接。
    TiXmlText *NameContent = new TiXmlText("周星星");
    TiXmlText *AgeContent = new TiXmlText("20");
    NameElement->LinkEndChild(NameContent);
    AgeElement->LinkEndChild(AgeContent);
    //保存到文件
    myDocument->SaveFile("要保存的xml文件名");
    这样，便创建了一个如下的xml文件：
    <Persons>
        <Person ID="1">
            <name>周星星</name>
            <age>20</age>
        </Person>
    </Persons>