javax.xml.stream

Interface XMLEventReader

public interface XMLEventReader extends Iterator

An XML parser.

Method Summary
void	close() Free any resources associated with this parser.
String	getElementText() Reads the text context of an element.
Object	getProperty(String name) Returns the implementation-specific feature or property of the given name.
boolean	hasNext() Indicates whether there are more XML events to be read.
XMLEvent	nextEvent() Returns the next XML event.
XMLEvent	nextTag() Returns the next element event.
XMLEvent	peek() Looks at the next XML event without advancing the cursor in the stream.

Method Detail

public void close()

Free any resources associated with this parser. This method will not close the underlying input source.

public String getElementText()

Reads the text context of an element. When invoked, the current event must be START_ELEMENT. On completion, the current event will be END_ELEMENT.

public Object getProperty(String name)

Returns the implementation-specific feature or property of the given name.

Throws: IllegalArgumentException if the property is not supported

public boolean hasNext()

Indicates whether there are more XML events to be read.

public XMLEvent nextEvent()

Returns the next XML event.

public XMLEvent nextTag()

Returns the next element event. This method skips insignificant space until a START_ELEMENT or END_ELEMENT event is found.

Throws: XMLStreamException if an event that was not an insignificant space event was encountered

public XMLEvent peek()

Looks at the next XML event without advancing the cursor in the stream. Returns null if there are no more events to read.