Module java.xml

Package javax.xml.transform.sax

Class SAXTransformerFactory

java.lang.Object

javax.xml.transform.TransformerFactory

javax.xml.transform.sax.SAXTransformerFactory

       public abstract class SAXTransformerFactory extends TransformerFactory
      

该类扩展了TransformerFactory，提供了针对SAX的特定工厂方法。它提供了两种类型的ContentHandlers，一种用于创建Transformers，另一种用于创建Templates对象。

如果应用程序想要为转换过程中使用的XMLReader设置ErrorHandler或EntityResolver，应该使用URIResolver返回SAXSource，该SAXSource提供了一个XMLReader的引用（通过getXMLReader）。

自版本:

1.4

Field Summary

Fields

Modifier and Type	Field	Description
static final String	FEATURE	如果TransformerFactory.getFeature(java.lang.String)在传递此值作为参数时返回true，则从TransformerFactory.newInstance()返回的TransformerFactory可以安全地转换为SAXTransformerFactory。
static final String	FEATURE_XMLFILTER	如果TransformerFactory.getFeature(java.lang.String)在传递此值作为参数时返回true，则支持newXMLFilter(Source src)和newXMLFilter(Templates templates)方法。

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	SAXTransformerFactory()	默认构造函数是有意保护的。

Method Summary

Modifier and Type	Method	Description
abstract TemplatesHandler	newTemplatesHandler()	获取一个TemplatesHandler对象，可以将SAX ContentHandler事件处理为Templates对象。
abstract TransformerHandler	newTransformerHandler()	获取一个TransformerHandler对象，可以将SAX ContentHandler事件处理为一个Result。
abstract TransformerHandler	newTransformerHandler(Source src)	获取一个TransformerHandler对象，可以根据参数指定的转换指令将SAX ContentHandler事件处理为一个Result。
abstract TransformerHandler	newTransformerHandler(Templates templates)	获取一个TransformerHandler对象，可以根据Templates参数将SAX ContentHandler事件处理为一个Result。
abstract XMLFilter	newXMLFilter(Source src)	创建一个使用给定Source作为转换指令的XMLFilter。
abstract XMLFilter	newXMLFilter(Templates templates)	基于Templates参数创建一个XMLFilter。

Methods declared in class javax.xml.transform.TransformerFactory

getAssociatedStylesheet, getAttribute, getErrorListener, getFeature, getURIResolver, newDefaultInstance, newInstance, newInstance, newTemplates, newTransformer, newTransformer, setAttribute, setErrorListener, setFeature, setURIResolver

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

FEATURE

             public static final String FEATURE
            

如果TransformerFactory.getFeature(java.lang.String)在传递此值作为参数时返回true，则从TransformerFactory.newInstance()返回的TransformerFactory可以安全地转换为SAXTransformerFactory。

参见:

• 常量字段值

FEATURE_XMLFILTER

             public static final String FEATURE_XMLFILTER
            

如果TransformerFactory.getFeature(java.lang.String)在传递此值作为参数时返回true，则支持newXMLFilter(Source src)和newXMLFilter(Templates templates)方法。

参见:

• 常量字段值

Constructor Details

SAXTransformerFactory

             protected SAXTransformerFactory()
            

默认构造函数是有意保护的。

Method Details

newTransformerHandler

             public abstract TransformerHandler newTransformerHandler(Source src) throws TransformerConfigurationException
            

获取一个TransformerHandler对象，可以根据参数指定的转换指令将SAX ContentHandler事件处理为一个Result。

参数:

src - 转换指令的Source。

返回:

准备好转换SAX事件的TransformerHandler。

抛出:

TransformerConfigurationException - 如果由于某种原因无法创建TransformerHandler。

newTransformerHandler

             public abstract TransformerHandler newTransformerHandler(Templates templates) throws TransformerConfigurationException
            

获取一个TransformerHandler对象，可以根据Templates参数将SAX ContentHandler事件处理为一个Result。

参数:

templates - 编译后的转换指令。

返回:

准备好转换SAX事件的TransformerHandler。

抛出:

TransformerConfigurationException - 如果由于某种原因无法创建TransformerHandler。

newTransformerHandler

             public abstract TransformerHandler newTransformerHandler() throws TransformerConfigurationException
            

获取一个TransformerHandler对象，可以将SAX ContentHandler事件处理为一个Result。该转换被定义为一个恒等（或复制）转换，例如将一系列SAX解析事件复制到DOM树中。

返回:

一个非空的TransformerHandler引用，可用作SAX解析事件的ContentHandler。

抛出:

TransformerConfigurationException - 如果由于某种原因无法创建TransformerHandler。

newTemplatesHandler

             public abstract TemplatesHandler newTemplatesHandler() throws TransformerConfigurationException
            

获取一个TemplatesHandler对象，可以将SAX ContentHandler事件处理为Templates对象。

返回:

一个非空的TransformerHandler引用，可用作SAX解析事件的ContentHandler。

抛出:

TransformerConfigurationException - 如果由于某种原因无法创建TemplatesHandler。

newXMLFilter

             public abstract XMLFilter newXMLFilter(Source src) throws TransformerConfigurationException
            

创建一个使用给定Source作为转换指令的XMLFilter。

参数:

src - 转换指令的Source。

返回:

一个XMLFilter对象，如果不支持此功能则返回null。

抛出:

TransformerConfigurationException - 如果由于某种原因无法创建TemplatesHandler。

newXMLFilter

             public abstract XMLFilter newXMLFilter(Templates templates) throws TransformerConfigurationException
            

基于Templates参数创建一个XMLFilter。

参数:

templates - 编译后的转换指令。

返回:

一个XMLFilter对象，如果不支持此功能则返回null。

抛出:

TransformerConfigurationException - 如果由于某种原因无法创建TemplatesHandler。