compact2, compact3

javax.xml.stream

Interface XMLEventReader

All Superinterfaces:

Iterator

所有已知实现类：

EventReaderDelegate

public interface XMLEventReader
extends Iterator

这是解析XML事件的顶级界面。 它提供了窥视下一个事件并通过属性界面返回配置信息的功能。

从以下版本开始：

1.6

Version:

1.0

另请参见：

XMLInputFactory ， XMLEventWriter

方法摘要

Modifier and Type	Method and Description
void	close() 释放与此Reader相关联的任何资源。
String	getElementText() 读取纯文本元素的内容。
Object	getProperty(String name) 从底层实现获取特征/属性的值
boolean	hasNext() 检查是否有更多的事件。
XMLEvent	nextEvent() 获取下一个XMLEvent
XMLEvent	nextTag() 跳过任何微不足道的空间事件，直到达到START_ELEMENT或END_ELEMENT。
XMLEvent	peek() 检查下一个XMLEvent，而不从流中读取它。

Methods inherited from interface java.util.Iterator

forEachRemaining, next, remove

方法详细信息

nextEvent

XMLEvent nextEvent()
            throws XMLStreamException

获取下一个XMLEvent

异常

XMLStreamException - 如果底层XML存在错误。

NoSuchElementException - 迭代没有更多的元素。

另请参见：

XMLEvent

hasNext

boolean hasNext()

检查是否有更多的事件。 如果有更多事件，则返回true，否则返回false。

Specified by:

hasNext在界面 Iterator

结果

如果事件读取器有更多事件，则为true，否则为false

peek

XMLEvent peek()
       throws XMLStreamException

检查下一个XMLEvent，而不从流中读取它。 如果流处于EOF或没有更多XMLEvents，则返回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 - 如果 XMLStreamException除空格字符以外的任何内容

getProperty

Object getProperty(String name)
            throws IllegalArgumentException

从底层实现获取特征/属性的值

参数

name - 财产的名称

结果

物业的价值

异常

IllegalArgumentException - 如果不支持该属性

close

void close()
    throws XMLStreamException

释放与此Reader相关联的任何资源。 此方法不会关闭底层输入源。

异常

XMLStreamException - 如果有错误释放相关资源