模块 java.xml

软件包 javax.xml.stream

Interface XMLEventReader

All Superinterfaces:

Iterator<Object>

所有已知实现类：

EventReaderDelegate

public interface XMLEventReader
extends Iterator<Object>

这是解析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

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 - 如果有错误释放相关资源