模块 java.xml

包 javax.xml.transform.sax

类 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 提供（通过 getXMLReader）对 XMLReader 的引用。

自从：

1.4

字段摘要

字段

修饰符和类型	Field	描述
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) 方法。

构造方法总结

构造方法

修饰符	构造方法	描述
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 事件处理成一个结果。
abstract XMLFilter	newXMLFilter(Source src)	创建一个 XMLFilter，它使用给定的 Source 作为转换指令。
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 事件处理成一个结果。

参数：

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，它使用给定的 Source 作为转换指令。

参数：

src - 转换指令的来源。

返回：

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

抛出：

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

newXMLFilter

public abstract XMLFilter  newXMLFilter(Templates  templates) throws TransformerConfigurationException 
            

基于 Templates 参数创建一个 XMLFilter..

参数：

templates - 已编译的转换指令。

返回：

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

抛出：

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