org::jdom::transform::XSLTransformer Class Reference
List of all members.
Detailed Description
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:
-
Saxon 6.x:
com.icl.saxon.TransformerFactoryImpl
-
Saxon 7.x:
net.sf.saxon.TransformerFactoryImpl
-
Xalan:
org.apache.xalan.processor.TransformerFactoryImpl
-
jd.xslt:
jd.xml.xslt.trax.TransformerFactoryImpl
-
Oracle:
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:
-
Invoking
System.setProperty( "javax.xml.transform.TransformerFactory", "<i><code>classname</code></i>")
-
The value specified at the command line using the
-Djavax.xml.transform.TransformerFactory=classname
option to the java interpreter
-
The class named in the
lib/jaxp.properties
properties file in the JRE directory, in a line like this one: javax.xml.parsers.DocumentBuilderFactory=classname
-
The class named in the
META-INF/services/javax.xml.transform.TransformerFactory
file in the JAR archives available to the runtime
-
Finally, if all of the above options fail, a default implementation is chosen. In Sun's JDK 1.4, this is Xalan 2.2d10.
- Version:
- Revision
- 1.2
, - Date
- 2004/02/06 09:28:32
- Author:
- Jason Hunter
Elliotte Rusty Harold
Constructor & Destructor Documentation
org::jdom::transform::XSLTransformer::XSLTransformer |
( |
String |
stylesheetSystemId |
) |
throws XSLTransformException [inline] |
|
|
Creates a transformer for a given stylesheet system id.
- Parameters:
-
| stylesheetSystemId | source stylesheet as a Source object |
- Exceptions:
-
| XSLTransformException | if there's a problem in the TrAX back-end |
|
org::jdom::transform::XSLTransformer::XSLTransformer |
( |
InputStream |
stylesheet |
) |
throws XSLTransformException [inline] |
|
|
This will create a new XSLTransformer by reading the stylesheet from the specified InputStream .
- Parameters:
-
| stylesheet | InputStream from which the stylesheet is read. |
- Exceptions:
-
| XSLTransformException | when an IOException, format error, or something else prevents the stylesheet from being compiled |
|
org::jdom::transform::XSLTransformer::XSLTransformer |
( |
Reader |
stylesheet |
) |
throws XSLTransformException [inline] |
|
|
This will create a new XSLTransformer by reading the stylesheet from the specified Reader .
- Parameters:
-
| stylesheet | Reader from which the stylesheet is read. |
- Exceptions:
-
| XSLTransformException | when an IOException, format error, or something else prevents the stylesheet from being compiled |
|
org::jdom::transform::XSLTransformer::XSLTransformer |
( |
File |
stylesheet |
) |
throws XSLTransformException [inline] |
|
|
This will create a new XSLTransformer by reading the stylesheet from the specified File .
- Parameters:
-
| stylesheet | File from which the stylesheet is read. |
- Exceptions:
-
| 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. |
- Exceptions:
-
| XSLTransformException | when the supplied Document is not syntactically correct XSLT |
|
Member Function Documentation
|
Transforms the given document to an output document.
- Parameters:
-
- Returns:
- transformed output document
- Exceptions:
-
| XSLTransformException | if there's a problem in the transformation |
|
List org::jdom::transform::XSLTransformer::transform |
( |
List |
inputNodes |
) |
throws XSLTransformException [inline] |
|
|
Transforms the given input nodes to a list of output nodes.
- Parameters:
-
- Returns:
- transformed output nodes
- Exceptions:
-
| XSLTransformException | if there's a problem in the transformation |
|
The documentation for this class was generated from the following file:
- src/java/org/jdom/transform/XSLTransformer.java
Generated on Thu Dec 9 10:42:05 2004 for JDOM by
1.3.9.1