Module java.xml

软件包 javax.xml.stream

Interface XMLEventReader

All Superinterfaces:

Iterator<Object>

所有已知实现类：

EventReaderDelegate

public interface XMLEventReader
extends Iterator<Object>

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

从以下版本开始：

1.6

Version:

1.0

另请参见：

XMLInputFactory ， XMLEventWriter

方法摘要

Modifier and Type	方法	描述
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。 初始事件为StartDocument 。

结果

下一个XMLEvent

异常

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

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

另请参见：

XMLEvent

hasNext

boolean hasNext()

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

Specified by:

hasNext在接口 Iterator<Object>

结果

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

peek

XMLEvent peek()
       throws XMLStreamException

检查下一个XMLEvent，而不从流中读取它。 如果流处于EOF或没有更多XMLEvents，则返回null。 对peek（）的调用将等于next（）的下一个返回值。

结果

下一个XMLEvent

异常

XMLStreamException

另请参见：

XMLEvent

getElementText

String getElementText()
               throws XMLStreamException

读取纯文本元素的内容。 前提条件：当前事件为START_ELEMENT。 后置条件：当前事件是相应的END_ELEMENT。

结果

元素的文本

异常

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

nextTag

XMLEvent nextTag()
          throws XMLStreamException

跳过任何微不足道的空间事件，直到达到START_ELEMENT或END_ELEMENT。 如果遇到除空格字符之外的任何东西，将抛出异常。 当处理元素内容时，应该使用此方法，因为如果DTD丢失或不解释，解析器无法识别可忽略的空格。

结果

START_ELEMENT或END_ELEMENT

异常

XMLStreamException - 如果遇到除空格字符以外的任何内容

getProperty

Object getProperty(String name)
            throws IllegalArgumentException

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

参数

name - 物业的名称

结果

物业的价值

异常

IllegalArgumentException - 如果不支持该属性

close

void close()
    throws XMLStreamException

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

异常

XMLStreamException - if there are errors freeing associated resources