javax.xml.stream.util
類別 EventReaderDelegate

java.lang.Object
  javax.xml.stream.util.EventReaderDelegate

所有已實作的介面：

Iterator, XMLEventReader

public class EventReaderDelegate
extends Object
implements XMLEventReader

該類別是用於派生 XMLEventReader 過濾器的基礎類別。 此類別設計用於 XMLEventReader 和應用程序的 XMLEventReader 之間。預設情況下，每種方法除了調用父介面中的相應方法之外，不執行任何操作。

從以下版本開始：

1.6

另請參見：

XMLEventReader, StreamReaderDelegate

建構子摘要

EventReaderDelegate()
建構沒有父過濾器的空過濾器。

EventReaderDelegate(XMLEventReader reader)
用指定的父過濾器來建構一個過濾器。

方法摘要

void	close() 釋放所有與此 Reader 關聯的資源。
String	getElementText() 讀取純文本元素的內容。
XMLEventReader	getParent() 獲取此實例的父實例。
Object	getProperty(String name) 從底層實作獲取功能/屬性值。
boolean	hasNext() 檢查是否有多個事件。
Object	next() 返回迭代的下一個元素。
XMLEvent	nextEvent() 獲取下一個 XMLEvent。
XMLEvent	nextTag() 在到達 START_ELEMENT 或 END_ELEMENT 之前，跳過所有無意義的空格事件。
XMLEvent	peek() 檢查下一個 XMLEvent，但不從串流中讀取它。
void	remove() 從迭代器指向的 collection 中移除迭代器返回的最後一個元素（可選操作）。
void	setParent(XMLEventReader reader) 設置此實例的父實例。

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

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

建構子詳細資訊

EventReaderDelegate

public EventReaderDelegate()

建構沒有父過濾器的空過濾器。

EventReaderDelegate

public EventReaderDelegate(XMLEventReader reader)

用指定的父過濾器來建構一個過濾器。

參數：

reader - 父過濾器

方法詳細資訊

setParent

public void setParent(XMLEventReader reader)

設置此實例的父實例。

參數：

reader - 新的父實例

getParent

public XMLEventReader getParent()

獲取此實例的父實例。

返回：

父實例；如果沒有設置父實例，則返回 null

nextEvent

public XMLEvent nextEvent()
                   throws XMLStreamException

從介面 XMLEventReader 複製的描述

獲取下一個 XMLEvent。

指定者：

介面 XMLEventReader 中的 nextEvent

拋出：

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

另請參見：

XMLEvent

next

public Object next()

從介面 Iterator 複製的描述

返回迭代的下一個元素。

指定者：

介面 Iterator 中的 next

返回：

迭代的下一個元素。

hasNext

public boolean hasNext()

從介面 XMLEventReader 複製的描述

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

指定者：

介面 Iterator 中的 hasNext

指定者：

介面 XMLEventReader 中的 hasNext

返回：

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

peek

public XMLEvent peek()
              throws XMLStreamException

從介面 XMLEventReader 複製的描述

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

指定者：

介面 XMLEventReader 中的 peek

拋出：

XMLStreamException

另請參見：

XMLEvent

close

public void close()
           throws XMLStreamException

從介面 XMLEventReader 複製的描述

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

指定者：

介面 XMLEventReader 中的 close

拋出：

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

getElementText

public String getElementText()
                      throws XMLStreamException

從介面 XMLEventReader 複製的描述

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

指定者：

介面 XMLEventReader 中的 getElementText

拋出：

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

nextTag

public XMLEvent nextTag()
                 throws XMLStreamException

從介面 XMLEventReader 複製的描述

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

指定者：

介面 XMLEventReader 中的 nextTag

拋出：

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

getProperty

public Object getProperty(String name)
                   throws IllegalArgumentException

從介面 XMLEventReader 複製的描述

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

指定者：

介面 XMLEventReader 中的 getProperty

參數：

name - 屬性的名稱

返回：

屬性的值

拋出：

IllegalArgumentException - 如果屬性不受支持

remove

public void remove()

從介面 Iterator 複製的描述

從迭代器指向的 collection 中移除迭代器返回的最後一個元素（可選操作）。每次調用 next 只能調用一次此方法。如果進行迭代時用調用此方法之外的其他方式修改了該迭代器所指向的 collection，則迭代器的行為是不確定的。

指定者：

介面 Iterator 中的 remove