TinyXml快速入门(一)

http://blog.csdn.net/clever101/article/details/5334369

对于xml文件，目前我的工作只是集中在配置文件和作为简单的信息文件来用，因此我不太喜欢使用msxml这种重量级的xml解析器，特别是使用msxml解析xml涉及到复杂的com类型转换，更是令人感觉繁琐。因此对于简单的xml文件的解析，我更愿意使用开源的TinyXml。

首先介绍一下TinyXml吧。TinyXML是目前非常流行的一款基于DOM模型的XML解析器，简单易用且小巧玲珑，非常适合存储简单数据，配置文件，对象序列化等数据量不是很大的操作，其主页是：http://www.grinninglizard.com/tinyxml/，目前最新版本是2.5.3 版本。

TinyXml网上的教程很多，但是我觉得写得都不怎样（感觉就是看完之后就没学会）。没办法，只得自己整理一篇适合自己的，至于适不适合别人，就见仁见智了。我感觉xml文件本质就是小型的数据库，换个角度来说就是，你对数据库有什么操作你对xml文件就应能实现什么操作。一般而言，对数据库的操作包括以下几种：新建数据库、查询数据库、修改数据库和删除数据库。那么对应xml文件就是新建xml文件、查询xml文件的指定节点的值，修改xml文件中节点的值和删除xml文件中节点的值。

首先我们认识一下xml文件有哪几种形式。下面我列出一些常用的xml文件的形式：

01.example1.xml:  02.<?xml version="1.0" ?>  03.<Hello>World</Hello>  04.example2.xml:  05.<?xml version="1.0" ?>  06.<poetry>  07.       <verse>  08.               Alas  09.                 Great World  10.                       Alas (again)  11.       </verse>  12.</poetry>  13.example3.xml:  14.<?xml version="1.0" ?>  15.<shapes>  16.       <circle name="int-based" x="20" y="30" r="50" />  17.       <point name="float-based" x="3.5" y="52.1" />  18.</shapes>  19.example4.xml:  20.<?xml version="1.0" ?>  21.<MyApp>  22.    <Messages>  23.        <Welcome>Welcome to MyApp</Welcome>  24.        <Farewell>Thank you for using MyApp</Farewell>  25.    </Messages>  26.    <Windows>  27.        <Window name="MainFrame" x="5" y="15" w="400" h="250" />  28.    </Windows>  29.    <Connection ip="192.168.0.1" timeout="123.456000" />  30.</MyApp>  

上面的例子摘自《TinyXML Tutorial 中文指南》。上面有四个例子，你看到了xml文件的几种表现形式？我看到了本质来说不过是两种表现形式：属性值值在尖括号内，如<Window name="MainFrame" x="5" y="15" w="400" h="250" />和文本在尖括号外，如<Welcome>Welcome to MyApp</Welcome>，具体如下图：

鉴于example4.xml比较复杂，下面我将以此为例介绍tinyxml的使用。

     Tinyxml使用了两种编译选择：使用标准C的char *类型或者使用STL中的std::string,其中使用预处理器TIXML_USE_STL进行控制，即添加了TIXML_USE_STL为使用std::string的。鉴于STL的广泛使用以及其强大功能，下面我以使用std::string的tinyxml说明。

首先使用VS 2005打开tinyxmlSTL.dsp的工程文件，将其编译成一个静态库，debug版本为：tinyxmld_STL.lib，然后开始测试tinyxml库。我的测试计划是这样的：首先使用tinyxml库创建example4.xml，然后将其读出来，然后查询指定节点的属性或文本，再修改example4.xml（修改其中的一些节点值和删除其中一个节点，增加一个节点），然后再读出来以判断是否修改成功。具体是在VS 2005上新建一个控制台工程：Test，注意使用多字节字符集进行编译，同时添加。首先是创建xml文件的代码：

01./*! 02.*  /brief 创建xml文件。 03.* 04.*  /param XmlFile xml文件全路径。 05.*  /return 是否成功。true为成功，false表示失败。 06.*/  07.bool CreateXml(std::string XmlFile)  08.{  09.    // 定义一个TiXmlDocument类指针  10.    TiXmlDocument *pDoc = new TiXmlDocument;  11.    if (NULL==pDoc)  12.    {  13.        return false;  14.    }  15.    TiXmlDeclaration *pDeclaration = new TiXmlDeclaration(_T("1.0"),_T(""),_T(""));  16.    if (NULL==pDeclaration)  17.    {  18.        return false;  19.    }  20.    pDoc->LinkEndChild(pDeclaration);  21.    // 生成一个根节点：MyApp  22.    TiXmlElement *pRootEle = new TiXmlElement(_T("MyApp"));  23.    if (NULL==pRootEle)  24.    {  25.        return false;  26.    }  27.    pDoc->LinkEndChild(pRootEle);  28.    // 生成子节点：Messages  29.    TiXmlElement *pMsg = new TiXmlElement(_T("Messages"));  30.    if (NULL==pMsg)  31.    {  32.        return false;  33.    }  34.    pRootEle->LinkEndChild(pMsg);  35.    // 生成子节点：Welcome  36.    TiXmlElement *pWelcome = new TiXmlElement(_T("Welcome"));  37.    if (NULL==pWelcome)  38.    {  39.        return false;  40.    }  41.    pMsg->LinkEndChild(pWelcome);  42.    // 设置Welcome节点的值  43.    std::string strValue = _T("Welcome to MyApp");  44.    TiXmlText *pWelcomeValue = new TiXmlText(strValue);  45.    pWelcome->LinkEndChild(pWelcomeValue);  46.    // 生成子节点：Farewell  47.    TiXmlElement *pFarewell = new TiXmlElement(_T("Farewell"));  48.    if (NULL==pFarewell)  49.    {  50.        return false;  51.    }  52.    pMsg->LinkEndChild(pFarewell);  53.    // 设置Farewell节点的值  54.    strValue = _T("Thank you for using MyApp");  55.    TiXmlText *pFarewellValue = new TiXmlText(strValue);  56.    pFarewell->LinkEndChild(pFarewellValue);  57.    // 生成子节点：Windows  58.    TiXmlElement *pWindows = new TiXmlElement(_T("Windows"));  59.    if (NULL==pWindows)  60.    {  61.        return false;  62.    }  63.    pRootEle->LinkEndChild(pWindows);  64.    // 生成子节点：Window  65.    TiXmlElement *pWindow = new TiXmlElement(_T("Window"));  66.    if (NULL==pWindow)  67.    {  68.        return false;  69.    }  70.    pWindows->LinkEndChild(pWindow);  71.    // 设置节点Window的值  72.    pWindow->SetAttribute(_T("name"),_T("MainFrame"));  73.    pWindow->SetAttribute(_T("x"),_T("5"));  74.    pWindow->SetAttribute(_T("y"),_T("15"));  75.    pWindow->SetAttribute(_T("w"),_T("400"));  76.    pWindow->SetAttribute(_T("h"),_T("250"));  77.    // 生成子节点：Window  78.    TiXmlElement *pConnection  = new TiXmlElement(_T("Connection"));  79.    if (NULL==pConnection)  80.    {  81.        return false;  82.    }  83.    pRootEle->LinkEndChild(pConnection);  84.    // 设置节点Connection的值  85.    pConnection->SetAttribute(_T("ip"),_T("192.168.0.1"));  86.    pConnection->SetAttribute(_T("timeout"),_T("123.456000"));  87.    pDoc->SaveFile(XmlFile);  88.    return true;  89.}    

不知你注意到上面的规律没有？首先父节点连接字节点使用函数LinkEndChild，使用方法是：pParentNode-> LinkEndChild(pChild);其次设置类似这种结构<Window name="MainFrame" x="5" y="15" w="400" h="250" />采用SetAttribute函数，这个函数有两个参数，前一个参数表示键，后一个参数表示键值，设置<Farewell>Thank you for using MyApp</Farewell>这种结构采用TiXmlText类，使用LinkEndChild函数进行连结。

      上面是创建xml文件的代码，下面介绍读取xml文件的代码。打印整个xml文件的代码很简单，代码如下：

01./*! 02.*  /brief 打印xml文件。 03.* 04.*  /param XmlFile xml文件全路径。 05.*  /return 是否成功。true为成功，false表示失败。 06.*/  07.bool PaintXml(std::string XmlFile)  08.{  09.    // 定义一个TiXmlDocument类指针  10.    TiXmlDocument *pDoc = new TiXmlDocument();  11.    if (NULL==pDoc)  12.    {  13.        return false;  14.    }  15.    pDoc->LoadFile(XmlFile);  16.    pDoc->Print();  17.    return true;  18.}  

 

   下次介绍使用tinyxml库对xml文件进行查询指定节点、删除指定节点、修改指定节点和增加节点的用法。

参考文献：

1.《TinyXML入门教程》

2. 《tinyxml 使用笔记与总结》

3. 《TinyXML Tutorial 中文指南》