Module java.xml
Package javax.xml.stream

Interface XMLEventReader

所有超级接口:
Iterator<Object>
所有已知实现类:
EventReaderDelegate
public interface XMLEventReader extends Iterator<Object>
这是用于解析XML事件的顶层接口。它提供了查看下一个事件并通过属性接口返回配置信息的能力。
自版本:
1.6
参见:

  • Method Details

    • nextEvent

      XMLEvent nextEvent() throws XMLStreamException
      获取下一个XMLEvent。初始事件为StartDocument。
      返回:
      下一个XMLEvent
      抛出:
      XMLStreamException - 如果底层XML出现错误。
      NoSuchElementException - 迭代没有更多元素。
      参见:

    • hasNext

      boolean hasNext()
      检查是否有更多事件。如果有更多事件则返回true，否则返回false。
      指定者:
      hasNext 在接口 Iterator<Object>
      返回:
      如果事件读取器有更多事件则返回true，否则返回false

    • peek

      XMLEvent peek() throws XMLStreamException
      检查下一个XMLEvent而不从流中读取它。如果流处于EOF或没有更多XMLEvents，则返回null。调用peek()将等于next()的下一个返回值。
      返回:
      下一个XMLEvent
      抛出:
      XMLStreamException - 如果发生错误
      参见:

    • 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 - 如果释放相关资源时出现错误