This class extends transformerFactory to define additional factory methods that are useful when working with documents that are represented as sequences of SAX events. Pass the FEATURE constant to the getFeature( ) method of your TRansformerFactory object to determine whether the newTemplatesHandler( ) and newtransformerHandler( ) methods are supported and whether it is safe to cast your transformerFactory object to a SAXTransformerFactory. Use the FEATURE_XMLFILTER constant with getFeature( ) to determine if the newXMLFilter( ) methods are also supported.

newTemplatesHandler( ) returns a TemplatesHandler object that you can use as an org.xml.sax.ContentHandler object to receive SAX events generated by a SAX parser and transform those events into a Templates object.

The newtransformerHandler( ) methods are similar: they return a transformerHandler object that can receive SAX events and representing a source document and transform them into a Result document. The no-argument version of newTRansformerHandler( ) creates a TRansformerHandler that simply modifies the form of the document without applying a stylesheet to its content. The other two versions of newtransformerHandler( ) use a stylesheet specified either as a Source or Templates object.

The newXMLFilter( ) methods, if supported, return an org.xml.sax.XMLFilter object that can acts as both a sink and a source of SAX events and filters those events by applying the transformation instructions specified by the Templates or Source objects.

Figure 20-13. javax.xml.transform.sax.SAXTransformerFactory

public abstract class SAXTransformerFactory extends javax.xml.transform.TransformerFactory {
// Protected Constructors
     protected SAXTransformerFactory( );  
// Public Constants
     public static final String FEATURE;    ="http://javax.xml.transform.sax.SAXTransformerFactory/feature" 
     public static final String FEATURE_XMLFILTER;
         ="http://javax.xml.transform.sax.SAXTransformerFactory/feature/xmlfilter" 
// Public Instance Methods
     public abstract TemplatesHandler newTemplatesHandler( ) 
        throws javax.xml.transform.TransformerConfigurationException;  
     public abstract TransformerHandler newTransformerHandler( ) 
        throws javax.xml.transform.TransformerConfigurationException;  
     public abstract TransformerHandler newTransformerHandler
        (javax.xml.transform.Source src) 
        throws javax.xml.transform.TransformerConfigurationException;  
     public abstract TransformerHandler newTransformerHandler
        (javax.xml.transform.Templates templates) 
        throws javax.xml.transform.TransformerConfigurationException;  
     public abstract org.xml.sax.XMLFilter newXMLFilter
        (javax.xml.transform.Source src) 
        throws javax.xml.transform.TransformerConfigurationException;  
     public abstract org.xml.sax.XMLFilter newXMLFilter
        (javax.xml.transform.Templates templates) 
        throws javax.xml.transform.TransformerConfigurationException;  
}