|
JDOM 1.0beta10-dev |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Object | +--org.jdom.transform.XSLTransformer
A convenience class to handle simple transformations. The JAXP TrAX classes
have more bells and whistles and can be used with JDOMSource and
JDOMResult for advanced uses. This class handles the common case and
presents a simple interface. XSLTransformer is thread safe and may be
used from multiple threads.
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.TransformerFactoryImplnet.sf.saxon.TransformerFactoryImplorg.apache.xalan.processor.TransformerFactoryImpljd.xml.xslt.trax.TransformerFactoryImploracle.xml.jaxp.JXSAXTransformerFactoryThis 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=classnameMETA-INF/services/javax.xml.transform.TransformerFactory file
in the JAR archives available to the runtime
| Constructor Summary | |
XSLTransformer(Document stylesheet)
This will create a new XSLTransformer by
reading the stylesheet from the specified
Document. |
|
XSLTransformer(java.io.File stylesheet)
This will create a new XSLTransformer by
reading the stylesheet from the specified
File. |
|
XSLTransformer(java.io.InputStream stylesheet)
This will create a new XSLTransformer by
reading the stylesheet from the specified
InputStream. |
|
XSLTransformer(java.io.Reader stylesheet)
This will create a new XSLTransformer by
reading the stylesheet from the specified
Reader. |
|
XSLTransformer(java.lang.String stylesheetSystemId)
Creates a transformer for a given stylesheet system id. |
|
| Method Summary | |
Document |
transform(Document inputDoc)
Transforms the given document to an output document. |
java.util.List |
transform(java.util.List inputNodes)
Transforms the given input nodes to a list of output nodes. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
public XSLTransformer(java.lang.String stylesheetSystemId)
throws XSLTransformException
stylesheetSystemId - source stylesheet as a Source object
XSLTransformException - if there's a problem in the TrAX back-end
public XSLTransformer(java.io.InputStream stylesheet)
throws XSLTransformException
This will create a new XSLTransformer by
reading the stylesheet from the specified
InputStream.
stylesheet - InputStream from which the stylesheet is read.
XSLTransformException - when an IOException, format error, or
something else prevents the stylesheet from being compiled
public XSLTransformer(java.io.Reader stylesheet)
throws XSLTransformException
This will create a new XSLTransformer by
reading the stylesheet from the specified
Reader.
stylesheet - Reader from which the stylesheet is read.
XSLTransformException - when an IOException, format error, or
something else prevents the stylesheet from being compiled
public XSLTransformer(java.io.File stylesheet)
throws XSLTransformException
This will create a new XSLTransformer by
reading the stylesheet from the specified
File.
stylesheet - File from which the stylesheet is read.
XSLTransformException - when an IOException, format error, or
something else prevents the stylesheet from being compiled
public XSLTransformer(Document stylesheet)
throws XSLTransformException
This will create a new XSLTransformer by
reading the stylesheet from the specified
Document.
stylesheet - Document containing the stylesheet.
XSLTransformException - when the supplied Document
is not syntactically correct XSLT| Method Detail |
public java.util.List transform(java.util.List inputNodes)
throws XSLTransformException
inputNodes - input nodes
XSLTransformException - if there's a problem in the transformation
public Document transform(Document inputDoc)
throws XSLTransformException
inputDoc - input document
XSLTransformException - if there's a problem in the transformation
|
JDOM 1.0beta10-dev |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||