oracle.xml.parser.v2
Class XSLProcessor

java.lang.Object
oracle.xml.parser.v2.XSLProcessor

public class XSLProcessor

extends java.lang.Object

This class provides methods to create XSLStylesheet objects and to transform an input XML document using a previously constructed XSLStylesheet.
The transformation effected is as specified by the XSLT 1.0 or XSLT 2.0 Working Draft specifications. The function setXSLTVersion controls the choice of the specification used for transformation.

Nested Class Summary

static class

XSLProcessor.XSLTVersion Version class used in XSLProcessor.setXSLTVersion()

Field Summary

static XSLProcessor.XSLTVersion	XSLT10 XSLTVersion for XSLT 1.0 specification.
static XSLProcessor.XSLTVersion	XSLT20 XSLTVersion for XSLT 2.0 WD 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	setAttribute(java.lang.String name, java.lang.Object value) Allows the user to set specific attributes on the underlying implementation.
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	setOutputEncoding(java.lang.String externalenc) If output encoding is not specified in XSL document, output charset as "UTF-8" in META element by default.
void	setParam(java.lang.String uri, java.lang.String name, java.lang.Object value) Sets the value of a top-level stylesheet parameter.
void	setXSLTVersion(XSLProcessor.XSLTVersion version) Set the specification version to be used for transformation.
void	showWarnings(boolean flag) Switch to determine whether to output warnings.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

XSLT10

public static final XSLProcessor.XSLTVersion XSLT10

XSLTVersion for XSLT 1.0 specification.

See Also:

setXSLTVersion(oracle.xml.parser.v2.XSLProcessor.XSLTVersion)

XSLT20

public static final XSLProcessor.XSLTVersion XSLT20

XSLTVersion for XSLT 2.0 WD specification.

See Also:

setXSLTVersion(oracle.xml.parser.v2.XSLProcessor.XSLTVersion)

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)

Throws:

XSLException, - IOException on error.

XSLException

java.io.IOException

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.

XSLException

java.io.IOException

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

inp - 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)

Throws:

XSLException, - IOException on error.

XSLException

java.io.IOException

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.

XSLException

java.io.IOException

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

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

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)

Throws:

XSLException, - IOException on error.

XSLException

java.io.IOException

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.

XSLException

java.io.IOException

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

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.

setAttribute

public void setAttribute(java.lang.String name,
                         java.lang.Object value)
                  throws java.lang.IllegalArgumentException

Allows the user to set specific attributes on the underlying implementation.

Parameters:

name - The name of the attribute.

value - The value of the attribute.

Throws:

java.lang.IllegalArgumentException - thrown if the underlying implementation doesn't recognize the attribute.

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

Throws:

java.io.IOException

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

setOutputEncoding

public void setOutputEncoding(java.lang.String externalenc)

If output encoding is not specified in XSL document, output charset as "UTF-8" in META element by default. This function provides to specify the charset programatically. If empty string is passed to this function, it wont print charset in META element in the output document. This function needs to be called before ProcessXSL().

Parameters:

externalenc - Externally specified Output encoding

setXSLTVersion

public void setXSLTVersion(XSLProcessor.XSLTVersion version)

Set the specification version to be used for transformation.

See Also:

XSLT10, XSLT20

getParam

public java.lang.Object getParam(java.lang.String name)
                          throws TransformerException,
                                 java.io.IOException

Deprecated. - use getParam(String, String);

Sets the value of a top-level stylesheet parameter.

Parameters:

name - the parameter name

Throws:

TransformerException

java.io.IOException