XML Parser for C++の使用

28.1 Oracle XML Parser for C++の概要

Oracle XML Parser for C++は、XML文書が整形式であるかどうか、およびDocument Type Definition (DTD)またはExtensible Markup Language (XML)スキーマに対して妥当であるかどうか(オプション)を確認します。このパーサーは、次の2つのXMLのAPIのうち、いずれかでアクセス可能なオブジェクト・ツリーを構築します。

Document Object Model (DOM): ツリーベースのAPI。ツリーベースAPIは、XML文書を内部ツリー構造にコンパイルします。これによって、アプリケーションは、XMLおよびHTML文書用のツリーベースの標準APIであるDOMを使用してツリー内をナビゲートできます。
Simple API for XML (SAX): イベントベースのAPI。イベントベースAPIは、ユーザー定義のSAXイベント・ハンドラを使用して、要素の開始や終了などの解析イベントをアプリケーションに直接通知します。通常は、内部ツリーを構築しません。アプリケーションは、ハンドラを実装して様々なイベントを処理します。これは、GUIによるイベント処理に類似しています。

ツリーベースAPIは広範囲なアプリケーションで有効ですが、特にドキュメントのサイズが大きい場合、より多くのシステム・リソースが消費される場合があります(高度に制御された環境では、簡単な方法でツリーを構築し、この問題のいくつかを回避できる場合もあります)。さらに、いくつかのアプリケーションではそれぞれ独自のデータ・ツリーを構築する必要があります。この場合、新規のツリーにマップするためにのみ解析ノードのツリーを構築することは、非効率的です。

28.2 DOMネームスペース

DOM名前空間は、DOMに関連するタイプおよびインタフェースの名前空間です。

DOMインタフェースは、DOM仕様の様々な実装に対する一般的な参照として表されます。DOMインタフェースは、様々な形式での特殊化およびインスタンス化をサポートする、Nodeによってパラメータ化されます。その中で最も重要なものは、現行のCの実装に対応しているxmlnodeです。

これらの一般的な参照には、NULLのような値はありません。これは、実装によって何の状態も持たない(NULLなどの)参照が作成されることはないためです。何の状態も持たないことを通知する必要がある場合は、実装で例外を発生させる必要があります。

多くのメソッドでは、DOMツリーの構成が誤っている場合はSYNTAX_ERR例外をスローし、不正なパラメータまたは予期しないNULLポインタが使用されている場合はUNDEFINED_ERR例外をスローします。個別のメソッドがスローするエラーがそれのみである場合は、メソッド・シグネチャには反映されません。

実際のDOMツリーはコンテキストTCtxには依存しません。ただし、現行のDOMツリーを操作する、xmlctxベースの実装では、現行コンテキストのTCtxにアクセスする必要があります。コンテキスト・ポインタをDOMImplRefのコンストラクタに渡すことによって、この操作を実行できます。マルチスレッド環境では、DOMImplRefは常にスレッド・コンテキストで作成されるため、正しいコンテキストを指すポインタが備わります。

DOMImplRefにより、DOMツリーを作成する方法が提供されます。DomImplRefは実際のDOMImplementationオブジェクトに対する参照であり、DomImplRefの、コピーではない正規のコンストラクタが起動されると作成されます。これは、DOMツリーを共有する必要があるマルチスレッド環境で効率的に動作します。各スレッドには、スレッドに関連する個々のTCtxがあります。シングル・スレッド環境でも同じく適切に機能します。

DOMStringは、Oracle実装でサポートされるエンコーディングの1つです。その他のエンコーディングは、Oracleの拡張機能でサポートされます。oratext*データ型はすべてのエンコーディングに使用されます。インタフェースは、Document Object Model Coreに準拠したDOMレベル2 Coreインタフェースに相当します。これらのC++インタフェースは、DOM仕様をほぼサポートしています。ただし、World Wide Web Consortium (W3C)仕様にはC++バインディングは含まれていないため、この実装で仕様が完全にサポートされることは保証していません。

28.2.1 DOMデータ型

DomNodeTypeは、DOMノードのタイプを定義します。DomExceptionCodeは、DOM APIによって戻される例外コードを定義します。

28.2.2 DOMインタフェース

DOMインタフェースについて説明します。

DOMExceptionインタフェース—W3C DOMのドキュメントの例外DOMExceptionを参照してください。(データが損失した、または実装が不安定であるなどの論理的な理由のいずれかにより)DOM操作を実行できない例外的な状況では、DOMを操作しても例外が発生するのみです。XMLExceptionの機能は、より広範な範囲の例外に使用できます。

NodeRefインタフェース—W3CのドキュメントのインタフェースNodeを参照してください。

DocumentRefインタフェース—W3CのドキュメントのインタフェースDocumentを参照してください。

DocumentFragmentRefインタフェース—W3CのドキュメントのインタフェースDocumentFragmentを参照してください。

ElementRefインタフェース—W3CのドキュメントのインタフェースElementを参照してください。

AttrRefインタフェース—W3CのドキュメントのインタフェースAttrを参照してください。

CharacterDataRefインタフェース—W3CのドキュメントのインタフェースCharacterDataを参照してください。

TextRefインタフェース—W3CのドキュメントのTextノードを参照してください。

CDATASectionRefインタフェース—W3CのドキュメントのCDATASectionノードを参照してください。

CommentRefインタフェース—W3CのドキュメントのCommentノードを参照してください。

ProcessingInstructionRefインタフェース—W3CのドキュメントのPIノードを参照してください。

EntityRefインタフェース—W3CのドキュメントのEntityノードを参照してください。

EntityReferenceRefインタフェース—W3CのドキュメントのEntityReferenceノードを参照してください。

NotationRefインタフェース—W3CのドキュメントのNotationノードを参照してください。

DocumentTypeRefインタフェース—W3CのドキュメントのDTDノードを参照してください。

DOMImplRefインタフェース—W3C DOMのドキュメントのインタフェースDOMImplementationを参照してください。DOMImplementationは、DOMツリーを操作する際の基本となるインタフェースです。いずれのDOMツリーも、特定のDOM実装オブジェクトにアタッチされます。1つのDOM実装オブジェクトに複数のDOMツリーをアタッチできます。各DOMツリーを削除および割当て解除するには、ドキュメント・オブジェクトを削除します。特定のDOM実装オブジェクトが削除されると、そのオブジェクトにアタッチされているDOMツリーはすべて削除されます。DOMImplementationオブジェクトがユーザーに直接表示されることはありません。これは、クラスDOMImplRefを介して表示されます。この機能は、マルチスレッド環境の要件のために必要です。

NodeListRefインタフェース—ノード・リストの抽象的な実装。W3CのドキュメントのインタフェースNodeListを参照してください。

NamedNodeMapRefインタフェース—ノード・マップの抽象的な実装。W3CのドキュメントのインタフェースNamedNodeMapを参照してください。

28.2.3 DOM TraversalおよびRangeデータ型

AcceptNodeCodeは、イテレータおよびツリー・ウォーカーで使用される、ノード・フィルタによって戻される値のデータ型です。WhatToShowCodeは、ノードをフィルタ処理するコードのデータ型です。RangeExceptionCodeは、インタフェースRangeによってスローされる可能性のある例外のデータ型です。CompareHowCodeは、範囲比較のデータ型です。

28.2.4 DOM TraversalおよびRangeインタフェース

DOM 2 TraversalおよびRangeインタフェースは、NodeFilter、NodeIterator、TreeWalker、DocumentTraversal、RangeException、RangeおよびDocumentRangeです。

28.3 パーサーの名前空間

パーサーの名前空間に関連付けられたインタフェースについて説明します。

DOMParserインタフェース—DOMパーサー・ルート・クラスです。

GParserインタフェース—XMLパーサーのルート・クラスです。

ParserExceptionインタフェース—パーサーおよびバリデータの例外クラスです。

SAXHandlerインタフェース—現行のSAXハンドラ実装のルート・クラスです。

SAXHandlerRootインタフェース—全SAXハンドラのルート・クラスです。

SAXParserインタフェース—全SAXパーサーのルート・クラスです。

SchemaValidatorインタフェース—XML Schema対応のバリデータです。

28.3.1 GParserインタフェース

インタフェースGParserは、すべてのXMLパーサー・インタフェースおよび実装のルート・クラスです。これは抽象クラス(つまり、インタフェース)ではありません。これは実在するクラスであり、ユーザーはこれを使用してパーサー・パラメータを設定および確認できます。

28.3.2 DOMParserインタフェース

インタフェースDOMParserは、DOMパーサー・ルート抽象クラスまたはインタフェースです。文書の解析および整形式であるかどうかの確認に加え、文書がDocument Type Definition (DTD)またはXMLスキーマに対して妥当であるかを検証する方法が提供されます。

28.3.3 SAXParserインタフェース

インタフェースSAXParserは、すべてのSAXパーサーのルート抽象クラスです。

28.3.3.1 SAXイベント・ハンドラ

SAXを使用するには、ユーザーがSAXイベント・ハンドラ・クラスを作成し、parse()の起動でSAXParserに渡すか、または起動前に設定する必要があります。

SAXHandlerRootインタフェース—全SAXハンドラのルート・クラスです。

SAXHandlerインタフェース—現行のSAXハンドラ実装のルート・クラスです。

28.4 XML Parser for C++のスレッド・セーフティ

起動の初期化/解析/終了シーケンスの途中でスレッドが分岐している場合、不適切な動作または結果が発生する場合があります。

28.5 XML Parser for C++の使用方法

Tools::Factoryを起動してパーサーを作成すると、解析プロセスが初期化されます。XML入力は、InputSourceのいずれかの種類にすることができます(「IO名前空間」を参照)。DOMParserを起動すると、DOMツリーが生成されます。SAXParserを起動すると、SAXイベントが生成されます。parserデストラクタを起動すると、プロセスが終了します。

28.6 XML Parser for C++のデフォルト動作

XML Parser for C++のデフォルト動作について説明します。

文字セット・エンコーディングは8ビット・エンコーディングのUnicode (UTF-8)です。ドキュメントがすべてASCII形式である場合は、パフォーマンスを向上するために、エンコーディングをUS-ASCIIに設定することをお薦めします。
メッセージは、msghdlrが指定されていないかぎり、stderrに出力されます。
XML Parser for C++は、XML文書が整形式であるか、またはDTDに対して妥当であるかどうか(オプション)を確認します。XML Parser for Cは、DOMインタフェースを介してアクセス可能なオブジェクト・ツリーを構築するか、SAXインタフェースを介して順次操作します。
saxcbがSAXコールバックAPIを使用するように設定すると、DOM APIがアクセスできる解析ツリーは構築されません。不要なSAXコールバック関数は、すべてNULLに設定できます。
パーサーは、デフォルト動作では、入力が整形式であることは確認しますが、妥当であるかどうかは確認しません。フラグXML_FLAG_VALIDATEを設定することで、入力の妥当性を検証できます。空白処理のデフォルト動作はXML 1.0仕様に完全に準拠しています。つまり、空白はすべてアプリケーションに報告されますが、無視してもよい空白が示されます。ただし、アプリケーションによっては、XML_FLAG_DISCARD_WHITESPACEを設定し、要素の終了タグと次の要素の開始タグの間のすべての空白を削除する方が適切な場合もあります。

ノート:

シングルバイト文字セット(US-ASCII、ISO 8859文字セットのいずれかなど)のみを使用している場合、明示的にデフォルトのエンコーディングを設定することをお薦めします。UTF-8などのマルチバイト文字セットを使用した場合より、パフォーマンスが25%向上します。
どちらの場合も、イベントベースAPIは、XML文書に対してより単純で低レベルのアクセスを提供します。したがって、使用可能なシステム・メモリーよりサイズの大きい文書を解析し、コールバック・イベント・ハンドラを使用して独自のデータ構造を構築できます。

28.7 C++のサンプル・ファイル

ディレクトリxdk/demo/cpp/parser/には、DOMインタフェースおよびSAXインタフェースによるXML Parser for C++の使用方法を示すXMLアプリケーションがあります。

サンプル・ディレクトリ(たとえば、Solarisの$ORACLE_HOME/xdk/demo/cpp)に移動し、READMEファイルを参照してください。このドキュメントには、サンプル・プログラムの作成方法が記載されています。

表28-1に、このディレクトリにあるサンプル・ファイルを示します。各ファイル*Main.cppには、対応する*Gen.cppおよび*Gen.hppがあります。

表28-1 XML Parser for C++ のサンプル・ファイル

サンプル・ファイル名	説明
DOMSampleMain.cpp	XMLパーサーおよびDOMのC++インタフェースの使用例です。
FullDOMSampleMain.cpp	手動でDOMを作成し、実行します。
SAXSampleMain.cpp	SAXSampleプログラムのソースです。