javax.xml.transform
Class TransformerFactory
java.lang.Object
javax.xml.transform.TransformerFactory
public abstract class TransformerFactory
extends java.lang.Object
Factory for obtaining transformation contexts.
abstract Source | getAssociatedStylesheet(Source source, String media, String title, String charset) - Returns a source object representing the XML resource specified by the
xml-stylesheet
processing instruction and matching the given criteria.
|
abstract Object | getAttribute(String name) - Retrieve the specified named attribute value.
|
abstract ErrorListener | getErrorListener() - Returns the callback to be used by transformers obtained from this
factory to report transformation errors.
|
abstract boolean | getFeature(String name) - Returns the state of a feature in the factory implementation.
|
abstract URIResolver | getURIResolver() - Returns the resolver callback to be used by transformers obtained from
this factory.
|
static TransformerFactory | newInstance() - Creates a new factory instance.
|
abstract Templates | newTemplates(Source source) - Creates a new compiled transformation using the specified stylesheet.
|
abstract Transformer | newTransformer() - Creates a new transformer that applies the identity transform.
|
abstract Transformer | newTransformer(Source source) - Creates a new transformer using the specified stylesheet.
|
abstract void | setAttribute(String name, Object value) - Set a named attribute on the underlying implementation.
|
abstract void | setErrorListener(ErrorListener listener) - Sets the callback to be used by transformers obtained from this factory
to report transformation errors.
|
abstract void | setFeature(String name, boolean value) - Sets a feature of transformers and templates obtained from this
factory.
|
abstract void | setURIResolver(URIResolver resolver) - Set the resolver callback to be used by transformers obtained from
this factory.
|
TransformerFactory
protected TransformerFactory()
getAssociatedStylesheet
public abstract Source getAssociatedStylesheet(Source source,
String media,
String title,
String charset)
throws TransformerConfigurationException
Returns a source object representing the XML resource specified by the
xml-stylesheet
processing instruction and matching the given criteria.
Note that if multiple stylesheets are selected, the source represents a
stylesheet composed of a list of imports.
source
- the source XML documentmedia
- the media attribute to match, or null
to match
the preferred templatestitle
- the title attribute to match, or null
to match
anycharset
- the charset attribute to match, or null
to
match any
getAttribute
public abstract Object getAttribute(String name)
throws IllegalArgumentException
Retrieve the specified named attribute value.
name
- the attribute name
getErrorListener
public abstract ErrorListener getErrorListener()
Returns the callback to be used by transformers obtained from this
factory to report transformation errors.
getFeature
public abstract boolean getFeature(String name)
Returns the state of a feature in the factory implementation.
Feature names are fully qualified URIs, and may depend on the factory
implementation. JAXP also predefines several features, including the
constants in
javax.xml.XMLConstants
and
The latter expose various capabilities of the factory implementation.
getURIResolver
public abstract URIResolver getURIResolver()
Returns the resolver callback to be used by transformers obtained from
this factory.
newInstance
public static TransformerFactory newInstance()
throws TransformerFactoryConfigurationError
Creates a new factory instance.
The implementation class to load is the first found in the following
locations:
- the
javax.xml.transform.TransformerFactory
system
property - the above named property value in the
$JAVA_HOME/lib/jaxp.properties
file - the class name specified in the
META-INF/services/javax.xml.parsers.DocumentBuilderFactory
system resource - the default factory class
setAttribute
public abstract void setAttribute(String name,
Object value)
throws IllegalArgumentException
Set a named attribute on the underlying implementation.
name
- the attribute namevalue
- the value to assign
setErrorListener
public abstract void setErrorListener(ErrorListener listener)
throws IllegalArgumentException
Sets the callback to be used by transformers obtained from this factory
to report transformation errors.
setFeature
public abstract void setFeature(String name,
boolean value)
throws TransformerConfigurationException
Sets a feature of transformers and templates obtained from this
factory.
Feature names are fully qualified URIs, and may depend on the factory
implementation.
name
- the name of the featurevalue
- the feature state
setURIResolver
public abstract void setURIResolver(URIResolver resolver)
Set the resolver callback to be used by transformers obtained from
this factory.