MSXML を利用して XMLファイル を解析するには

解説

MSXML を利用して XMLファイル を解析する方法をまとめます。

便利機能

・IXMLDOM〜Ptr を使う

MSXMLの処理においては、IXMLDOM〜型のオブジェクトを扱います。
IXMLDOM〜型には、型名の語尾にPtrが「付く」型と、「付かない」型があります。
型名の語尾にPtrが「付く」型は、スマートポインタ型なので、特に理由がない限り、型名の語尾にPtrが「付く」型を使います。
型名の語尾にPtrが「付かない」型を使う場合には、オブジェクトが不要になった際には Release関数を呼び出す、型変換は QueryInterface関数を通して行う、等が必要になります。

・CComVariant、CComBSTRを使う

MSXMLの処理においては、BSTR型やVARIANT型のオブジェクトを扱います。
BSTR型やVARIANT型には、ラッパークラスである、CComVariant型、CComBSTR型があります。特に理由がない限り、ラッパークラスである、CComVariant型、CComBSTR型を使います。
BSTR型やVARIANT型を使う場合には、領域の確保処理の記述、領域の開放処理の記述、型変換処理の記述、等が必要になります。

準備

・MSXML.DLL のインポート

#import "msxml.dll" named_guids raw_interfaces_only
をファイルヘッダー部に追加します。
これにより、MSXMLの処理が使えるようになります。
・import ディレクティブ：コンパイラは、指定されたファイルを利用可能にするヘッダーファイルを自動生成し、生成されたヘッダーを読み込みます。
・msxml.dll：msxml処理モジュールファイル。MSXML.DLLには、複数のバージョンがあります。必要に応じて、msxml.dll を msxml2.dll , msxml3.dll , msxml4.dll , msxml5.dll , msxml6.dll 等に置き換えます。
・named_guidsオプション：コンパイラは、指定されたファイルを利用可能にするヘッダーファイルに、GUID型の CLSIDやIIDの定義を生成します。
・raw_interfaces_onlyオプション：コンパイラは、指定されたファイルを利用可能にするヘッダーファイルにCOMインターフェイスの定義を生成します。

・atlbase.h のインクルード

#include <atlbase.h>
をファイルヘッダー部に追加します。
これにより、CComVariant型、CComBSTR型が使えるようになります。

・COMの初期化処理、COMの終了処理

MSXMLの処理を使うためには、COMの初期化が必要です。
CoInitialize(NULL);
をアプリケーションの開始処理部に、
CoUninitialize();
をアプリケーションの終了処理部に、
追加します。

手続き

・DOMドキュメントの作成

IXMLDOMDocumentPtr::CreateInstance 関数を利用し、IXMLDOMDocumentPtrオブジェクトを作成する。

・XMLファイル読み込み

IXMLDOMDocumentPtr::load 関数を利用して、ファイルを読み込みます。
load 関数に先立って、IXMLDOMDocumentPtr::put_async( VARIANT_FALSE ) を呼び出し、load関数が、ロードを完了するまで待つようにします。

・ノード、属性の探索、値の取得

各種 get〜関数を利用して、ノード、属性を探索し、また、値の取得をします。

サンプルコード

#import "msxml6.dll" named_guids raw_interfaces_only #include <atlbase.h> // CComVariant, CComBSTR #include <vector> #include <iostream> #include <conio.h> bool GetXmlValue( const IXMLDOMDocumentPtr& pXMLDOMDocument, const CComBSTR& bstrTagName, const CComBSTR& bstrAttributeName, std::vector<CComBSTR>& rvbstrValue ) { // アウトプットの初期化 rvbstrValue.clear(); // インプットのチェック if( 0 == bstrTagName.Length() ) { return false; } HRESULT hResult; // タグ名のノードリストの取得 IXMLDOMNodeListPtr pXMLDOMNodeList = NULL; hResult = pXMLDOMDocument->getElementsByTagName( bstrTagName, &pXMLDOMNodeList ); if( FAILED(hResult) || NULL == pXMLDOMNodeList ) { assert( !"タグ名のノードリストの取得に失敗" ); return false; } // ノードリストのノードの数の取得 long lCountNode = 0; hResult = pXMLDOMNodeList->get_length( &lCountNode ); if( FAILED(hResult) ) { assert( !"ノードリストのノードの数の取得に失敗" ); return false; } // ノードリストのノード一つずつ処理 for( int i = 0; i < lCountNode; ++i ) { // ノードリストのうちの一つのノードの取得 IXMLDOMNodePtr pXMLDOMNode = NULL; hResult = pXMLDOMNodeList->get_item( i, &pXMLDOMNode ); if( FAILED(hResult) ) { assert( !"ノードリストのうちの一つのノードの取得に失敗" ); return false; } // ノードタイプの取得 DOMNodeType eNodeType; hResult = pXMLDOMNode->get_nodeType( &eNodeType ); if( FAILED(hResult) ) { assert( !"ノードタイプの取得に失敗" ); return false; } if( NODE_ELEMENT != eNodeType ) { assert( !"ノードタイプがエレメントでないのはおかしい" ); return false; } // エレメント型への変換 IXMLDOMElementPtr pXMLDOMElement = NULL; hResult = pXMLDOMNode->QueryInterface( IID_IXMLDOMElement, (void**)&pXMLDOMElement ); // スマートポインタ型を利用しているので、pXMLDOMElement = pXMLDOMNode; でも良い。 if( FAILED(hResult) || NULL == pXMLDOMElement ) { assert( !"エレメント型への変換に失敗" ); return false; } // 属性値の取得か、データ値の取得か if( bstrAttributeName.Length() ) { // 属性値の取得 IXMLDOMAttribute* pAttributeNode = NULL; CComVariant varValue; hResult = pXMLDOMElement->getAttribute( bstrAttributeName, &varValue ); if( SUCCEEDED(hResult) && VT_BSTR == varValue.vt ) { rvbstrValue.push_back( varValue.bstrVal ); } } else { // データ値の取得 CComBSTR bstrText; hResult = pXMLDOMElement->get_text( &bstrText ); if( SUCCEEDED(hResult) ) { rvbstrValue.push_back( bstrText ); } } } return true; } bool ParseXmlFile( TCHAR* pszFileName ) { if( NULL == pszFileName ) { return false; } HRESULT hResult; // DOMドキュメントの作成 IXMLDOMDocumentPtr pXMLDOMDocument; hResult = pXMLDOMDocument.CreateInstance(CLSID_DOMDocument); if( FAILED(hResult) ) { assert( !"DOMドキュメントの作成に失敗" ); return false; } // XMLファイル読み込み pXMLDOMDocument->put_async( VARIANT_FALSE ); // load関数がロードを完了するまで待つようにする。 VARIANT_BOOL varbResult; hResult = pXMLDOMDocument->load( CComVariant(pszFileName), &varbResult ); if( FAILED(hResult) || !varbResult) { assert( !"XMLファイル読み込みに失敗" ); return false; } std::vector<CComBSTR> vbstrValue; // author要素の値の取得 if( !GetXmlValue( pXMLDOMDocument, _T("author"), _T(""), vbstrValue ) ) { assert( !"author要素の値の取得に失敗" ); return false; } std::cout << "author要素の値" << std::endl; for( unsigned int ui = 0; ui < vbstrValue.size(); ++ui ) { std::cout << "\t" << _com_util::ConvertBSTRToString(vbstrValue[ui]) << std::endl; } // book要素のid属性の値の取得 if( !GetXmlValue( pXMLDOMDocument, _T("book"), _T("id"), vbstrValue ) ) { assert( !"book要素のid属性の値の取得に失敗" ); return false; } std::cout << "book要素のid属性の値" << std::endl; for( unsigned int ui = 0; ui < vbstrValue.size(); ++ui ) { std::cout << "\t" << _com_util::ConvertBSTRToString((TCHAR*)vbstrValue[ui]) << std::endl; } return true; } int _tmain(int argc, _TCHAR* argv[]) { CoInitialize(NULL); // COMの初期化処理 ParseXmlFile( _T("books.xml") ); CoUninitialize(); // COMの終了処理 _getch(); return 0; }

ダウンロード

サンプルプロジェクト

---

コメント