File Doc Category Size Date Package
SAXTransformerFactory.java API Doc Java SE 5 API 5082 Fri Aug 26 14:58:24 BST 2005 javax.xml.transform.sax

SAXTransformerFactory

java.lang.Object
- javax.xml.transform.TransformerFactory

public abstract class SAXTransformerFactory extends TransformerFactory

This class extends TransformerFactory to provide SAX-specific factory methods. It provides two types of ContentHandlers, one for creating Transformers, the other for creating Templates objects.

If an application wants to set the ErrorHandler or EntityResolver for an XMLReader used during a transformation, it should use a URIResolver to return the SAXSource which provides (with getXMLReader) a reference to the XMLReader.

Fields Summary
public static final String
FEATURE
If {@link javax.xml.transform.TransformerFactory#getFeature} returns true when passed this value as an argument, the TransformerFactory returned from {@link javax.xml.transform.TransformerFactory#newInstance} may be safely cast to a SAXTransformerFactory.
public static final String
FEATURE_XMLFILTER
If {@link javax.xml.transform.TransformerFactory#getFeature} returns true when passed this value as an argument, the {@link #newXMLFilter(Source src)} and {@link #newXMLFilter(Templates templates)} methods are supported.
Constructors Summary
protected SAXTransformerFactory()
The default constructor is protected on purpose.
Methods Summary
public abstract javax.xml.transform.sax.TemplatesHandler newTemplatesHandler()
Get a TemplatesHandler object that can process SAX ContentHandler events into a Templates object.
return
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.
public abstract javax.xml.transform.sax.TransformerHandler newTransformerHandler(javax.xml.transform.Source src)
Get a TransformerHandler object that can process SAX ContentHandler events into a Result, based on the transformation instructions specified by the argument.
param
src The Source of the transformation instructions.
return
TransformerHandler ready to transform SAX events.
throws
TransformerConfigurationException If for some reason the TransformerHandler can not be created.
public abstract javax.xml.transform.sax.TransformerHandler newTransformerHandler(javax.xml.transform.Templates templates)
Get a TransformerHandler object that can process SAX ContentHandler events into a Result, based on the Templates argument.
param
templates The compiled transformation instructions.
return
TransformerHandler ready to transform SAX events.
throws
TransformerConfigurationException If for some reason the TransformerHandler can not be created.
public abstract javax.xml.transform.sax.TransformerHandler newTransformerHandler()
Get a TransformerHandler object that can process SAX ContentHandler events into a Result. The transformation is defined as an identity (or copy) transformation, for example to copy a series of SAX parse events into a DOM tree.
return
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.
public abstract org.xml.sax.XMLFilter newXMLFilter(javax.xml.transform.Source src)
Create an XMLFilter that uses the given Source as the transformation instructions.
param
src The Source of the transformation instructions.
return
An XMLFilter object, or null if this feature is not supported.
throws
TransformerConfigurationException If for some reason the TemplatesHandler cannot be created.
public abstract org.xml.sax.XMLFilter newXMLFilter(javax.xml.transform.Templates templates)
Create an XMLFilter, based on the Templates argument..
param
templates The compiled transformation instructions.
return
An XMLFilter object, or null if this feature is not supported.
throws
TransformerConfigurationException If for some reason the TemplatesHandler cannot be created.