javax.xml.stream
介面 XMLEventReader

所有父級介面：

Iterator

所有已知實作類別：

EventReaderDelegate

public interface XMLEventReader
extends Iterator

此類別是用於解析 XML 事件的頂層介面。它提供查看下一個事件和返回屬性介面中的配置資訊的功能。

從以下版本開始：

1.6

另請參見：

XMLInputFactory, XMLEventWriter

方法摘要

void	close() 釋放所有與此 Reader 關聯的資源。
String	getElementText() 讀取純文本元素的內容。
Object	getProperty(String name) 從底層實作獲取功能/屬性值。
boolean	hasNext() 檢查是否有多個事件。
XMLEvent	nextEvent() 獲取下一個 XMLEvent。
XMLEvent	nextTag() 在到達 START_ELEMENT 或 END_ELEMENT 之前，跳過所有無意義的空格事件。
XMLEvent	peek() 檢查下一個 XMLEvent，但不從串流中讀取它。

從介面 java.util.Iterator 繼承的方法

next, remove

方法詳細資訊

nextEvent

XMLEvent nextEvent()
                   throws XMLStreamException

獲取下一個 XMLEvent。

拋出：

XMLStreamException - 如果底層 XML 存在錯誤。

NoSuchElementException - 迭代不再有元素。

另請參見：

XMLEvent

hasNext

boolean hasNext()

檢查是否有多個事件。如果有多個事件，則返回 true，否則返回 false。

指定者：

介面 Iterator 中的 hasNext

返回：

如果事件 reader 具有多個事件，則返回 true，否則返回 false。

peek

XMLEvent peek()
              throws XMLStreamException

檢查下一個 XMLEvent，但不從串流中讀取它。如果串流位於 EOF 處或者不再有 XMLEvent，則返回 null。調用 peek() 將相當於 next() 的下一個返回。

拋出：

XMLStreamException

另請參見：

XMLEvent

getElementText

String getElementText()
                      throws XMLStreamException

讀取純文本元素的內容。前置條件：當前事件是 START_ELEMENT。後置條件：當前事件是相應的 END_ELEMENT。

拋出：

XMLStreamException - 如果當前事件不是 START_ELEMENT 或者遇到了非文本元素

nextTag

XMLEvent nextTag()
                 throws XMLStreamException

在到達 START_ELEMENT 或 END_ELEMENT 之前，跳過所有無意義的空格事件。如果遇到空格符之外的其他內容，則拋出異常。在處理純元素內容時應使用此方法，因為如果缺少 DTD 或未解釋它，解析器將無法識別可忽略的空格。

拋出：

XMLStreamException - 如果遇到空格符之外的其他內容

getProperty

Object getProperty(String name)
                   throws IllegalArgumentException

從底層實作獲取功能/屬性值。

參數：

name - 屬性的名稱

返回：

屬性的值

拋出：

IllegalArgumentException - 如果屬性不受支持

close

void close()
           throws XMLStreamException

釋放所有與此 Reader 關聯的資源。此方法不會關閉底層輸入源。

拋出：

XMLStreamException - 如果釋放關聯資源時出現錯誤