DOMDOCUMENT は、解析済みXMLドキュメントのツリー全体を表す不透明なハンドルです。GETELEMENTSBYTAGNAME や FREEDOCUMENT などのAPIに、ドキュメントレベルの入力パラメータとして渡します。不透明型は解析済みXMLドキュメントへの参照を表し、DOM関連APIへの入力または出力にのみ使用できます。内部構造に直接アクセスすることはできません。
機能の適用範囲
この内容はOceanBaseデータベースEnterprise版にのみ適用されます。OceanBaseデータベースCommunity版はMySQLモードのみを提供します。
説明
V4.4.2系では、この型はOceanBaseデータベースV4.4.2 BP2から導入されました。
構文
doc DBMS_XMLDOM.DOMDOCUMENT;
パラメータの説明
パラメータ |
説明 |
|---|---|
| doc | ドキュメントハンドル。 |
戻り値
ドキュメントハンドル。
使用方法
DBMS_XMLDOM.DOMDOCUMENTは通常、DBMS_XMLPARSER.GETDOCUMENTによって返されます。V4.4.2 BP3以降では、NEWDOMDOCUMENTを使用して空のドキュメントを作成することもできます。
関連サブプログラム
サブプログラム |
説明 |
|---|---|
| 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;
/