Class TransformerFactoryImpl
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final String
Static string to be used for incremental featurestatic final String
Static string to be used for optimize featurestatic final String
Static string to be used for source_location featurestatic final String
The path/filename of the property file: XSLTInfo.properties Maintenance note: see alsoorg.apache.xpath.functions.FuncSystemProperty.XSLT_PROPERTIES
Fields inherited from class javax.xml.transform.sax.SAXTransformerFactory
FEATURE, FEATURE_XMLFILTER
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptiongetAssociatedStylesheet
(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.getAttribute
(String name) Allows the user to retrieve specific attributes on the underlying implementation.Get the error listener in effect for the TransformerFactory.boolean
getFeature
(String name) Look up the value of a feature.Get the object that will be used to resolve URIs used in xsl:import, etc.boolean
Return the state of the secure processing feature.newTemplates
(Source source) Process the source into a Templates object, which is likely a compiled representation of the source.Create a new Transformer object that performs a copy of the source to the result.Create a new Transformer object that performs a copy of the source to the result.newTransformer
(Source source) Process the source into a Transformer object.Get a TransformerHandler object that can process SAX ContentHandler events into a Result.Get a TransformerHandler object that can process SAX ContentHandler events into a Result, based on the transformation instructions specified by the argument.newTransformerHandler
(Templates templates) Get a TransformerHandler object that can process SAX ContentHandler events into a Result, based on the Templates argument.newXMLFilter
(Source src) Create an XMLFilter that uses the given source as the transformation instructions.newXMLFilter
(Templates templates) Create an XMLFilter that uses the given source as the transformation instructions.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 thisTransformerFactory
andTransformer
s orTemplate
s created by this factory.void
setURIResolver
(URIResolver resolver) Set an object that will be used to resolve URIs used in xsl:import, etc.Methods inherited from class javax.xml.transform.TransformerFactory
newDefaultInstance, newInstance, newInstance
-
Field Details
-
XSLT_PROPERTIES
The path/filename of the property file: XSLTInfo.properties Maintenance note: see alsoorg.apache.xpath.functions.FuncSystemProperty.XSLT_PROPERTIES
- See Also:
-
FEATURE_INCREMENTAL
Static string to be used for incremental feature- See Also:
-
FEATURE_OPTIMIZE
Static string to be used for optimize feature- See Also:
-
FEATURE_SOURCE_LOCATION
Static string to be used for source_location feature- See Also:
-
-
Constructor Details
-
TransformerFactoryImpl
public TransformerFactoryImpl()Constructor TransformerFactoryImpl
-
-
Method Details
-
processFromNode
-
getAssociatedStylesheet
public Source getAssociatedStylesheet(Source source, String media, String title, String charset) throws TransformerConfigurationException 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. Note that it is possible to return several stylesheets that match the criteria, in which case they are applied as if they were a list of imports or cascades.Note that DOM2 has it's own mechanism for discovering stylesheets. Therefore, there isn't a DOM version of this method.
- Specified by:
getAssociatedStylesheet
in classTransformerFactory
- 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
-
newTemplatesHandler
Create a new Transformer object that performs a copy of the source to the result.- Specified by:
newTemplatesHandler
in classSAXTransformerFactory
- 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.
-
setFeature
Set a feature for this
TransformerFactory
andTransformer
s orTemplate
s created by this factory.Feature names are fully qualified
URI
s. Implementations may define their own features. AnTransformerConfigurationException
is thrown if thisTransformerFactory
or theTransformer
s orTemplate
s it creates cannot support the feature. It is possible for anTransformerFactory
to expose a feature value but be unable to change its state.See
TransformerFactory
for full documentation of specific features.- Specified by:
setFeature
in classTransformerFactory
- Parameters:
name
- Feature name.value
- Is feature statetrue
orfalse
.- Throws:
TransformerConfigurationException
- if thisTransformerFactory
or theTransformer
s orTemplate
s it creates cannot support this feature.NullPointerException
- If thename
parameter is null.
-
getFeature
Look up the value of a feature.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.
- Specified by:
getFeature
in classTransformerFactory
- Parameters:
name
- The feature name, which is a fully-qualified URI.- Returns:
- The current state of the feature (true or false).
-
setAttribute
Allows the user to set specific attributes on the underlying implementation.- Specified by:
setAttribute
in classTransformerFactory
- 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.
-
getAttribute
Allows the user to retrieve specific attributes on the underlying implementation.- Specified by:
getAttribute
in classTransformerFactory
- 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.
-
newXMLFilter
Create an XMLFilter that uses the given source as the transformation instructions.- Specified by:
newXMLFilter
in classSAXTransformerFactory
- Parameters:
src
- The source of the transformation instructions.- Returns:
- An XMLFilter object, or null if this feature is not supported.
- Throws:
TransformerConfigurationException
-
newXMLFilter
Create an XMLFilter that uses the given source as the transformation instructions.- Specified by:
newXMLFilter
in classSAXTransformerFactory
- Parameters:
templates
- non-null reference to Templates object.- Returns:
- An XMLFilter object, or null if this feature is not supported.
- Throws:
TransformerConfigurationException
-
newTransformerHandler
public TransformerHandler newTransformerHandler(Source src) throws TransformerConfigurationException Get a TransformerHandler object that can process SAX ContentHandler events into a Result, based on the transformation instructions specified by the argument.- Specified by:
newTransformerHandler
in classSAXTransformerFactory
- Parameters:
src
- The source of the transformation instructions.- Returns:
- TransformerHandler ready to transform SAX events.
- Throws:
TransformerConfigurationException
-
newTransformerHandler
public TransformerHandler newTransformerHandler(Templates templates) throws TransformerConfigurationException Get a TransformerHandler object that can process SAX ContentHandler events into a Result, based on the Templates argument.- Specified by:
newTransformerHandler
in classSAXTransformerFactory
- Parameters:
templates
- The source of the transformation instructions.- Returns:
- TransformerHandler ready to transform SAX events.
- Throws:
TransformerConfigurationException
-
newTransformerHandler
Get a TransformerHandler object that can process SAX ContentHandler events into a Result.- Specified by:
newTransformerHandler
in classSAXTransformerFactory
- Returns:
- TransformerHandler ready to transform SAX events.
- Throws:
TransformerConfigurationException
-
newTransformer
Process the source into a Transformer object. Care must be given to know that this object can not be used concurrently in multiple threads.- Specified by:
newTransformer
in classTransformerFactory
- 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.
-
newTransformer
Create a new Transformer object that performs a copy of the source to the result.- Specified by:
newTransformer
in classTransformerFactory
- 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.
-
newTemplates
Process the source into a Templates object, which is likely a compiled representation of the source. This Templates object may then be used concurrently across multiple threads. Creating a Templates object allows the TransformerFactory to do detailed performance optimization of transformation instructions, without penalizing runtime transformation.- Specified by:
newTemplates
in classTransformerFactory
- 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.
-
setURIResolver
Set an object that will be used to resolve URIs used in xsl:import, etc. This will be used as the default for the transformation.- Specified by:
setURIResolver
in classTransformerFactory
- Parameters:
resolver
- An object that implements the URIResolver interface, or null.
-
getURIResolver
Get the object that will be used to resolve URIs used in xsl:import, etc. This will be used as the default for the transformation.- Specified by:
getURIResolver
in classTransformerFactory
- Returns:
- The URIResolver that was set with setURIResolver.
-
getErrorListener
Get the error listener in effect for the TransformerFactory.- Specified by:
getErrorListener
in classTransformerFactory
- Returns:
- A non-null reference to an error listener.
-
setErrorListener
Set an error listener for the TransformerFactory.- Specified by:
setErrorListener
in classTransformerFactory
- Parameters:
listener
- Must be a non-null reference to an ErrorListener.- Throws:
IllegalArgumentException
- if the listener argument is null.
-
isSecureProcessing
public boolean isSecureProcessing()Return the state of the secure processing feature.- Returns:
- state of the secure processing feature.
-