Module java.xml

Package javax.xml.stream.util

Class EventReaderDelegate

java.lang.Object

javax.xml.stream.util.EventReaderDelegate

所有已实现的接口:

Iterator<Object>, XMLEventReader

       public class EventReaderDelegate extends Object implements XMLEventReader
      

这是用于派生XMLEventReader过滤器的基类。此类设计为位于XMLEventReader和应用程序的XMLEventReader之间。默认情况下，每个方法什么也不做，只是调用父接口上的相应方法。

自:

1.6

参见:

• XMLEventReader
• StreamReaderDelegate

Constructor Summary

Constructors

Constructor	Description
EventReaderDelegate()	构造一个没有父级的空过滤器。
EventReaderDelegate(XMLEventReader reader)	构造一个具有指定父级的过滤器。

Method Summary

Modifier and Type	Method	Description
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	setParent(XMLEventReader reader)	设置此实例的父级。

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods declared in interface java.util.Iterator

forEachRemaining, remove

Constructor Details

EventReaderDelegate

             public EventReaderDelegate()
            

构造一个没有父级的空过滤器。

EventReaderDelegate

             public EventReaderDelegate(XMLEventReader reader)
            

构造一个具有指定父级的过滤器。

参数:

reader - 父级

Method Details

setParent

             public void setParent(XMLEventReader reader)
            

设置此实例的父级。

参数:

reader - 新父级

getParent

             public XMLEventReader getParent()
            

获取此实例的父级。

返回:

父级，如果未设置则为null

nextEvent

             public XMLEvent nextEvent() throws XMLStreamException
            

从接口复制的描述: XMLEventReader

获取下一个XMLEvent。初始事件为StartDocument。

指定者:

nextEvent 在接口 XMLEventReader

返回:

下一个XMLEvent

抛出:

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

参见:

• XMLEvent

next

             public Object next()
            

从接口复制的描述: Iterator

返回迭代中的下一个元素。

指定者:

next 在接口 Iterator<Object>

返回:

迭代中的下一个元素

hasNext

             public boolean hasNext()
            

从接口复制的描述: XMLEventReader

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

指定者:

hasNext 在接口 Iterator<Object>

指定者:

hasNext 在接口 XMLEventReader

返回:

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

peek

             public XMLEvent peek() throws XMLStreamException
            

从接口复制的描述: XMLEventReader

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

指定者:

peek 在接口 XMLEventReader

返回:

下一个XMLEvent

抛出:

XMLStreamException - 如果发生错误

参见:

• XMLEvent

close

             public void close() throws XMLStreamException
            

从接口复制的描述: XMLEventReader

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

指定者:

close 在接口 XMLEventReader

抛出:

XMLStreamException - 如果释放相关资源时出现错误

getElementText

             public String getElementText() throws XMLStreamException
            

从接口复制的描述: XMLEventReader

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

指定者:

getElementText 在接口 XMLEventReader

返回:

元素的文本

抛出:

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

nextTag

             public XMLEvent nextTag() throws XMLStreamException
            

从接口复制的描述: XMLEventReader

跳过任何不显著的空格事件，直到达到START_ELEMENT或END_ELEMENT。如果遇到除空格字符之外的任何内容，将抛出异常。当处理仅包含元素内容时应使用此方法，因为解析器无法识别可忽略的空格（如果缺少或未解释DTD）。

指定者:

nextTag 在接口 XMLEventReader

返回:

START_ELEMENT或END_ELEMENT

抛出:

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

getProperty

             public Object getProperty(String name) throws IllegalArgumentException
            

从接口复制的描述: XMLEventReader

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

指定者:

getProperty 在接口 XMLEventReader

参数:

name - 属性的名称

返回:

属性的值

抛出:

IllegalArgumentException - 如果不支持该属性