| An interface for iterating XML events. Even though this interface
only contains a single method for iterating XML events, higher level
constructs can be written on top of this interface to provide more
powerful iteration capability. However, the nextEvent
method can always be used by applications for complete access to the
event stream.
Typically, the application will use the iteration method(s) on the
XMLPullParser. But this interface can also be used to
construct any type of event iterator, even one not based on parsing
XML streams.
Note:
Currently, the XMLEventIterator interface only contains
the single, low-level nextToken method for iterating XML
events. The EventIterator utility class is provided to
handle this shortcoming. As this API progresses, it is believed that
additional methods will be added to the XMLEventIterator
interface. However, this will be decided by actual users of the API.
Please let me know if you have
any suggestions or comments.
author:
Andy Clark
version:
$Id$ |