oracle.xml.parser.v2
Class XSLProcessor

oracle.xml.parser.v2.XSLProcessor

public class XSLProcessor

This class provides methods to transform an input XML document using a previously constructed XSLStylesheet. The transformation effected is as specified by the XSLT 1.0 specification.

Constructor Summary

XSLProcessor()
Default Constructor

Method Summary

java.lang.Object	getParam(java.lang.String name) Deprecated. - use getParam(String, String);
java.lang.Object	getParam(java.lang.String uri, java.lang.String name) Gets the value of a top-level stylesheet parameter.
XSLStylesheet	newXSLStylesheet(java.io.InputStream xsl) Constructs an XSLStylesheet using the given Inputstream XSL function document('') is not supported as there is no way to re-access the input Stylesheet as XMLDocument.
XSLStylesheet	newXSLStylesheet(java.io.Reader xsl) Constructs an XSLStylesheet using the given Reader XSL function document('') is not supported as there is no way to re-access the input Stylesheet as XMLDocument.
XSLStylesheet	newXSLStylesheet(java.net.URL xsl) Constructs an XSLStylesheet using the given URL
XSLStylesheet	newXSLStylesheet(XMLDocument xsl) Constructs an XSLStylesheet using the given XMLDocument
XMLDocumentFragment	processXSL(XSLStylesheet xsl, java.io.InputStream xml, java.net.URL ref) Transform input XML document using given InputStream and stylesheet.
XMLDocumentFragment	processXSL(XSLStylesheet xsl, java.io.Reader xml, java.net.URL ref) Transform input XML document using given Reader and stylesheet.
XMLDocumentFragment	processXSL(XSLStylesheet xsl, java.net.URL xml, java.net.URL ref) Transform input XML document using given URL and stylesheet.
XMLDocumentFragment	processXSL(XSLStylesheet xsl, XMLDocument xml) Transform input XML document using given XMLDocument and stylesheet.
void	processXSL(XSLStylesheet xsl, XMLDocument xml, ContentHandler handler) Transform input XML document using given XMLDocument and stylesheet.
XMLDocumentFragment	processXSL(XSLStylesheet xsl, XMLDocumentFragment inp) Transform input XML document using given XMLDocument and stylesheet.
void	processXSL(XSLStylesheet xsl, XMLDocumentFragment xml, java.io.OutputStream os) Transform input XML using given XMLDocumentFragment and stylesheet.
void	processXSL(XSLStylesheet xsl, XMLDocumentFragment xml, java.io.PrintWriter pw) Transform input XML using given XMLDocumentFragment and stylesheet.
void	processXSL(XSLStylesheet xsl, XMLDocumentFragment inp, XMLDocumentHandler handler) Transform input XML document using given XMLDocument and stylesheet.
void	processXSL(XSLStylesheet xsl, XMLDocument xml, java.io.OutputStream os) Transform input XML document using given XMLDocument and stylesheet.
void	processXSL(XSLStylesheet xsl, XMLDocument xml, java.io.PrintWriter pw) Transform input XML document using given XMLDocument and stylesheet.
void	processXSL(XSLStylesheet xsl, XMLDocument xml, XMLDocumentHandler handler) Transform input XML document using given XMLDocument and stylesheet.
XMLDocumentFragment	processXSL(XSLStylesheet xsl, XMLElement inp) Transform input XML document using given XMLDocument and stylesheet.
void	processXSL(XSLStylesheet xsl, XMLElement inp, ContentHandler handler) Transform input XML document using given XMLElement and stylesheet.
void	processXSL(XSLStylesheet xsl, XMLElement xml, java.io.OutputStream os) Transform input XML using given XMLElement and stylesheet.
void	processXSL(XSLStylesheet xsl, XMLElement xml, java.io.PrintWriter pw) Transform input XML using given XMLElement and stylesheet.
void	processXSL(XSLStylesheet xsl, XMLElement xml, XMLDocumentHandler handler) Transform input XML document using given XMLElement and stylesheet.
void	removeParam(java.lang.String uri, java.lang.String name) Removes the value of a top-level stylesheet parameter.
void	resetParams() Resets all the params set.
void	setBaseURL(java.net.URL url) Set base url to resolve include/import hrefs EntityResolver if set is used before using the base url
void	setEntityResolver(EntityResolver eResolver) Set entity resolver to resolve include/import hrefs if not set, base url (if set) is used.
void	setErrorStream(java.io.OutputStream out) Creates an output stream for the output of warnings.
void	setLocale(java.util.Locale locale) Applications can use this to set the locale for error reporting.
void	setParam(java.lang.String uri, java.lang.String name, java.lang.Object value) Sets the value of a top-level stylesheet parameter.
void	setXSLOutput(oracle.xml.parser.v2.XSLOutput xslOutput) Set the overriding XSLOutput object.
void	showWarnings(boolean flag) Switch to determine whether to output warnings.

Constructor Detail

XSLProcessor

public XSLProcessor()

Default Constructor

Method Detail

processXSL

public void processXSL(XSLStylesheet xsl,
                       XMLDocument xml,
                       ContentHandler handler)
                throws XSLException

Transform input XML document using given XMLDocument and stylesheet. The output of the transformation is reported through ContentHandler As the result of XSLT is a document fragment, the following functions in ContentHandler will not be called: - setDocumentLocator, startDocument, endDocument

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

handler - ContentHandler

Throws:

XSLException - on error.

processXSL

public void processXSL(XSLStylesheet xsl,
                       XMLDocument xml,
                       XMLDocumentHandler handler)
                throws XSLException

Transform input XML document using given XMLDocument and stylesheet. The output of the transformation is reported through XMLDocumentHandler As the result of XSLT is a document fragment, the following functions in XMLDocumentHandler will not be called: - setDocumentLocator, startDocument, endDocument, - setDoctype, endDoctype, setXMLDecl, setTextDecl

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

handler - XMLDocument handler

Throws:

XSLException - on error.

processXSL

public void processXSL(XSLStylesheet xsl,
                       XMLDocument xml,
                       java.io.OutputStream os)
                throws XSLException,
                       java.io.IOException

Transform input XML document using given XMLDocument and stylesheet.

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

out - Outputstream to which the result is printed

Throws:

XSLException, - IOException on error.

processXSL

public void processXSL(XSLStylesheet xsl,
                       XMLDocument xml,
                       java.io.PrintWriter pw)
                throws XSLException,
                       java.io.IOException

Transform input XML document using given XMLDocument and stylesheet.

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

pw - PrintWriter to which the result is printed

Throws:

XSLException, - IOException on error.

processXSL

public XMLDocumentFragment processXSL(XSLStylesheet xsl,
                                      XMLDocument xml)
                               throws XSLException

Transform input XML document using given XMLDocument and stylesheet. This function doesn't support xsl:output, to use xsl:output use processXSL functions which accept OutputStream or PrintWriter

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

Returns:

XMLDocumentFragment

Throws:

XSLException - on error.

processXSL

public void processXSL(XSLStylesheet xsl,
                       XMLElement inp,
                       ContentHandler handler)
                throws XSLException

Transform input XML document using given XMLElement and stylesheet. The output of the transformation is reported through ContentHandler As the result of XSLT is a document fragment, the following functions in ContentHandler will not be called: - setDocumentLocator, startDocument, endDocument,

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

handler - ContentHandler

Throws:

XSLException - on error.

processXSL

public void processXSL(XSLStylesheet xsl,
                       XMLElement xml,
                       XMLDocumentHandler handler)
                throws XSLException

Transform input XML document using given XMLElement and stylesheet. As the result of XSLT is a document fragment, the following functions in XMLDocumentHandler will not be called: - setDocumentLocator, startDocument, endDocument, - setDoctype, endDoctype, setXMLDecl, setTextDecl

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

handler - XMLDocument Handler

Returns:

XMLDocumentFragment

Throws:

XSLException - on error.

processXSL

public void processXSL(XSLStylesheet xsl,
                       XMLElement xml,
                       java.io.OutputStream os)
                throws XSLException,
                       java.io.IOException

Transform input XML using given XMLElement and stylesheet.

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

out - Outputstream to which the result is printed

Throws:

XSLException, - IOException on error.

processXSL

public void processXSL(XSLStylesheet xsl,
                       XMLElement xml,
                       java.io.PrintWriter pw)
                throws XSLException,
                       java.io.IOException

Transform input XML using given XMLElement and stylesheet.

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

pw - PrintWriter to which the result is printed

Throws:

XSLException, - IOException on error.

processXSL

public XMLDocumentFragment processXSL(XSLStylesheet xsl,
                                      XMLElement inp)
                               throws XSLException

Transform input XML document using given XMLDocument and stylesheet. This function doesn't support xsl:output, to use xsl:output use processXSL functions which accept OutputStream or PrintWriter

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

Returns:

XMLDocumentFragment

Throws:

XSLException - on error.

processXSL

public void processXSL(XSLStylesheet xsl,
                       XMLDocumentFragment inp,
                       XMLDocumentHandler handler)
                throws XSLException

Transform input XML document using given XMLDocument and stylesheet. As the result of XSLT is a document fragment, the following functions in XMLDocumentHandler will not be called: - setDocumentLocator, startDocument, endDocument, - setDoctype, endDoctype, setXMLDecl, setTextDecl

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

handler - XMLDocument handler

Returns:

XMLDocumentFragment

Throws:

XSLException - on error.

processXSL

public void processXSL(XSLStylesheet xsl,
                       XMLDocumentFragment xml,
                       java.io.OutputStream os)
                throws XSLException,
                       java.io.IOException

Transform input XML using given XMLDocumentFragment and stylesheet.

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

out - Outputstream to which the result is printed

Throws:

XSLException, - IOException on error.

processXSL

public void processXSL(XSLStylesheet xsl,
                       XMLDocumentFragment xml,
                       java.io.PrintWriter pw)
                throws XSLException,
                       java.io.IOException

Transform input XML using given XMLDocumentFragment and stylesheet.

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

pw - PrintWriter to which the result is printed

Throws:

XSLException, - IOException on error.

processXSL

public XMLDocumentFragment processXSL(XSLStylesheet xsl,
                                      XMLDocumentFragment inp)
                               throws XSLException

Transform input XML document using given XMLDocument and stylesheet. This function doesn't support xsl:output, to use xsl:output use processXSL functions which accept OutputStream or PrintWriter

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a DOM Tree)

Returns:

XMLDocumentFragment

Throws:

XSLException - on error.

processXSL

public XMLDocumentFragment processXSL(XSLStylesheet xsl,
                                      java.io.InputStream xml,
                                      java.net.URL ref)
                               throws XSLException

Transform input XML document using given InputStream and stylesheet. This function doesn't support xsl:output, to use xsl:output use processXSL functions which accept OutputStream or PrintWriter

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a java.io.Inputstream)

ref - Reference URL to resolve external entities in input xml file

Returns:

XMLDocumentFragment

Throws:

XSLException - on error.

processXSL

public XMLDocumentFragment processXSL(XSLStylesheet xsl,
                                      java.net.URL xml,
                                      java.net.URL ref)
                               throws XSLException

Transform input XML document using given URL and stylesheet. This function doesn't support xsl:output, to use xsl:output use processXSL functions which accept OutputStream or PrintWriter

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a java.net.URL)

ref - Reference URL to resolve external entities in input xml file

Returns:

XMLDocumentFragment

Throws:

XSLException - on error.

processXSL

public XMLDocumentFragment processXSL(XSLStylesheet xsl,
                                      java.io.Reader xml,
                                      java.net.URL ref)
                               throws XSLException

Transform input XML document using given Reader and stylesheet. This function doesn't support xsl:output, to use xsl:output use processXSL functions which accept OutputStream or PrintWriter

Parameters:

xsl - XSLStylesheet to be used for transformation

xml - XML input to be transformed (as a java.io.Reader)

ref - Reference URL to resolve external entities in input xml file

Returns:

XMLDocumentFragment

Throws:

XSLException - on error.

newXSLStylesheet

public XSLStylesheet newXSLStylesheet(XMLDocument xsl)
                               throws XSLException

Constructs an XSLStylesheet using the given XMLDocument

Parameters:

xsl - XSL input as a DOM Tree

Throws:

XSLException - on error.

newXSLStylesheet

public XSLStylesheet newXSLStylesheet(java.io.InputStream xsl)
                               throws XSLException

Constructs an XSLStylesheet using the given Inputstream XSL function document('') is not supported as there is no way to re-access the input Stylesheet as XMLDocument.

Parameters:

xsl - XSL input as an Inputstream

Throws:

XSLException - on error.

newXSLStylesheet

public XSLStylesheet newXSLStylesheet(java.net.URL xsl)
                               throws XSLException

Constructs an XSLStylesheet using the given URL

Parameters:

xsl - XSL input as a URL

Throws:

XSLException - on error.

newXSLStylesheet

public XSLStylesheet newXSLStylesheet(java.io.Reader xsl)
                               throws XSLException

Constructs an XSLStylesheet using the given Reader XSL function document('') is not supported as there is no way to re-access the input Stylesheet as XMLDocument.

Parameters:

xsl - XSL input as a Reader

Throws:

XSLException - on error.

setErrorStream

public final void setErrorStream(java.io.OutputStream out)
                          throws java.io.IOException

Creates an output stream for the output of warnings. If an output stream for warnings is not specified, the processor will not output any warnings

Parameters:

out - The output stream to use for errors and warnings

setLocale

public void setLocale(java.util.Locale locale)

Applications can use this to set the locale for error reporting.

Parameters:

locale - Locale to set

showWarnings

public final void showWarnings(boolean flag)

Switch to determine whether to output warnings.

Parameters:

flag - determines whether warnings should be shown By default, warnings are not output

setBaseURL

public void setBaseURL(java.net.URL url)

Set base url to resolve include/import hrefs EntityResolver if set is used before using the base url

Parameters:

url - Base URL to be set

See Also:

setEntityResolver(org.xml.sax.EntityResolver)

setEntityResolver

public void setEntityResolver(EntityResolver eResolver)

Set entity resolver to resolve include/import hrefs if not set, base url (if set) is used.

Parameters:

eResolver - EntityResolver

setParam

public void setParam(java.lang.String uri,
                     java.lang.String name,
                     java.lang.Object value)
              throws XSLException

Sets the value of a top-level stylesheet parameter. The param functions CANNOT be used along with param functions in XSLStylesheet. If the param functions in XSLProcessor are used, any parameters set using XSLStylesheet functions will be ignored.

Parameters:

uri - URI of parameter

name - parameter name

value - parameter value (Strings will be treated as XPath Expr for backward compatibility)

Throws:

XSLException - on error

getParam

public java.lang.Object getParam(java.lang.String uri,
                                 java.lang.String name)
                          throws XSLException

Gets the value of a top-level stylesheet parameter. The parameter value is expected to be a valid XPath expression (note that string literal values would therefore have to be explicitly quoted).

Parameters:

uri - URI of parameter

name - parameter name

Throws:

XSLException - on error

removeParam

public void removeParam(java.lang.String uri,
                        java.lang.String name)
                 throws XSLException

Removes the value of a top-level stylesheet parameter.

Parameters:

uri - URI of parameter

name - parameter name

Throws:

XSLException - on error

resetParams

public void resetParams()
                 throws XSLException

Resets all the params set.

Throws:

XSLException - on error

setXSLOutput

public void setXSLOutput(oracle.xml.parser.v2.XSLOutput xslOutput)

Set the overriding XSLOutput object. Currently this is for internal use only.

Parameters:

output - - overriding properties

getParam

public java.lang.Object getParam(java.lang.String name)

Deprecated. - use getParam(String, String);

Sets the value of a top-level stylesheet parameter.

Parameters:

name - the parameter name

the - parameter value