（由於包含太多格式符號，新浪提示篇幅過長，因此分為上、下兩篇）

    本篇是接前文“MSXML應用總結 概念篇”寫的，主要總結一下MSXML DOM介面的應用。DOM（Document Object Model）是微軟提供的處理XML文件的一個API標準庫，我們可以將其理解為一組抽象了XML文件結構的介面。

    MSXML的DOM模型是符合W3C DOM標準的，而DOM API在Windows中以COM介面的形式提供，關於COM請大家查閱相關資料。簡單來說，COM提供了一個環境和一套規則，使介面的設計實現到物件的建立、使用和釋放都標準化，從而使COM支援跨平臺和跨語言；更重要的是，遵守COM規範使我們程式碼的介面與實現分離，將程式框架的穩定與擴充套件統一起來，對於使用COM介面的人則更加簡單直觀。COM中一個很重要的概念是refcount，即介面物件的訪問計數，通過AddRef和Release兩個介面函式來控制。要想用好refcount還是件較困難的事情，因此我推薦大家使用智慧指標。使用智慧指標就像使用一個簡單指標一樣，我們完全不用去關心指標指向記憶體空間的釋放。

    本篇總結采用API版本是MSXML2.0。

    首先我們看一下常用的介面：

    IXMLDOMDocument：XML文件介面，DOM樹結構的根結點，是對文件訪問和操作的入口；

    IXMLDOMNode：節點介面，該介面是普遍意義上的節點介面，很多型別節點介面都從它派生，包括IXMLDOMDocument；

    IXMLDOMNodeList：節點列表介面，表示一組關聯的節點集合；該列表中的node元素通過index（從0開始）訪問，另外該介面中的元素還是動態的，會隨著XML文件的改變而更新；

    IXMLDOMNamedNodeMap：節點集合介面，也表示一組關聯節點的集合；不過與list不同的是，該集合是無序的，該介面常用於表示節點的屬性集，並且該介面也是動態的；

    IXMLDOMElement：元素介面，一般用來表示一個節點及其屬性；

    IXMLDOMAttribute：節點屬性介面，對節點屬性進行訪問和操作；

    IXMLDOMText：節點中文字控制介面；

    IXMLDOMComment：XML文件中的註釋介面；

    IXMLDOMParseError：出錯處理介面，包括了錯誤的詳細資訊。

    以上都是最常用的DOM介面，還有一些介面沒有在此列出。對於介面來說，都有相應的智慧指標介面，一般為介面名加上Ptr，比如IXMLDOMDocument的智慧指標介面為IXMLDOMDocumentPtr。這裡有一個介面繼承關係示意圖：

    在VS2005環境下進行DOM應用開發，首先要設定DOM介面應用環境，在stdafx.h檔案中加入語句： 

    #import <msxml3.dll> raw_interfaces_only

    如果你的系統資料夾下有msxml6.dll檔案，#import語句將成生MSXML庫型別資訊，一般會在你的工程編譯資料夾下生成msxml6.tlh和msxml6.tli兩個檔案，開啟看一下可知這兩個檔案包含了一些COM介面型別及函式的宣告以及一些庫資訊。實際上，#import指令使dll庫中的型別資訊匯出為描述的COM介面的c++類標頭檔案。而“raw_interfaces_only”屬性使得生成檔案只有msxml6.tlh一個，而且介面函式只有HRESULT返回型別一種形式，且省去了raw_字首；如果去掉該屬性，則除了在msxml6.tlh檔案中宣告帶raw_字首的返回HRESULT型別的介面函式外，還會在msxml6.tlh中生成不帶raw_字首的wrapper介面函式，並在msxml6.tli檔案中生成返回介面指標型別的wrapper介面函式。因此我們在應用DOM介面的時候，發現有兩套完成相同功能的介面函式，分別返回HRESULT型別和介面指標型別，就是因為上述原因，這應該是Windows環境下COM介面描述的規則，比較深入的介紹請參考這篇文章：http://www.cnblogs.com/xiaotaoliang/archive/2005/07/20/196257.html。為了應用方便，我們下面的示例程式碼不一定用的都是加了“raw_interfaces_only”屬性後的介面函式，建議大家可以去掉該屬性，此處只是加以說明。

    另外一種載入DOM介面的方法是直接在工程環境中新增msxml庫的路徑，並連結msxml6.lib檔案，這裡不再詳述。

    設定DOM環境後，還要初始化COM應用環境，在應用執行緒初始化函式中呼叫CoInitialize，並在執行緒退出時呼叫CoUninitialize。

    現在我們可以用DOM介面來對xml檔案進行操作了，我將按操作分類進行總結。

一、xml檔案的載入和儲存

    由於DOM模型面向的是整個xml檔案，因此我們需要自己建立的介面只有IXMLDOMDocument一個，其他介面都是從它直接或間接得到的，xml檔案的載入和儲存函式也在IXMLDOMDocument介面中實現。建立IXMLDOMDocument介面的程式碼如下：

    MSXML2::IXMLDOMDocumentPtr pXmlDoc;

    HRESULT hr = pXmlDoc.CreateInstance( __uuidof(MSXML2::DOMDocument60), NULL, CLSCTX_INPROC_SERVER);

    if( FAILED(hr))

        printf("Failed to create DOM document interface pointer./n");

    載入xml檔案程式碼為： 

    try

    {

        pXmlDoc->async = VARIANT_FALSE;

        pXmlDoc->validateOnParse = VARIANT_FALSE;

        pXmlDoc->resolveExternals = VARIANT_FALSE;

        if( pXmlDoc->load("test.xml") != VARIANT_TRUE)

{

            printf("Fail reason: %s/n", (LPCSTR)pXmlDoc->parseError->Getreason());

       }

        else

 {

            // success

}

    }

    catch(_com_error errorObject)

    {

        printf("Exception, HRESULT = 0x%08x", errorObject.Error());

    }

    上面程式碼中，開始3句是設定IXMLDOMDocument介面的3個屬性值。

    async表示呼叫的阻塞模式，為true時為非同步，此時load函式呼叫立即返回，而不管檔案載入是否完成；為false時為同步模式，即在載入完之後函式返回。在非同步模式中，可以通過查詢readyState屬性值來判斷是否載入完畢，也可以設定onreadystatechange handler或者onreadystatechange event進行處理。async的預設值為true。

    validateOnParse表示當xml檔案結構有錯誤時是否繼續進行分析，預設值為true。

    resolveExternals表示在分析xml時，外部定義或document type definition(DTD)等是否被處理，MSXML6.0中的預設值為false。

    另外要解釋一下VARIANT型別，一般在COM中用的比較多。VARIANT型別被用來表示多種資料型別，在介面中應用還是很方便的。其實它的定義是一個結構體，其中有一個變數指示了資料的真正型別，還有一個union變數，由各種型別的資料成員構成。這樣，VARIANT就能支援各種型別的資料了。值得一提的是，VARIANT中字串型別是用BSTR表示的，BSTR也是COM程式設計中通用的字串型別，為Unicode字串。BSTR字串的記憶體分配都由系統統一管理，通過SysAllocString和SysFreeString控制。Windows提供了專門的類來處理VARIANT和BSTR，具體可以參考這篇文章：http://www.vckbase.com/document/viewdoc/?id=1096。

    load函式既可以載入本地檔案，也可以載入URL形式的遠端檔案（沒有測試）。另外還有一個對應的loadXML函式可以直接載入字串形式的xml，但只支援UTF-16和UCS-2兩種編碼。

    儲存xml檔案的程式碼為：

    try

    {   

          if( FAILED( pXmlDoc->save(L"myData.xml")))

        {

              printf("Fail reason: %s/n", (LPCSTR)pXmlDoc->parseError->Getreason());

          }

          else

          { 

             // success

          }

    }

    catch(_com_error errorObject)

    {

          printf("Exception, HRESULT = 0x%08x", errorObject.Error());

    }

二、獲取root節點指標

    有了IXMLDOMDocument介面指標，就能很方便的得到root節點介面指標。對於載入xml來說，有3種方式，程式碼如下：

    MSXML2::IXMLDOMElementPtr pRootNode = pXmlDoc->documentElement;

    或

    MSXML2::IXMLDOMElementPtr pRootNode;

    pXmlDoc->get_documentElement(&pRootNode);

    或

    MSXML2::IXMLDOMNodePtr pRootNode, pNode;

    pXmlDoc->get_firstChild(&pRootNode);

    while( pRootNode)

    {

         MSXML2::DOMNodeType type;

         pRootNode->get_nodeType(&type);

         if(type==NODE_ELEMENT)

              break;

         pNode = pRootNode;

         pNode->get_nextSibling(&pRootNode);

    }  

    最常用的又簡單的方法就是第一種。寫出後兩種方法是想說明兩個問題，後面的操作方法將只介紹最常用的方法。

    可以看到第二種方法並不是直接訪問的IXMLDOMDocument介面的屬性值，而是通過函式得到。對於DOM介面的屬性，一般都有對應的get或put函式來對屬性進行讀寫。

    第三種方法是為了讓大家再次理解各種型別的node之間的聯絡與區別，我們可以看到IXMLDOMDocument和IXMLDOMElement均為一個IXMLDOMNode，我們可以通過遍歷IXMLDOMDocument的子節點得到root節點。只不過要注意的是，IXMLDOMDocument的get_firstChild返回的節點並不一定就是root，可能是一些註釋或空格行之類，我們需要判斷節點型別。節點型別的種類及說明如下表：

    而對於新建的一個xml來說，我們建立IXMLDOMDocument介面後，呼叫createElement_x函式建立的第一個節點即為root節點。

原文：http://blog.sina.com.cn/s/blog_48f93b530100ejv9.html