Functions and Procedures of DBMS_XMLPARSER

Table 86-1: Summary of Functions and Procedures of DBMS_XMLPARSER  

Subprogram	Description
parse()	Parses XML stored in the given url/file.
newParser()	Returns a new parser instance
parseBuffer()	Parses XML stored in the given buffer
parseClob()	Parses XML stored in the given clob
parseDTD()	Parses DTD stored in the given url/file
parseDTDBuffer()	Parses DTD stored in the given buffer
parseDTDClob()	Parses DTD stored in the given clob
setBaseDir()	Sets base directory used to resolve relative URLs.
showWarnings()	Turns warnings on or off.
setErrorLog()	Sets errors to be sent to the specified file
setPreserveWhitespace()	Sets white space preserve mode
setValidationMode()	Sets validation mode.
getValidationMode()	Returns validation mode.
setDoctype()	Sets DTD.
getDoctype()	Gets DTD Parser.
getDocument()	Gets DOM document.
freeParser()	Frees a parser object.
getReleaseVersion()	Returns the release version of Oracle XML Parser for PL/SQL.

parse()

Parses XML stored in the given url/file. An application error is raised if parsing fails. The options are described in the following table.

Syntax	Description
FUNCTION parse( url VARCHAR2) RETURN DOMDocument;	Returns the built DOM Document. This is meant to be used when the default parser behavior is acceptable and just a url/file needs to be parsed.
PROCEDURE parse( p Parser, url VARCHAR2);	Any changes to the default parser behavior should be effected before calling this procedure.

Parameter	IN / OUT	Description
url	(IN)	Complete path of the url/file to be parsed.
p	(IN)	Parser instance.

newParser()

Returns a new parser instance. This function must be called before the default behavior of Parser can be changed and if other parse methods need to be used.

Syntax

FUNCTION newParser RETURN Parser; 

parseBuffer()

Parses XML stored in the given buffer. Any changes to the default parser behavior should be effected before calling this procedure. An application error is raised if parsing fails.

Syntax

PROCEDURE parseBuffer( p   Parser,
                       doc VARCHAR2); 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.
doc	(IN)	XML document buffer to parse.

parseClob()

Parses XML stored in the given clob. Any changes to the default parser behavior should be effected before calling this procedure. An application error is raised if parsing fails.

Syntax

PROCEDURE parseClob( p   Parser,
                     doc CLOB); 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.
doc	(IN)	XML document buffer to parse.

parseDTD()

Parses the DTD stored in the given url/file. Any changes to the default parser behavior should be effected before calling this procedure. An application error is raised if parsing fails.

Syntax

PROCEDURE parseDTD( p     Parser,
                    url   VARCHAR2,
                    root  VARCHAR2); 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.
url	(IN)	Complete path of the url/file to be parsed.
p	(IN)	Parser instance.

parseDTDBuffer()

Parses the DTD stored in the given buffer. Any changes to the default parser behavior should be effected before calling this procedure. An application error is raised if parsing fails.

Syntax

PROCEDURE parseDTDBuffer( p    Parser,
                          dtd  VARCHAR2,
                          root VARCHAR2); 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.
dtd	(IN)	DTD buffer to parse.
root	(IN)	Name of the root element.

parseDTDClob()

Parses the DTD stored in the given clob. Any changes to the default parser behavior should be effected before calling this procedure. An application error is raised if parsing fails.

Syntax

PROCEDURE parseDTDClob( p    Parser,
                        dtd  CLOB,
                        root VARCHAR2);

Parameter	IN / OUT	Description
p	(IN)	Parser instance.
dtd	(IN)	DTD Clob to parse.
root	(IN)	Name of the root element.

setBaseDir()

Sets base directory used to resolve relative URLs. An application error is raised if parsing fails.

Syntax

PROCEDURE setBaseDir( p   Parser,
                      dir VARCHAR2); 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.
dir	(IN)	Directory used as a base directory.

showWarnings()

Turns warnings on or off.

Syntax

PROCEDURE showWarnings( p   Parser,
                        yes BOOLEAN); 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.
yes	(IN)	Mode to set: TRUE - show warnings, FALSE - don't show warnings.

setErrorLog()

Sets errors to be sent to the specified file

Syntax

PROCEDURE setErrorLog( p        Parser,
                       fileName VARCHAR2); 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.
fileName	(IN)	Complete path of the file to use as the error log.

setPreserveWhitespace()

Sets whitespace preserving mode.

Syntax

PROCEDURE setPreserveWhitespace( p   Parser,
                                 yes BOOLEAN); 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.
yes	(IN)	Mode to set: TRUE - preserve, FALSE - don't preserve.

setValidationMode()

Sets validation mode.

Syntax

PROCEDURE setValidationMode( p   Parser,
                             yes BOOLEAN); 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.
yes	(IN)	Mode to set: TRUE - validate, FALSE - don't validate.

getValidationMode()

Retrieves validation mode; TRUE for validating, FALSE otherwise.

Syntax

FUNCTION getValidationMode( p Parser)
                          RETURN BOOLEAN; 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.

setDoctype()

Sets a DTD to be used by the parser for validation. This call should be made before the document is parsed.

Syntax

PROCEDURE setDoctype( p   Parser,
                      dtd DOMDocumentType); 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.
dtd	(IN)	DTD to set.

getDoctype()

Returns the parsed DTD; this function MUST be called only after a DTD is parsed.

Syntax

FUNCTION getDoctype( p Parser)
                   RETURN DOMDocumentType; 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.

getDocument()

Returns the root of the DOM tree document built by the parser; this function MUST be called only after a document is parsed.

Syntax

FUNCTION getDocument( p Parser)
                    RETURN DOMDocument; 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.

freeParser()

Frees a parser object.

Syntax

PROCEDURE freeParser( p Parser); 

Parameter	IN / OUT	Description
p	(IN)	Parser instance.

getReleaseVersion()

Returns the release version of the Oracle XML parser for PL/SQL.

Syntax

PROCEDURE getReleaseVersion RETURN VARCHAR2;