JavaTM Platform
Standard Ed. 6

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。


字段摘要
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, 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。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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