javax.xml.transform.stax
類別 StAXSource

java.lang.Object
  javax.xml.transform.stax.StAXSource

所有已實作的介面：

Source

public class StAXSource
extends Object
implements Source

以 StAX reader 的形式（即 XMLStreamReader 或 XMLEventReader）充當 XML Source 的持有者。各種接受 Source 的情況下都可以使用 StAXSource，例如，將 Source 作為輸入接受的 Transformer 和 Validator。

在處理期間使用 StAXSource 並且不能重複使用。

從以下版本開始：

1.6

另請參見：

JSR 173:Streaming API for XML, XMLStreamReader, XMLEventReader

欄位摘要

static String

FEATURE 當將此值作為參數傳遞時，如果 TransformerFactory.getFeature(String name) 返回 true，則 Transformer 支持此型別的 Source 輸入。

建構子摘要

StAXSource(XMLEventReader xmlEventReader)
通過提供 XMLEventReader 創建 StAXSource 的一個新實例。

StAXSource(XMLStreamReader xmlStreamReader)
通過 XMLStreamReader 創建 StAXSource 的一個新實例。

方法摘要

String	getSystemId() 獲取此 StAXSource 使用的系統標識符。
XMLEventReader	getXMLEventReader() 獲取此 StAXSource 使用的 XMLEventReader。
XMLStreamReader	getXMLStreamReader() 獲取此 StAXSource 使用的 XMLStreamReader。
void	setSystemId(String systemId) 在 StAXSource 的上下文中，它不適合顯示設置系統標識符。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

欄位詳細資訊

FEATURE

public static final String FEATURE

當將此值作為參數傳遞時，如果 TransformerFactory.getFeature(String name) 返回 true，則 Transformer 支持此型別的 Source 輸入。

另請參見：

常數欄位值

建構子詳細資訊

StAXSource

public StAXSource(XMLEventReader xmlEventReader)
           throws XMLStreamException

通過提供 XMLEventReader 創建 StAXSource 的一個新實例。

XMLEventReader 必須為非 null 參考。

XMLEventReader 必須處於 XMLStreamConstants.START_DOCUMENT 或 XMLStreamConstants.START_ELEMENT 狀態。

參數：

xmlEventReader - 用於創建此 StAXSource 的 XMLEventReader。

拋出：

XMLStreamException - 如果 xmlEventReader 存取拋出 Exception。

IllegalArgumentException - 如果 xmlEventReader == null。

IllegalStateException - 如果 xmlEventReader 不處於 XMLStreamConstants.START_DOCUMENT 或 XMLStreamConstants.START_ELEMENT 狀態。

StAXSource

public StAXSource(XMLStreamReader xmlStreamReader)

通過 XMLStreamReader 創建 StAXSource 的一個新實例。

XMLStreamReader 必須為非 null 參考。

XMLStreamReader 必須處於 XMLStreamConstants.START_DOCUMENT 或 XMLStreamConstants.START_ELEMENT 狀態。

參數：

xmlStreamReader - 用於創建此 StAXSource 的 XMLStreamReader。

拋出：

IllegalArgumentException - 如果 xmlStreamReader == null。

IllegalStateException - 如果 xmlStreamReader 不處於 XMLStreamConstants.START_DOCUMENT 或 XMLStreamConstants.START_ELEMENT 狀態。

方法詳細資訊

getXMLEventReader

public XMLEventReader getXMLEventReader()

獲取此 StAXSource 使用的 XMLEventReader。

如果此 StAXSource 是使用 XMLStreamReader 創建的，那麼 XMLEventReader 將為 null。

返回：

此 StAXSource 使用的 XMLEventReader。

getXMLStreamReader

public XMLStreamReader getXMLStreamReader()

獲取此 StAXSource 使用的 XMLStreamReader。

如果此 StAXSource 是使用 XMLEventReader 創建的，那麼 XMLStreamReader 將為 null。

返回：

此 StAXSource 使用的 XMLStreamReader。

setSystemId

public void setSystemId(String systemId)

在 StAXSource 的上下文中，它不適合顯示設置系統標識符。用於建構此 StAXSource 的 XMLStreamReader 或 XMLEventReader 確定 XML 源的系統標識符。

此方法始終拋出 UnsupportedOperationException。

指定者：

介面 Source 中的 setSystemId

參數：

systemId - 忽略。

拋出：

UnsupportedOperationException - 此方法始終拋出該異常。

getSystemId

public String getSystemId()

獲取此 StAXSource 使用的系統標識符。

查詢用於建構此 StAXSource 的 XMLStreamReader 或 XMLEventReader 以確定 XML 源的系統標識符。

系統標識符可以為 null 或空 "" String。

指定者：

介面 Source 中的 getSystemId

返回：

此 StAXSource 使用的系統標識符。