DOMNODELIST は、順序付けられたノードの集合を表すハンドルであり、GETCHILDNODES、GETELEMENTSBYTAGNAME などのメソッドによって返されます。GETLENGTH を使用してノード数を取得し、ITEM を使用してインデックスで各ノードにアクセスできます。このハンドルは不透明な型であり、解析済みのXMLドキュメントを参照するオブジェクトを表します。DOM関連APIの入出力にのみ使用され、内部構造には直接アクセスできません。
機能の適用範囲
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
説明
V4.4.2バージョンでは、このタイプはOceanBaseデータベースV4.4.2 BP2バージョンから導入されました。
構文
nodelist DBMS_XMLDOM.DOMNODELIST;
パラメータの説明
パラメータ |
説明 |
|---|---|
| nodelist | ノードリストハンドル。 |
戻り値
ノードリストハンドル。
使用方法
DOMNODELIST は、順序付けられた一連の DOMNODE 参照を表します。イテレーション時には、まず GETLENGTH を呼び出して長さを取得し、その後 ITEM を使用してインデックスでアクセスすることで、範囲外アクセスを回避します。
関連するサブプログラム
サブプログラム |
説明 |
|---|---|
| GETCHILDNODES | 子ノードリストを返します。このメソッドは、DOMNODE 型のノードハンドルを入力パラメータとして指定する必要があります。 |
| GETELEMENTSBYTAGNAME | 匹合する要素リストを返します。このメソッドは、DOMNODE 型のノードハンドルを入力パラメータとして指定する必要があります。 |
| GETLENGTH | リストの長さを返します。このメソッドは、DOMNODELIST 型のノードリストハンドルを入力パラメータとして指定する必要があります。 |
| ITEM | インデックスでノードを取得します。このメソッドは、DOMNODELIST 型のノードリストハンドルとインデックスを入力パラメータとして指定する必要があります。 |
例
この例では、DBMS_XMLPARSER システムパッケージを使用してXMLドキュメントを解析し、DOMDOCUMENT ハンドルを取得します。次に、DBMS_XMLDOM システムパッケージを使用して、XMLドキュメントの DOMNODELIST ハンドルを取得します：
-- 声明解析器和文档句柄变量
DECLARE
p DBMS_XMLPARSER.PARSER;
doc DBMS_XMLDOM.DOMDOCUMENT;
nl DBMS_XMLDOM.DOMNODELIST;
BEGIN
-- 创建解析器实例
p := DBMS_XMLPARSER.NEWPARSER;
-- 在解析器上解析 XML 文档
DBMS_XMLPARSER.PARSECLOB(p, '<root><x/><x/></root>');
-- 获取 XML 文档的 DOMDOCUMENT 句柄
doc := DBMS_XMLPARSER.GETDOCUMENT(p);
-- 释放解析器实例
DBMS_XMLPARSER.FREEPARSER(p);
-- 获取 XML 文档中所有名为 "x" 的元素列表
nl := DBMS_XMLDOM.GETELEMENTSBYTAGNAME(doc, 'x');
-- 释放 XML 文档资源
DBMS_XMLDOM.FREEDOCUMENT(doc);
END;
/