模块 java.xml

软件包 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的工厂方法。 它提供两种类型的ContentHandler，一种用于创建变形金刚，另一种用于创建模板对象。

如果应用程序想要为转换期间使用的XMLReader设置ErrorHandler或EntityResolver，它应该使用URIResolver返回SAXSource，它提供（使用getXMLReader）对XMLReader的引用。

从以下版本开始：

1.4

字段汇总

字段

变量和类型	字段	描述
static String	FEATURE	如果将此值作为参数传递时， TransformerFactory.getFeature(java.lang.String)返回true，则可以将从 TransformerFactory.newInstance()返回的TransformerFactory安全地转换为SAXTransformerFactory。
static String	FEATURE_XMLFILTER	如果将此值作为参数传递时， TransformerFactory.getFeature(java.lang.String)返回true，则支持 newXMLFilter(Source src)和 newXMLFilter(Templates templates)方法。

构造方法摘要

构造方法

变量	构造器	描述
protected	SAXTransformerFactory()	默认构造函数是故意保护的。

方法摘要

变量和类型	方法	描述
abstract TemplatesHandler	newTemplatesHandler()	获取可以将SAX ContentHandler事件处理为Templates对象的TemplatesHandler对象。
abstract TransformerHandler	newTransformerHandler()	获取可以将SAX ContentHandler事件处理为Result的TransformerHandler对象。
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。

声明方法的类 javax.xml.transform.TransformerFactory

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

声明方法的类 java.lang.Object

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

字段详细信息

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)方法。

另请参见：

常数字段值

构造方法详细信息

SAXTransformerFactory

protected SAXTransformerFactory()

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

方法详细信息

newTransformerHandler

public abstract TransformerHandler newTransformerHandler(Source src)
                                                  throws TransformerConfigurationException

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

参数

src - 转换指令的来源。

结果

TransformerHandler准备转换SAX事件。

异常

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

newTransformerHandler

public abstract TransformerHandler newTransformerHandler(Templates templates)
                                                  throws TransformerConfigurationException

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

参数

templates - 已编译的转换指令。

结果

TransformerHandler准备转换SAX事件。

异常

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

newTransformerHandler

public abstract TransformerHandler newTransformerHandler()
                                                  throws TransformerConfigurationException

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

结果

对TransformerHandler的非null引用，可以用作SAX解析事件的ContentHandler。

异常

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

newTemplatesHandler

public abstract TemplatesHandler newTemplatesHandler()
                                              throws TransformerConfigurationException

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

结果

对TransformerHandler的非null引用，可以用作SAX解析事件的ContentHandler。

异常

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

newXMLFilter

public abstract XMLFilter newXMLFilter(Source src)
                                throws TransformerConfigurationException

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

参数

src - 转换指令的来源。

结果

XMLFilter对象，如果不支持此功能，则为null。

异常

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

newXMLFilter

public abstract XMLFilter newXMLFilter(Templates templates)
                                throws TransformerConfigurationException

基于Templates参数创建XMLFilter。

参数

templates - 已编译的转换指令。

结果

XMLFilter对象，如果不支持此功能，则为null。

异常

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