org.jdom.transform
public class XSLTransformer extends Object
XSLTransformer transformer = new XSLTransformer("file.xsl");
Document x2 = transformer.transform(x); // x is a Document
Document y2 = transformer.transform(y); // y is a Document
JDOM relies on TrAX to perform the transformation.
The javax.xml.transform.TransformerFactory
Java system property
determines which XSLT engine TrAX uses. Its value should be
the fully qualified name of the implementation of the abstract
javax.xml.transform.TransformerFactory
class.
Values of this property for popular XSLT processors include:
com.icl.saxon.TransformerFactoryImpl
net.sf.saxon.TransformerFactoryImpl
org.apache.xalan.processor.TransformerFactoryImpl
jd.xml.xslt.trax.TransformerFactoryImpl
oracle.xml.jaxp.JXSAXTransformerFactory
This property can be set in all the usual ways a Java system property can be set. TrAX picks from them in this order:
System.setProperty( "javax.xml.transform.TransformerFactory",
"classname
")
classname
option to the java interpreterlib/jaxp.properties
properties file
in the JRE directory, in a line like this one:
javax.xml.parsers.DocumentBuilderFactory=classname
META-INF/services/javax.xml.transform.TransformerFactory
file
in the JAR archives available to the runtimeVersion: $Revision: 1.5 $, $Date: 2007/11/14 04:36:54 $
Constructor Summary | |
---|---|
XSLTransformer(String stylesheetSystemId)
Creates a transformer for a given stylesheet system id.
| |
XSLTransformer(InputStream stylesheet)
This will create a new | |
XSLTransformer(Reader stylesheet)
This will create a new | |
XSLTransformer(File stylesheet)
This will create a new | |
XSLTransformer(Document stylesheet)
This will create a new |
Method Summary | |
---|---|
JDOMFactory | getFactory()
Returns the custom JDOMFactory used to build the transformation
result.
|
void | setFactory(JDOMFactory factory)
Sets a custom JDOMFactory to use when building the
transformation result. |
List | transform(List inputNodes)
Transforms the given input nodes to a list of output nodes.
|
Document | transform(Document inputDoc)
Transforms the given document to an output document.
|
Document | transform(Document inputDoc, EntityResolver resolver)
Transforms the given document to an output document.
|
Parameters: stylesheetSystemId source stylesheet as a Source object
Throws: XSLTransformException if there's a problem in the TrAX back-end
This will create a new XSLTransformer
by
reading the stylesheet from the specified
InputStream
.
Parameters: stylesheet InputStream
from which the stylesheet is read.
Throws: XSLTransformException when an IOException, format error, or something else prevents the stylesheet from being compiled
This will create a new XSLTransformer
by
reading the stylesheet from the specified
Reader
.
Parameters: stylesheet Reader
from which the stylesheet is read.
Throws: XSLTransformException when an IOException, format error, or something else prevents the stylesheet from being compiled
This will create a new XSLTransformer
by
reading the stylesheet from the specified
File
.
Parameters: stylesheet File
from which the stylesheet is read.
Throws: XSLTransformException when an IOException, format error, or something else prevents the stylesheet from being compiled
This will create a new XSLTransformer
by
reading the stylesheet from the specified
Document
.
Parameters: stylesheet Document
containing the stylesheet.
Throws: XSLTransformException when the supplied Document
is not syntactically correct XSLT
Returns: the custom JDOMFactory
used to build the
transformation result or null
if the
default JDOM classes are being used.
See Also: XSLTransformer
Parameters: factory the custom JDOMFactory
to use or
null
to use the default JDOM
classes.
See Also: XSLTransformer
Parameters: inputNodes input nodes
Returns: transformed output nodes
Throws: XSLTransformException if there's a problem in the transformation
Parameters: inputDoc input document
Returns: transformed output document
Throws: XSLTransformException if there's a problem in the transformation
Parameters: inputDoc input document resolver entity resolver for the input document
Returns: transformed output document
Throws: XSLTransformException if there's a problem in the transformation