DOMDOCUMENT

DOMDOCUMENT represents an opaque handle to the entire parsed XML document, used as a document-level input parameter for APIs such as GETELEMENTSBYTAGNAME and FREEDOCUMENT. An opaque type indicates a reference object to a parsed XML document, used only for passing data into or out of DOM-related APIs, and does not allow direct access to its internal structure.

Syntax

doc DBMS_XMLDOM.DOMDOCUMENT;

Parameters

Return value

Document handle.

Usage instructions

DBMS_XMLDOM.DOMDOCUMENT is typically returned by DBMS_XMLPARSER.GETDOCUMENT and cannot be constructed directly.

Related subprograms

Examples

This example uses the DBMS_XMLPARSER system package to parse an XML document and obtain a DOMDocument handle, and then releases the document resources using the DBMS_XMLDOM system package:

-- Declare parser and document handle variables
DECLARE
  p   DBMS_XMLPARSER.PARSER;
  doc DBMS_XMLDOM.DOMDOCUMENT;
BEGIN
  -- Create a parser instance
  p := DBMS_XMLPARSER.NEWPARSER;
  -- Parse the XML document in the parser.
  DBMS_XMLPARSER.PARSECLOB(p, '<root/>');
  -- Get the DOMDocument handle of an XML document
  doc := DBMS_XMLPARSER.GETDOCUMENT(p);
  -- Release parser instance
  DBMS_XMLPARSER.FREEPARSER(p);
  -- Release XML Document Resources
  DBMS_XMLDOM.FREEDOCUMENT(doc);
END;
/