|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.xml.transform.TransformerFactory
javax.xml.transform.sax.SAXTransformerFactory
net.sf.saxon.TransformerFactoryImpl
A TransformerFactoryImpl instance can be used to create Transformer and Template objects.
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.
Field Summary |
---|
Fields inherited from class javax.xml.transform.sax.SAXTransformerFactory |
---|
FEATURE, FEATURE_XMLFILTER |
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()
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. |
TransformerHandler |
newTransformerHandler()
Get a TransformerHandler object that can process SAX ContentHandler events into a 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. |
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 TransformerFactory and Transformer s
or Template s created by this factory. |
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. |
Methods inherited from class javax.xml.transform.TransformerFactory |
---|
newInstance |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public TransformerFactoryImpl()
public TransformerFactoryImpl(Configuration config)
Method Detail |
public void setConfiguration(Configuration config)
public Configuration getConfiguration()
public 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 Transformer newTransformer() throws TransformerConfigurationException
TransformerConfigurationException
- May throw this during
the parse when it is constructing the
Templates object and fails.public 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 Templates newTemplates(Source source, CompilerInfo info) 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 Source getAssociatedStylesheet(Source source, String media, String title, 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
- if any problems occurpublic void setURIResolver(URIResolver resolver)
resolver
- An object that implements the URIResolver interface,
or null.public URIResolver getURIResolver()
public boolean getFeature(String name)
The feature name is any absolute URI.
name
- The feature name, which is an absolute URI.
public void setAttribute(String name, Object value) throws IllegalArgumentException
name
- The name of the attribute. This must be one of the constants
defined in class FeatureKeys
.value
- The value of the attribute.
IllegalArgumentException
- thrown if Saxon
doesn't recognize the attribute.FeatureKeys
public Object getAttribute(String name) throws IllegalArgumentException
name
- The name of the attribute.
IllegalArgumentException
- thrown if the underlying
implementation doesn't recognize the attribute.public void setErrorListener(ErrorListener listener) throws IllegalArgumentException
listener
- The new error listener.
IllegalArgumentException
- if listener is null.public ErrorListener getErrorListener()
public TransformerHandler newTransformerHandler(Source src) throws TransformerConfigurationException
src
- The Source of the transformation instructions.
TransformerConfigurationException
- If for some reason the
TransformerHandler can not be created.public TransformerHandler newTransformerHandler(Templates templates) throws TransformerConfigurationException
templates
- The compiled transformation instructions.
TransformerConfigurationException
- If for some reason the
TransformerHandler can not be created.public TransformerHandler newTransformerHandler() throws TransformerConfigurationException
TransformerConfigurationException
- If for some reason the
TransformerHandler cannot be created.public TemplatesHandler newTemplatesHandler() throws TransformerConfigurationException
TransformerConfigurationException
- If for some reason the
TemplatesHandler cannot be created.public XMLFilter newXMLFilter(Source src) throws TransformerConfigurationException
src
- The Source of the transformation instructions.
TransformerConfigurationException
- If for some reason the
XMLFilter cannot be created.public XMLFilter newXMLFilter(Templates templates) throws TransformerConfigurationException
templates
- The compiled transformation instructions.
TransformerConfigurationException
- If for some reason the
XMLFilter cannot be created.public void setFeature(String name, boolean value) throws TransformerConfigurationException
Set a feature for this TransformerFactory
and Transformer
s
or Template
s created by this factory.
URI
s.
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.
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
ErrorListener.fatalError(javax.xml.transform.TransformerException exception)
.
See setErrorListener(javax.xml.transform.ErrorListener listener)
. 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.
name
- Feature name.value
- Is feature state true
or false
.
TransformerConfigurationException
- if this TransformerFactory
or the Transformer
s or Template
s it creates cannot support this feature.
NullPointerException
- If the name
parameter is null.
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |