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。