net.sf.saxon
public class TransformerFactoryImpl extends SAXTransformerFactory
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.
This implementation class implements the abstract methods on both the javax.xml.transform.TransformerFactory and javax.xml.transform.sax.SAXTransformerFactory classes.
Constructor Summary | |
---|---|
TransformerFactoryImpl()
Default constructor. | |
TransformerFactoryImpl(Configuration config)
Construct a TransformerFactory using an existing Configuration. |
Method Summary | |
---|---|
Source | getAssociatedStylesheet(Source source, String media, String title, 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. |
Object | getAttribute(String name)
Allows the user to retrieve specific attributes on the underlying
implementation. |
Configuration | getConfiguration()
Get the configuration (en bloc) |
ErrorListener | getErrorListener()
Get the error event handler for the TransformerFactory. |
boolean | getFeature(String name)
Look up the value of a feature.
|
URIResolver | getURIResolver()
Get the object that is used by default during the transformation
to resolve URIs used in document(), xsl:import, or xsl:include.
|
Templates | newTemplates(Source source)
Process the Source into a Templates object, which is a
a compiled representation of the source. |
Templates | newTemplates(Source source, CompilerInfo info)
Process the Source into a Templates object, which is a
a compiled representation of the source. |
TemplatesHandler | newTemplatesHandler()
Get a TemplatesHandler object that can process SAX
ContentHandler events into a Templates object.
|
Transformer | newTransformer(Source source)
Process the Source into a Transformer object. |
Transformer | newTransformer()
Create a new Transformer object that performs a copy
of the source to the result.
|
TransformerHandler | newTransformerHandler(Source src)
Get a TransformerHandler object that can process SAX
ContentHandler events into a Result, based on the transformation
instructions specified by the argument.
|
TransformerHandler | newTransformerHandler(Templates templates)
Get a TransformerHandler object that can process SAX
ContentHandler events into a Result, based on the Templates argument.
|
TransformerHandler | newTransformerHandler()
Get a TransformerHandler object that can process SAX
ContentHandler events into a Result. |
XMLFilter | newXMLFilter(Source src)
Create an XMLFilter that uses the given Source as the
transformation instructions.
|
XMLFilter | newXMLFilter(Templates templates)
Create an XMLFilter, based on the Templates argument..
|
void | setAttribute(String name, Object value)
Allows the user to set specific attributes on the underlying
implementation. |
void | setConfiguration(Configuration config)
Set the configuration (en bloc) |
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.
|
void | setFeature(String name, boolean value) Set a feature for this |
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.
|
Parameters: 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.
Returns: A Source object suitable for passing to the TransformerFactory.
Throws: TransformerConfigurationException if any problems occur
Parameters: name The name of the attribute.
Returns: value The value of the attribute.
Throws: IllegalArgumentException thrown if the underlying implementation doesn't recognize the attribute.
Returns: The current error listener, which should never be null.
The feature name is any absolute URI.
Parameters: name The feature name, which is an absolute URI.
Returns: The current state of the feature (true or false).
Returns: The URIResolver that was set with setURIResolver.
Parameters: source An object that holds a URL, input stream, etc.
Returns: A Templates object capable of being used for transformation purposes, never null.
Throws: TransformerConfigurationException May throw this during the parse when it is constructing the Templates object and fails.
Parameters: source An object that holds a URL, input stream, etc.
Returns: A Templates object capable of being used for transformation purposes, never null.
Throws: TransformerConfigurationException May throw this during the parse when it is constructing the Templates object and fails.
Returns: A non-null reference to a TransformerHandler, that may be used as a ContentHandler for SAX parse events.
Throws: TransformerConfigurationException If for some reason the TemplatesHandler cannot be created.
Parameters: source An object that holds a URI, input stream, etc.
Returns: A Transformer object that may be used to perform a transformation in a single thread, never null.
Throws: TransformerConfigurationException May throw this during the parse when it is constructing the Templates object and fails.
Returns: A Transformer object that may be used to perform a transformation in a single thread, never null.
Throws: TransformerConfigurationException May throw this during the parse when it is constructing the Templates object and fails.
Parameters: src The Source of the transformation instructions.
Returns: TransformerHandler ready to transform SAX events.
Throws: TransformerConfigurationException If for some reason the TransformerHandler can not be created.
Parameters: templates The compiled transformation instructions.
Returns: TransformerHandler ready to transform SAX events.
Throws: TransformerConfigurationException If for some reason the TransformerHandler can not be created.
Returns: A non-null reference to a TransformerHandler, that may be used as a ContentHandler for SAX parse events.
Throws: TransformerConfigurationException If for some reason the TransformerHandler cannot be created.
Parameters: src The Source of the transformation instructions.
Returns: An XMLFilter object, or null if this feature is not supported.
Throws: TransformerConfigurationException If for some reason the XMLFilter cannot be created.
Parameters: templates The compiled transformation instructions.
Returns: An XMLFilter object, or null if this feature is not supported.
Throws: TransformerConfigurationException If for some reason the XMLFilter cannot be created.
Parameters: name The name of the attribute. This must be one of the constants defined in class FeatureKeys. value The value of the attribute.
Throws: IllegalArgumentException thrown if Saxon doesn't recognize the attribute.
See Also: FeatureKeys
Parameters: listener The new error listener.
Throws: IllegalArgumentException if listener is null.
Set a feature for this TransformerFactory
and Transformer
s
or Template
s created by this factory.
TransformerFactory
or the
Transformer
s or Template
s it creates cannot support the feature.
It is possible for an TransformerFactory
to expose a feature value but be unable to change its state.
All implementations are required to support the FEATURE_SECURE_PROCESSING feature. When the feature is:
true
: the implementation will limit XML processing to conform to implementation limits
and behave in a secure fashion as defined by the implementation.
Examples include resolving user defined style sheets and functions.
If XML processing is limited for security reasons, it will be reported via a call to the registered
javax.xml.transform.ErrorListener#fatalError(javax.xml.transform.TransformerException exception).
See TransformerFactoryImpl. In the Saxon implementation,
this option causes calls on extension functions and extensions instructions to be disabled, and also
disables the use of xsl:result-document to write to secondary output destinations.
false
: the implementation will processing XML according to the XML specifications without
regard to possible implementation limits.
Parameters: name Feature name. value Is feature state true
or false
.
Throws: javax.xml.transform.TransformerConfigurationException
if this TransformerFactory
or the Transformer
s or Template
s it creates cannot support this feature. NullPointerException If the name
parameter is null.
Parameters: resolver An object that implements the URIResolver interface, or null.