笔者:朱金灿

      对于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:<?xml version="1.0" ?> <Hello>World</Hello> example2.xml: <?xml version="1.0" ?> <poetry> <verse> Alas Great World Alas (again) </verse> </poetry> example3.xml: <?</p><p>xml version="1.0" ?</p><p>> <shapes> <circle name="int-based" x="20" y="30" r="50" /> <point name="float-based" x="3.5" y="52.1" /> </shapes> example4.xml: <?</p><p>xml version="1.0" ?> <MyApp> <Messages> <Welcome>Welcome to MyApp</Welcome> <Farewell>Thank you for using MyApp</Farewell> </Messages> <Windows> <Window name="MainFrame" x="5" y="15" w="400" h="250" /> </Windows> <Connection ip="192.168.0.1" timeout="123.456000" /> </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文件的代码:

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

       不知你注意到上面的规律没有?首先父节点连接字节点使用函数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,代码例如以下:

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

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

參考文献:

1.《​​TinyXML新手教程​​ 》

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

3. 《​​TinyXML Tutorial 中文指南​​》