Oracle9i XML API Reference - XDK and Oracle XML DB Release 2 (9.2) Part Number A96616-01 |
|
The Extensible Stylesheet Language (XSL) Package Processor APIs in the DBMS_XSLPROCESSOR Package enables PL/SQL developers to access the contents and structure of XML documents.
This chapter discusses the following topics:
The Extensible Stylesheet Language Transformation (XSLT), describes rules for transforming a source tree into a result tree. A transformation expressed in XSLT is called a stylesheet. The transformation specified is achieved by associating patterns with templates defined in the stylesheet. A template is instantiated to create part of the result tree. This PL/SQL implementation of the XSL processor followed the W3C XSLT working draft (rev WD-xslt-19990813) and included the required behavior of an XSL processor in terms of how it must read XSLT stylesheets and the transformation it must effect.
The following is the default behavior for this PL/SQL XSL Processor:
Returns a new processor instance. This function must be called before the default behavior of Processor can be changed and if other processor methods need to be used.
FUNCTION newProcessor RETURN Processor;
Transforms input XML document. Any changes to the default processor behavior should be effected before calling this procedure. An application error is raised if processing fails. The options are described in the following table.
Turns warnings on (TRUE)
or off (FALSE)
.
PROCEDURE showWarnings( p Processor, yes BOOLEAN);
Parameter | IN / OUT | Description |
---|---|---|
p |
(IN) |
Processor instance. |
yes |
(IN) |
Mode to set: |
Sets errors to be sent to the specified file.
PROCEDURE setErrorLog( p Processor, fileName VARCHAR2);
Parameter | IN / OUT | Description |
---|---|---|
p |
(IN) |
Processor instance. |
fileName |
(IN) |
complete path of the file to use as the error log. |
Creates and returns a new stylesheet instance. The options are described in the following table.
Parameter | IN / OUT | Description |
---|---|---|
xmldoc |
(IN) |
DOMDocument to use for construction. |
inp |
(IN) |
Input URL to use for construction. |
ref |
(IN) |
Reference URL |
Transforms a node in a DOM tree using the given stylesheet, and returns the result of the transformation as a DOMDocumentFragment.
FUNCTION transformNode( n DOMNode, ss Stylesheet) RETURN DOMDocumentFragment;
Parameter | IN / OUT | Description |
---|---|---|
n |
(IN) |
DOMNode to transform. |
ss |
(IN) |
Stylesheet to use. |
Selects nodes which match the given pattern from a DOM tree, and returns the result of the selection.
FUNCTION selectNodes( n DOMNode, pattern VARCHAR2) RETURN DOMNodeList;
Parameter | IN / OUT | Description |
---|---|---|
n |
(IN) |
Root DOMNode of the tree. |
pattern |
(IN) |
Pattern to use. |
Selects the first node from the tree that matches the given pattern, and returns that node.
FUNCTION selectSingleNodes( n DOMNode, pattern VARCHAR2) RETURN DOMNode;
Parameter | IN / OUT | Description |
---|---|---|
n |
(IN) |
Root DOMNode of the tree. |
pattern |
(IN) |
Pattern to use. |
Retrieves the value of the first node from the tree that matches the given pattern.
PROCEDURE valueOf( n DOMNode, pattern VARCHAR2, val OUT VARCHAR2);
Parameter | IN / OUT | Description |
---|---|---|
n |
(IN) |
Root DOMNode of the tree. |
pattern |
(IN) |
Pattern to use. |
val |
(OUT) |
Retrieved value. |
Sets a top level parameter in the stylesheet. The parameter value must be a valid XPath expression. Literal string values must be quoted.
PROCEDURE setParam( ss Stylesheet, name VARCHAR2, value VARCHAR2);
Parameter | IN / OUT | Description |
---|---|---|
ss |
(IN) |
Stylesheet. |
name |
(IN) |
Name of the parameter. |
value |
(IN) |
Value of the parameter. |
Removes a top level stylesheet parameter.
PROCEDURE removeParam( ss Stylesheet, name VARCHAR2);
Parameter | IN / OUT | Description |
---|---|---|
ss |
(IN) |
Stylesheet. |
name |
(IN) |
Name of the parameter. |
Resets the top-level stylesheet parameters.
PROCEDURE resetParams( ss Stylesheet);
Parameter | IN / OUT | Description |
---|---|---|
ss |
(IN) |
Stylesheet. |
Frees a Stylesheet object.
PROCEDURE freestylesheet( ss Stylesheet);
Parameter | IN / OUT | Description |
---|---|---|
ss |
(IN) |
Stylesheet. |
Frees a Processor object.
PROCEDURE freeProccessor( p Processor);
Parameter | IN / OUT | Description |
---|---|---|
p |
(IN) |
Processor. |
|
Copyright © 2001, 2002 Oracle Corporation. All Rights Reserved. |
|