C++之tinyXML使用

 tinyXML一款很優秀的操作C++類庫，檔案不大，但方法很豐富，和apache的Dom4j可以披靡啊！習慣了使用java類庫的我看到這麼豐富的c++類庫，很高興！它使用很簡單，隻需要拷貝幾個檔案到你的工程中，沒有STL也可以編譯運作。 

    下面我從這幾個方面談談對tinyXML類庫的使用以及了解。 

    首先在sourceforge上下載下傳tinyXML類庫，位址： http://sourceforge.net/projects/tinyxml/  

    然後解壓縮tinyXML後，将這六個檔案添加到你的c++工程中，分别是tinystr.h、tinystr.cpp、tinyxml.h、tinyxml.cpp、tinyxmlerror.cpp、tinyxmlparser.cpp。在需要操作xml檔案的地方，使用如下代碼，就可以引入tinyXML類庫。

 下面我用個簡單的例子說明如何使用tinyXML操作xml檔案。在講例子之前我先說說tinyXML中主要類和xml文檔之間的對應關系。下面是tinyXML中主要class的類圖，反應各個類之間的靜态關系。 

引用來自tinyXML文檔

    TiXmlBase是所有類的基類，TiXmlNode、TiXmlAttribute兩個類都繼承來自TiXmlBase類，其中TiXmlNode類指的是所有被<...>...<.../>包括的内容，而xml中的節點又具體分為以下幾方面内容，分别是聲明、注釋、節點以及節點間的文本，是以在TiXmlNode的基礎上又衍生出這幾個類TiXmlComment、TiXmlDeclaration、TiXmlDocument、TiXmlElement、TiXmlText、TiXmlUnknown，分别用來指明具體是xml中的哪一部分。TiXmlAttribute類不同于TiXmlNode，它指的是在尖括号裡面的内容，像<... ***=...>，其中***就是一個屬性。這塊我具體用一個xml文檔說明一下，内容如下： 

Xml代碼  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <phonebook>  
3.     <!--one item behalfs one contacted person.-->  
4.     <item>  
5.         <name>miaomaio</name>  
6.     <addr>Shaanxi Xi'an</addr>  
7.     <tel>13759911917</tel>  
8.     <email>[email protected]</email>  
9.     </item>  
10.     <item>  
11.         <name>gougou</name>  
12.     <addr>Liaoning Shenyang</addr>  
13.     <tel>15840330481</tel>  
14.     <email>[email protected]</email>  
15.     </item>  
16.     <!--more contacted persons.-->  
17. </phonebook>  

• 像TiXmlDeclaration指的就是<?xml version="1.0" encoding="UTF-8"?>，
• 像TiXmlComment指的就是<!--one item behalfs one contacted person.-->、 <!--more contacted persons.-->，
• 像TiXmlDocument指的就是整個xml文檔，
• 像TiXmlElement指的就是<phonebook>、<item>、<name>、<addr>等等這些節點，
• 像TiXmlText指的就是‘gougou’、‘15840330481’這些夾在<item>與</item>、<name>與</name>、<addr>與</addr>之間的文本文字，
• 像TiXmlAttribute指的就是<?xml version="1.0" encoding="UTF-8"?>節點中version、encoding，
• 除此之外就是TiXmlUnknown。

• DOM模型即文檔對象模型，是将整個文檔分成多個元素（如書、章、節、段等），并利用樹型結構表示這些元素之間的順序關系以及嵌套包含關系。

  如下是一個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的一些操作。

  TinyXML是個解析庫，主要由DOM模型類（TiXmlBase、TiXmlNode、TiXmlAttribute、TiXmlComment、TiXmlDeclaration、TiXmlElement、TiXmlText、TiXmlUnknown）和操作類（TiXmlHandler）構成。它由兩個頭檔案（.h檔案）和四個CPP檔案（.cpp檔案）構成，用的時候，隻要将（tinyxml.h、tinystr.h、tinystr.cpp、tinyxml.cpp、tinyxmlerror.cpp、tinyxmlparser.cpp）導入工程就可以用它的東西了。如果需要，可以将它做成自己的DLL來調用。舉個例子就可以說明一切。。。

  對應的XML檔案：

  

  < Persons >

  

       < Person  ID ="1" >

  

           < name >phinecos </ name >

  

           < age >22 </ age >

  

       </ Person >

  

  </ Persons >

  

  讀寫XML檔案的程式代碼：

  #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);

  

  }