|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.cdmckay.coffeedom.transform.XSLTransformer
public class XSLTransformer
A convenience class to handle simple transformations. The JAXP TrAX classes have more bells and whistles and can be
used with CoffeeDOMSource
and CoffeeDOMResult
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
CoffeeDOM 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 runtime
Constructor Summary | |
---|---|
XSLTransformer(Document stylesheet)
This will create a new XSLTransformer by reading the stylesheet from the specified
Document . |
|
XSLTransformer(File stylesheet)
This will create a new XSLTransformer by reading the stylesheet from the specified
File . |
|
XSLTransformer(InputStream stylesheet)
This will create a new XSLTransformer by reading the stylesheet from the specified
InputStream . |
|
XSLTransformer(Reader stylesheet)
This will create a new XSLTransformer by reading the stylesheet from the specified
Reader . |
|
XSLTransformer(String stylesheetSystemId)
Creates a transformer for a given stylesheet system id. |
Method Summary | |
---|---|
CoffeeDOMFactory |
getFactory()
Returns the custom CoffeeDOMFactory used to build the transformation result. |
void |
setFactory(CoffeeDOMFactory factory)
Sets a custom CoffeeDOMFactory to use when building the transformation result. |
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. |
List |
transform(List<Content> 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(String stylesheetSystemId) throws XSLTransformException
stylesheetSystemId
- source stylesheet as a Source object
XSLTransformException
- if there's a problem in the TrAX back-endpublic XSLTransformer(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 compiledpublic XSLTransformer(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 compiledpublic XSLTransformer(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 compiledpublic 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 XSLTMethod Detail |
---|
public List transform(List<Content> inputNodes) throws XSLTransformException
inputNodes
- input nodes
XSLTransformException
- if there's a problem in the transformationpublic Document transform(Document inputDoc) throws XSLTransformException
inputDoc
- input document
XSLTransformException
- if there's a problem in the transformationpublic Document transform(Document inputDoc, EntityResolver resolver) throws XSLTransformException
inputDoc
- input documentresolver
- entity resolver for the input document
XSLTransformException
- if there's a problem in the transformationpublic void setFactory(CoffeeDOMFactory factory)
factory
- the custom CoffeeDOMFactory
to use or null
to use the default CoffeeDOM classes.getFactory()
public CoffeeDOMFactory getFactory()
CoffeeDOMFactory
used to build the transformation result or null
if the
default CoffeeDOM classes are being used.setFactory(org.cdmckay.coffeedom.CoffeeDOMFactory)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |