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 的工厂方法。它提供两种类型的 ContentHandler，一种用于创建 Transformer，另一种用于创建 Templates 对象。

如果应用程序希望设置转换期间所使用的 XMLReader 的 ErrorHandler 或 EntityResolver，那么它应使用 URIResolver 来返回提供了（通过 getXMLReader）对 XMLReader 引用的 SAXSource。

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。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。