Module 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，一种用于创建Transformers，另一种用于创建Templates对象。

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

从以下版本开始：

1.4

Field Summary

Fields

Modifier and Type	Field	描述
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)方法。

构造方法摘要

构造方法

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

方法摘要

Modifier and Type	方法	描述
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)	创建一个使用给定的源作为转换指令的XMLFilter。
abstract XMLFilter	newXMLFilter(Templates templates)	根据Templates参数创建一个XMLFilter。

Methods inherited from class java.lang.Object

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

Methods inherited from class javax.xml.transform.TransformerFactory

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

字段详细信息

FEATURE

public static final String FEATURE

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

另请参见：

Constant Field Values

FEATURE_XMLFILTER

public static final String FEATURE_XMLFILTER

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

另请参见：

Constant Field Values

构造方法详细信息

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的非空引用，可以用作SAX解析事件的ContentHandler。

异常

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

newTemplatesHandler

public abstract TemplatesHandler newTemplatesHandler()
                                              throws TransformerConfigurationException

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

结果

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

异常

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

newXMLFilter

public abstract XMLFilter newXMLFilter(Source src)
                                throws TransformerConfigurationException

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

参数

src - 转换指令的来源。

结果

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

异常

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

newXMLFilter

public abstract XMLFilter newXMLFilter(Templates templates)
                                throws TransformerConfigurationException

根据Templates参数创建一个XMLFilter。

参数

templates - 编译的转换指令。

结果

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

异常

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