Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> jdom >> [ transform overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

org.jdom.transform
Class XSLTransformer  

java.lang.Object
  org.jdom.transform.XSLTransformer

---

public class XSLTransformer

extends java.lang.Object

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:

1. Invoking System.setProperty( "javax.xml.transform.TransformerFactory", "classname")
2. The value specified at the command line using the -Djavax.xml.transform.TransformerFactory=classname option to the java interpreter
3. 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

4. The class named in the META-INF/services/javax.xml.transform.TransformerFactory file in the JAR archives available to the runtime
5. 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 $

---

Field Summary
private static java.lang.String	CVS_ID
private  javax.xml.transform.Templates	templates

 

Constructor Summary
	XSLTransformer(org.jdom.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.
private	XSLTransformer(javax.xml.transform.Source stylesheet)
	XSLTransformer(java.lang.String stylesheetSystemId)           Creates a transformer for a given stylesheet system id.

 

Method Summary
org.jdom.Document	transform(org.jdom.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

 

Field Detail

CVS_ID

private static final java.lang.String CVS_ID

See Also:

Constant Field Values

---

templates

private javax.xml.transform.Templates templates

Constructor Detail

XSLTransformer

private XSLTransformer(javax.xml.transform.Source stylesheet)
                throws XSLTransformException

---

XSLTransformer

public XSLTransformer(java.lang.String stylesheetSystemId)
               throws XSLTransformException

Creates a transformer for a given stylesheet system id.

---

XSLTransformer

public XSLTransformer(java.io.InputStream stylesheet)
               throws XSLTransformException

This will create a new XSLTransformer by reading the stylesheet from the specified InputStream.

---

XSLTransformer

public XSLTransformer(java.io.Reader stylesheet)
               throws XSLTransformException

This will create a new XSLTransformer by reading the stylesheet from the specified Reader.

---

XSLTransformer

public XSLTransformer(java.io.File stylesheet)
               throws XSLTransformException

This will create a new XSLTransformer by reading the stylesheet from the specified File.

---

XSLTransformer

public XSLTransformer(org.jdom.Document stylesheet)
               throws XSLTransformException

This will create a new XSLTransformer by reading the stylesheet from the specified Document.

Method Detail

transform

public java.util.List transform(java.util.List inputNodes)
                         throws XSLTransformException

Transforms the given input nodes to a list of output nodes.

---

transform

public org.jdom.Document transform(org.jdom.Document inputDoc)
                            throws XSLTransformException

Transforms the given document to an output document.

---

Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> jdom >> [ transform overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---