org.apache.xalan.processor
public class TransformerFactoryImpl extends SAXTransformerFactory
Field Summary | |
---|---|
static String | FEATURE_INCREMENTAL Static string to be used for incremental feature |
static String | FEATURE_OPTIMIZE Static string to be used for optimize feature |
static String | FEATURE_SOURCE_LOCATION Static string to be used for source_location feature |
static String | XSLT_PROPERTIES
The path/filename of the property file: XSLTInfo.properties
Maintenance note: see also
org.apache.xpath.functions.FuncSystemProperty.XSLT_PROPERTIES |
Constructor Summary | |
---|---|
TransformerFactoryImpl()
Constructor TransformerFactoryImpl
|
Method Summary | |
---|---|
Source | getAssociatedStylesheet(Source source, String media, String title, String charset)
Get InputSource specification(s) that are associated with the
given document specified in the source param,
via the xml-stylesheet processing instruction
(see http://www.w3.org/TR/xml-stylesheet/), and that matches
the given criteria. |
Object | getAttribute(String name)
Allows the user to retrieve specific attributes on the underlying
implementation.
|
ErrorListener | getErrorListener()
Get the error listener in effect for the TransformerFactory.
|
boolean | getFeature(String name)
Look up the value of a feature.
|
URIResolver | getURIResolver()
Get the object that will be used to resolve URIs used in
xsl:import, etc. |
boolean | isSecureProcessing()
Return the state of the secure processing feature.
|
Templates | newTemplates(Source source)
Process the source into a Templates object, which is likely
a compiled representation of the source. |
TemplatesHandler | newTemplatesHandler()
Create a new Transformer object that performs a copy
of the source to the result.
|
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 that uses the given source as the
transformation instructions.
|
Templates | processFromNode(Node node) |
void | setAttribute(String name, Object value)
Allows the user to set specific attributes on the underlying
implementation.
|
void | setErrorListener(ErrorListener listener)
Set an error listener for the TransformerFactory.
|
void | setFeature(String name, boolean value) Set a feature for this Feature names are fully qualified java.net.URIs. |
void | setURIResolver(URIResolver resolver)
Set an object that will be used to resolve URIs used in
xsl:import, etc. |
org.apache.xpath.functions.FuncSystemProperty.XSLT_PROPERTIES
Note that DOM2 has it's own mechanism for discovering stylesheets. Therefore, there isn't a DOM version of this method.
Parameters: source The XML source that is to be searched. 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 capable of being used to create a Templates object.
Throws: TransformerConfigurationException
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: A non-null reference to an error listener.
The feature name is any fully-qualified URI. It is possible for an TransformerFactory to recognize a feature name but to be unable to return its value; this is especially true in the case of an adapter for a SAX1 Parser, which has no way of knowing whether the underlying parser is validating, for example.
Parameters: name The feature name, which is a fully-qualified URI.
Returns: The current state of the feature (true or false).
Returns: The URIResolver that was set with setURIResolver.
Returns: state of the secure processing feature.
Parameters: source An object that holds a URL, input stream, etc.
Returns: A Templates object capable of being used for transformation purposes.
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: source An object that holds a URL, input stream, etc.
Returns: A Transformer object capable of being used for transformation purposes in a single thread.
Throws: TransformerConfigurationException May throw this during the parse when it is constructing the Templates object and fails.
Returns: A Transformer object capable of being used for transformation purposes in a single thread.
Throws: TransformerConfigurationException May throw this during the parse when it is constructing the Templates object and it fails.
Parameters: src The source of the transformation instructions.
Returns: TransformerHandler ready to transform SAX events.
Throws: TransformerConfigurationException
Parameters: templates The source of the transformation instructions.
Returns: TransformerHandler ready to transform SAX events.
Throws: TransformerConfigurationException
Returns: TransformerHandler ready to transform SAX events.
Throws: TransformerConfigurationException
Parameters: src The source of the transformation instructions.
Returns: An XMLFilter object, or null if this feature is not supported.
Throws: TransformerConfigurationException
Parameters: templates non-null reference to Templates object.
Returns: An XMLFilter object, or null if this feature is not supported.
Throws: TransformerConfigurationException
Parameters: name The name of the attribute. value The value of the attribute; Boolean or String="true"|"false"
Throws: IllegalArgumentException thrown if the underlying implementation doesn't recognize the attribute.
Parameters: listener Must be a non-null reference to an ErrorListener.
Throws: IllegalArgumentException if the listener argument is null.
Set a feature for this TransformerFactory
and Transformer
s
or Template
s created by this factory.
Feature names are fully qualified java.net.URIs.
Implementations may define their own features.
An TransformerConfigurationException is thrown if this 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.
See javax.xml.transform.TransformerFactory for full documentation of specific features.
Parameters: name Feature name. value Is feature state true
or false
.
Throws: 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.