TiXml使用详解

TiXml使用详解



本文用一个详细的例子说明了TiXml的使用方法。如写、查找、插入、替换、加载、遍历等常见操作。



首先简单介绍一下TinyXml，要看详细的在网上搜搜了^_^:



TinyXML是一个简单小巧，可以很容易集成到其它程序中的C++ XML解析器。简单地说，TinyXML解析一个XML文档并由此生成一个可读可修改可保存的文档对象模型（DOM）。TinyXML使用文档对象模型（DOM），这意味着XML数据被解析成一个可被浏览和操作的C++对象，然后它可以被写到磁盘或者另一个输出流中。你也可以把C++对象构造成一个XML文档然后把它写到磁盘或者另一个输出流中。



1、TinyXml源代码只有4个cpp文件和2个头文件。



2、首先要理解TinyXml中的各个基本类型之间的关系，看看这个继承图大家就会很明白了！



可以看到TinyXml中的注释comment ，声明declaration，元素element，文本等都是节点Node的子类，也就是说可以把XMl文件中的各个元素当做节点来处理。Node类型也有到各个子类之间的转换方法，如ToElement（）转换成元素，ToDocument转换成文档等。



因此可以吧TiXmlNode作为TinyXml的基本数据类型来操作，这样转化到其他类型也比较方便！



3、类之间的关系

TinyXml实现的是DOM访问模型，因此提供了一系列的类对应XML文件中的各个节点。主要类间的关系如下：

TiXmlBase：其他类的基类，是个抽象类

TiXmlNode：表示一个节点，包含节点的一般方法，如访问子节点、兄弟节点、编辑自身、编辑子节点

TiXmlDocument：表示整个XML文档，不对应其中某个特定的节点。

TiXmlElement：表示元素节点，可以包含子节点和TiXmlAttribute

TiXmlComment：表示注释

TiXmlDeclaration：表示声明

TiXmlText：表示文本节点

TiXmlUnknown：表示未知节点，通常是出错了

TiXmlAttribute：表示一个元素的属性

下面是一个简单的例子：

<?xml version="1.0" encoding="utf-8" ?>

<!-This is only a sample-->

<book>

   <name>TinyXml How To</name>

   <price unit=”RMB”>20</price>

   <description>Some words…</description>

</ book >

整个文档，对应TiXmlDocument

book,name,price, description，都对应TiXmlElement

第一行对应一个TiXmlDeclaration

第二行对应一个TiXmlComment

“TinyXml How To”对应一个TiXmlText

unit则是price的一个TiXmlAttribute

这些类与XML文件中的相应元素都有很好的对应关系，因此相信参照TinyXml的文档，可以很容易的掌握各个方法的使用。

2.  需要注意的问题

各类之间的转换

由于各个节点类都从TiXmlNode继承，在使用时常常需要将TiXmlNode*类型的指针转换为其派生类的指针，在进行这种转换时，应该首先使用由TiXmlNode类提供的一系列转换函数，如ToElement(void)，而不是c++的dynamic_cast。

检查返回值

由于TinyXml是一个非校验的解析器，因此当解析一个文件时，很可能文件并不包含我们预期的某个节点，在这种情况下，TinyXml将返回空指针。因此，必须要对返回值进行检查，否则将很容易出现内存访问的错误。

如何重头建立一个XML文件

先建立一个TiXmlDocument对象，然后，载入某个模板，或者直接插入一个节点作为根节点，接着就可以像打开一个已有的XML文件那样对它进行操作了。



4、要理解TinyXml中的每个节点都可能是另一个节点的父节点这个很重要，因此遍历TinyXml文档要用递归的方法。每个节点都可能有属性，文本什么的！



5、每个type of TiXmlNode节点的值'value'对应如下 ：



                Document: filename of the xml file



                Element: name of the element



                Comment: the comment text



                Unknown: the tag contents



                Text: the text string



6、TinyXml中Node的类型types是一个枚举类型，其成员如下：



 DOCUMENT, ELEMENT, COMMENT, UNKNOWN, TEXT, and DECLARATION

7、TinyXml的在线文档和主页：

http://www.grinninglizard.com/tinyxmldocs/index.html

8、常用操作详解：

#include "tinyxml.h"

#include <iostream>

using namespace std;



TiXmlDocument *pDoc =NULL;

void write_xml( )

    {



        TiXmlDocument doc;

        TiXmlDeclaration * decl = new TiXmlDeclaration( "1.0", "", "" );

        doc.LinkEndChild( decl );



        TiXmlElement * element1 = new TiXmlElement( "AMULE_ToDL" );//创建元素element1

        element1->SetAttribute("num",5);

        doc.LinkEndChild( element1 );





        TiXmlElement * element11 = new TiXmlElement( "name" );

        element11->SetAttribute("name","GongFong.rmvb");//创建属性

        element1->LinkEndChild( element11 );//链接element11为element1的子节点（子元素）





        TiXmlElement * element2 = new TiXmlElement( "BT_ToDL" );

        element2->SetAttribute("num",10);     



        doc.LinkEndChild(element2);





        doc.SaveFile( "1.xml" );

}



void dump_to_stdout( TiXmlNode* pParent )//Tixml主页上给的一个遍历方法(递归调用)

{

        if ( !pParent ) return;



        TiXmlNode* pChild;

        TiXmlText* pText;

        int t = pParent->Type();

        printf( "type %d/n", t);

        int num;



        switch ( t )

        {

        case TiXmlNode::DOCUMENT:

                printf( "Document" );

                break;



        case TiXmlNode::ELEMENT:

                printf( "Element [%s]", pParent->Value() );

                num=dump_attribs_to_stdout(pParent->ToElement(), indent+1);

                switch(num)

                {

                        case 0:  printf( " (No attributes)"); break;

                        case 1:  printf( "%s1 attribute", getIndentAlt(indent)); break;

                        default: printf( "%s%d attributes", getIndentAlt(indent), num); break;

                }

                break;



        case TiXmlNode::COMMENT:

               printf( "Comment: [%s]", pParent->Value());

               break;



        case TiXmlNode::UNKNOWN:

               printf( "Unknown" );

               break;



        case TiXmlNode::TEXT:

               pText = pParent->ToText();

               printf( "Text: [%s]", pText->Value() );

               break;



        case TiXmlNode::DECLARATION:

               printf( "Declaration" );

               break;

        default:

               break;

        }

        printf( "/n" );

        for ( pChild = pParent->FirstChild(); pChild != 0; pChild = pChild->NextSibling())

        {

              dump_to_stdout( pChild );

        }

}

void search(TiXmlNode* pParent)//遍历时候，把每个节点都是做一个父节点，即假定其都有子节点ChildNode

{

       if ( !pParent ) return;

      

       TiXmlNode* pChild= NULL;

       int t = pParent->Type();//获取此节点的类型



       if (TiXmlNode::ELEMENT == t && (strcmp("Welcome",pParent->Value()) == 0))//搜索元素值为"Welcome"的节点

        {

           printf("value %s/n",pParent->Value());//打印值

           pParent->SetValue("re-write");//改变其值

           pParent->ToElement()->SetAttribute("hello",20);//设置其属性



           TiXmlElement * element1 = new TiXmlElement( "AMULE_ToDL" );//添加一个节点

           element1->SetAttribute("num",5);

           pParent->LinkEndChild(element1);



           pDoc->SaveFile(); //保存文件             

        }

      printf( "/n" );

      for ( pChild = pParent->FirstChild(); pChild != 0; pChild = pChild->NextSibling())

      {

           search(pChild);

      }   

}



int main(int argc, char* argv[])

   {



        TiXmlDocument doc(argv[1]);

        bool loadOkay = doc.LoadFile();

        if (loadOkay)

        {

            pDoc = &doc;

            printf("/n%s:/n", argv[1]);

            search(&doc);                //把TiXmlDocument类型的值复制给一个TiXmlNode类型

        }

        else

        {

            printf("Failed to load file /"%s/"/n", argv[1]);

        }

     return 0;

   }



9、引例



#include <iostream>

#include "tinyxml.h"

#include "tinystr.h"

#include <string>

#include <windows.h>

#include <atlstr.h>

using namespace std;



CString GetAppPath()

{//获取应用程序根目录



    TCHAR modulePath[MAX_PATH];

    GetModuleFileName(NULL, modulePath, MAX_PATH);

    CString strModulePath(modulePath);

    strModulePath = strModulePath.Left(strModulePath.ReverseFind(_T('\\')));

    return strModulePath;

}



bool CreateXmlFile(string& szFileName)

{//创建xml文件,szFilePath为文件保存的路径,若创建成功返回true,否则false



    try

    {

        //创建一个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("22");

        NameElement->LinkEndChild(NameContent);

        AgeElement->LinkEndChild(AgeContent);

        CString appPath = GetAppPath();

        string seperator = "\\";

        string fullPath = appPath.GetBuffer(0) +seperator+szFileName;

        myDocument->SaveFile(fullPath.c_str());//保存到文件



    }

    catch (string& e)

    {

        return false;

    }

    return true;

}



bool ReadXmlFile(string& szFileName)

{//读取Xml文件，并遍历



    try

    {

        CString appPath = GetAppPath();

        string seperator = "\\";

        string fullPath = appPath.GetBuffer(0) +seperator+szFileName;

        //创建一个XML的文档对象。



        TiXmlDocument *myDocument = new TiXmlDocument(fullPath.c_str());

        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内容，即；ID属性，即。



        cout << NameElement->FirstChild()->Value() << endl;

        cout << AgeElement->FirstChild()->Value() << endl;

        cout << IDAttribute->Value()<< endl;

    }

    catch (string& e)

    {

        return false;

    }

    return true;

}

int main()

{

    string fileName = "info.xml";

    CreateXmlFile(fileName);

    ReadXmlFile(fileName);

}