public abstract class TransformerFactory
extends java.lang.Object
The system property that determines which Factory implementation to create is named "javax.xml.transform.TransformerFactory". This property names a concrete subclass of the TransformerFactory abstract class. If the property is not defined, a platform default is be used.
Modifier and Type | Method and Description |
---|---|
abstract Source |
getAssociatedStylesheet(Source source, java.lang.String media, java.lang.String title, java.lang.String charset)
Get the stylesheet specification(s) associated via the xml-stylesheet processing instruction (see http://www.w3.org/TR/xml-stylesheet/) with the document document specified in the source parameter, and that match the given criteria.
|
abstract java.lang.Object |
getAttribute(java.lang.String name)
Allows the user to retrieve specific attributes on the underlying implementation.
|
abstract ErrorListener |
getErrorListener()
Get the error event handler for the TransformerFactory.
|
abstract boolean |
getFeature(java.lang.String name)
Look up the value of a feature.
|
abstract URIResolver |
getURIResolver()
Get the object that is used by default during the transformation to resolve URIs used in document(), xsl:import, or xsl:include.
|
static TransformerFactory |
newInstance()
Obtain a new instance of a
TransformerFactory . |
abstract Templates |
newTemplates(Source source)
Process the Source into a Templates object, which is a a compiled representation of the source.
|
abstract Transformer |
newTransformer()
Create a new Transformer object that performs a copy of the source to the result.
|
abstract Transformer |
newTransformer(Source source)
Process the Source into a Transformer object.
|
abstract void |
setAttribute(java.lang.String name, java.lang.Object value)
Allows the user to set specific attributes on the underlying implementation.
|
abstract void |
setErrorListener(ErrorListener listener)
Set the error event listener for the TransformerFactory, which is used for the processing of transformation instructions, and not for the transformation itself.
|
abstract void |
setURIResolver(URIResolver resolver)
Set an object that is used by default during the transformation to resolve URIs used in xsl:import, or xsl:include.
|
public static TransformerFactory newInstance() throws TransformerFactoryConfigurationError
TransformerFactory
. This static method creates a new factory instance This method uses the following ordered lookup procedure to determine the TransformerFactory
implementation class to load:
javax.xml.parsers.DocumentBuilderFactory
system property.META-INF/services/javax.xml.parsers.TransformerFactory
in jars available to the runtime.TransformerFactory
instance.TransformerFactory
it can use the factory to configure and obtain parser instances.TransformerFactoryConfigurationError
- if the implmentation is not available or cannot be instantiated.public abstract Transformer newTransformer(Source source) throws TransformerConfigurationException
source
- An object that holds a URI, input stream, etc.TransformerConfigurationException
- May throw this during the parse when it is constructing the Templates object and fails.public abstract Transformer newTransformer() throws TransformerConfigurationException
TransformerConfigurationException
- May throw this during the parse when it is constructing the Templates object and fails.public abstract Templates newTemplates(Source source) throws TransformerConfigurationException
source
- An object that holds a URL, input stream, etc.TransformerConfigurationException
- May throw this during the parse when it is constructing the Templates object and fails.public abstract Source getAssociatedStylesheet(Source source, java.lang.String media, java.lang.String title, java.lang.String charset) throws TransformerConfigurationException
source
- The XML source document.media
- The media attribute to be matched. May be null, in which case the prefered templates will be used (i.e. alternate = no).title
- The value of the title attribute to match. May be null.charset
- The value of the charset attribute to match. May be null.TransformerConfigurationException.
TransformerConfigurationException
public abstract void setURIResolver(URIResolver resolver)
resolver
- An object that implements the URIResolver interface, or null.public abstract URIResolver getURIResolver()
public abstract boolean getFeature(java.lang.String name)
The feature name is any absolute URI.
name
- The feature name, which is an absolute URI.public abstract void setAttribute(java.lang.String name, java.lang.Object value) throws java.lang.IllegalArgumentException
name
- The name of the attribute.value
- The value of the attribute.java.lang.IllegalArgumentException
- thrown if the underlying implementation doesn't recognize the attribute.public abstract java.lang.Object getAttribute(java.lang.String name) throws java.lang.IllegalArgumentException
name
- The name of the attribute.java.lang.IllegalArgumentException
- thrown if the underlying implementation doesn't recognize the attribute.public abstract void setErrorListener(ErrorListener listener) throws java.lang.IllegalArgumentException
listener
- The new error listener.java.lang.IllegalArgumentException
- if listener is null.public abstract ErrorListener getErrorListener()