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