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 来返回提供了（通过 getXMLReader）对 XMLReader 引用的 SAXSource。

字段摘要

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) 基于参数所指定的转换指令，获取能够将 SAX ContentHandler 事件处理为 Result 的 TransformerHandler 对象。
abstract TransformerHandler	newTransformerHandler(Templates templates) 基于 Templates 参数，获取能够将 SAX ContentHandler 事件处理为 Result 的 TransformerHandler 对象。
abstract XMLFilter	newXMLFilter(Source src) 创建使用给定 Source 作为转换指令的 XMLFilter。
abstract XMLFilter	newXMLFilter(Templates templates) 基于 Templates 参数，创建 XMLFilter。

从类 javax.xml.transform.TransformerFactory 继承的方法

getAssociatedStylesheet, getAttribute, getErrorListener, getFeature, getURIResolver, 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

基于参数所指定的转换指令，获取能够将 SAX ContentHandler 事件处理为 Result 的 TransformerHandler 对象。

参数：

src - 转换指令的 Source。

返回：

准备好转换 SAX 事件的 TransformerHandler。

抛出：

TransformerConfigurationException - 如果由于某种原因不能创建 TransformerHandler。

newTransformerHandler

public abstract TransformerHandler newTransformerHandler(Templates templates)
                                                  throws TransformerConfigurationException

基于 Templates 参数，获取能够将 SAX ContentHandler 事件处理为 Result 的 TransformerHandler 对象。

参数：

templates - 编译后的转换指令。

返回：

准备好转换 SAX 事件的 TransformerHandler。

抛出：

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 - 转换指令的 Source。

返回：

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

抛出：

TransformerConfigurationException - 如果由于某种原因不能创建 TemplatesHandler。

newXMLFilter

public abstract XMLFilter newXMLFilter(Templates templates)
                                throws TransformerConfigurationException

基于 Templates 参数，创建 XMLFilter。

参数：

templates - 编译后的转换指令。

返回：

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

抛出：

TransformerConfigurationException - 如果由于某种原因不能创建 TemplatesHandler。