TinyXml高速入门（一）

作者：朱金灿
来源：http://blog.csdn.net/clever101

      对于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文件的形式：

example1.xml:<br /><?xml version=”1.0″ ?><br /><Hello>World</Hello><br />example2.xml:<br /><?xml version=”1.0″ ?><br /><poetry><br /> <verse><br /> Alas<br /> Great World<br /> Alas (again)<br /> </verse><br /></poetry><br />example3.xml:<br /><?xml version=”1.0″ ?><br /><shapes><br /> <circle name=”int-based” x=”20″ y=”30″ r=”50″ /><br /> <point name=”float-based” x=”3.5″ y=”52.1″ /><br /></shapes><br />example4.xml:<br /><?xml version=”1.0″ ?><br /><MyApp><br /> <Messages><br /> <Welcome>Welcome to MyApp</Welcome><br /> <Farewell>Thank you for using MyApp</Farewell><br /> </Messages><br /> <Windows><br /> <Window name=”MainFrame” x=”5″ y=”15″ w=”400″ h=”250″ /><br /> </Windows><br /> <Connection ip=”192.168.0.1″ timeout=”123.456000″ /><br /></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的project文件，将其编译成一个静态库，debug版本号为：tinyxmld_STL.lib，然后開始測试tinyxml库。我的測试计划是这种：首先使用tinyxml库创建example4.xml，然后将其读出来，然后查询指定节点的属性或文本，再改动example4.xml（改动当中的一些节点值和删除当中一个节点，添加�一个节点），然后再读出来以推断是否改动成功。详细是在VS 2005上新建一个控制台project：Test，注意使用多字节字符集进行编译，同一时候加入�。首先是创建xml文件的代码：

     /*!<br />* /brief 创建xml文件。<br />*<br />* /param XmlFile xml文件全路径。<br />* /return 是否成功。true为成功，false表示失败。<br />*/<br />bool CreateXml(std::string XmlFile)<br />{<br /> // 定义一个TiXmlDocument类指针<br /> TiXmlDocument *pDoc = new TiXmlDocument;<br /> if (NULL==pDoc)<br /> {<br /> return false;<br /> }<br /> TiXmlDeclaration *pDeclaration = new TiXmlDeclaration(_T(“1.0”),_T(“”),_T(“”));<br /> if (NULL==pDeclaration)<br /> {<br /> return false;<br /> }<br /> pDoc->LinkEndChild(pDeclaration);<br /> // 生成一个根节点：MyApp<br /> TiXmlElement *pRootEle = new TiXmlElement(_T(“MyApp”));<br /> if (NULL==pRootEle)<br /> {<br /> return false;<br /> }<br /> pDoc->LinkEndChild(pRootEle);<br /> // 生成子节点：Messages<br /> TiXmlElement *pMsg = new TiXmlElement(_T(“Messages”));<br /> if (NULL==pMsg)<br /> {<br /> return false;<br /> }<br /> pRootEle->LinkEndChild(pMsg);<br /> // 生成子节点：Welcome<br /> TiXmlElement *pWelcome = new TiXmlElement(_T(“Welcome”));<br /> if (NULL==pWelcome)<br /> {<br /> return false;<br /> }<br /> pMsg->LinkEndChild(pWelcome);<br /> // 设置Welcome节点的值<br /> std::string strValue = _T(“Welcome to MyApp”);<br /> TiXmlText *pWelcomeValue = new TiXmlText(strValue);<br /> pWelcome->LinkEndChild(pWelcomeValue);<br /> // 生成子节点：Farewell<br /> TiXmlElement *pFarewell = new TiXmlElement(_T(“Farewell”));<br /> if (NULL==pFarewell)<br /> {<br /> return false;<br /> }<br /> pMsg->LinkEndChild(pFarewell);<br /> // 设置Farewell节点的值<br /> strValue = _T(“Thank you for using MyApp”);<br /> TiXmlText *pFarewellValue = new TiXmlText(strValue);<br /> pFarewell->LinkEndChild(pFarewellValue);<br /> // 生成子节点：Windows<br /> TiXmlElement *pWindows = new TiXmlElement(_T(“Windows”));<br /> if (NULL==pWindows)<br /> {<br /> return false;<br /> }<br /> pRootEle->LinkEndChild(pWindows);<br /> // 生成子节点：Window<br /> TiXmlElement *pWindow = new TiXmlElement(_T(“Window”));<br /> if (NULL==pWindow)<br /> {<br /> return false;<br /> }<br /> pWindows->LinkEndChild(pWindow);<br /> // 设置节点Window的值<br /> pWindow->SetAttribute(_T(“name”),_T(“MainFrame”));<br /> pWindow->SetAttribute(_T(“x”),_T(“5”));<br /> pWindow->SetAttribute(_T(“y”),_T(“15”));<br /> pWindow->SetAttribute(_T(“w”),_T(“400”));<br /> pWindow->SetAttribute(_T(“h”),_T(“250”));<br /> // 生成子节点：Window<br /> TiXmlElement *pConnection = new TiXmlElement(_T(“Connection”));<br /> if (NULL==pConnection)<br /> {<br /> return false;<br /> }<br /> pRootEle->LinkEndChild(pConnection);<br /> // 设置节点Connection的值<br /> pConnection->SetAttribute(_T(“ip”),_T(“192.168.0.1”));<br /> pConnection->SetAttribute(_T(“timeout”),_T(“123.456000”));<br /> pDoc->SaveFile(XmlFile);<br /> return true;<br />} 

       不知你注意到上面的规律没有？首先父节点连接字节点使用函数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文件的代码非常easy，代码例如以下：

/*!<br />* /brief 打印xml文件。<br />*<br />* /param XmlFile xml文件全路径。<br />* /return 是否成功。true为成功，false表示失败。<br />*/<br />bool PaintXml(std::string XmlFile)<br />{<br /> // 定义一个TiXmlDocument类指针<br /> TiXmlDocument *pDoc = new TiXmlDocument();<br /> if (NULL==pDoc)<br /> {<br /> return false;<br /> }<br /> pDoc->LoadFile(XmlFile);<br /> pDoc->Print();<br /> return true;<br />}<br />

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

參考文献：

1.《TinyXML新手教程 》

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

3. 《TinyXML Tutorial 中文指南 》