DOMDOCUMENTは、パース済みXMLドキュメント全体を表すオプアクティブハンドルであり、GETELEMENTSBYTAGNAMEやFREEDOCUMENTなどのAPIにおけるドキュメントレベルの入力パラメータとして使用されます。オプアクティブ型は、パース済みXMLドキュメントを参照するオブジェクトを表し、DOM関連APIへの入出力にのみ使用され、その内部構造には直接アクセスできません。
機能の適用範囲
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみ提供します。
説明
V4.4.2バージョンでは、この型はOceanBaseデータベースV4.4.2 BP2バージョンから導入されました。
構文
doc DBMS_XMLDOM.DOMDOCUMENT;
パラメータの説明
パラメータ |
説明 |
|---|---|
| doc | ドキュメントハンドル。 |
戻り値
ドキュメントハンドル。
使用方法
DBMS_XMLDOM.DOMDOCUMENTは通常、DBMS_XMLPARSER.GETDOCUMENTによって返され、直接作成することはできません。
関連サブプログラム
サブプログラム |
説明 |
|---|---|
| GETELEMENTSBYTAGNAME | タグ名に基づいて、XMLドキュメント全体から一致するすべての要素ノードを一括取得するために使用されます。このメソッドでは、DOMDOCUMENT型のドキュメントハンドルを入力パラメータとして渡す必要があります。 |
| FREEDOCUMENT | DOMDOCUMENT型ハンドルが識別するXMLドキュメントリソースを解放し、リソースリークを防ぎます。使用時には、解放対象のドキュメントハンドルを入力パラメータとして渡します。 |
例
この例では、DBMS_XMLPARSERシステムパッケージを使用してXMLドキュメントを解析し、DOMDOCUMENTハンドルを取得します。最後にDBMS_XMLDOMシステムパッケージを使用してドキュメントリソースを解放します。
-- パーサーとドキュメントハンドルの変数を宣言する
DECLARE
p DBMS_XMLPARSER.PARSER;
doc DBMS_XMLDOM.DOMDOCUMENT;
BEGIN
-- パーサーインスタンスを作成する
p := DBMS_XMLPARSER.NEWPARSER;
-- パーサーでXMLドキュメントを解析する
DBMS_XMLPARSER.PARSECLOB(p, '<root/>');
-- XMLドキュメントのDOMDOCUMENTハンドルを取得する
doc := DBMS_XMLPARSER.GETDOCUMENT(p);
-- パーサーインスタンスを解放する
DBMS_XMLPARSER.FREEPARSER(p);
-- XMLドキュメントリソースを解放する
DBMS_XMLDOM.FREEDOCUMENT(doc);
END;
/