Developing Apama Applications > Developing Adapters > Java Codec Plug-in Development > The Java Codec Plug-in Development Specification > Working with normalised events > The NormalisedEventIterator class
The NormalisedEventIterator class
Several of the NormalisedEvent methods return an instance of the NormalisedEventIterator class, which provides a way to step though the name-value pairs making up the normalised event, forwards or backwards.
The following public methods are provided:
*valid - Check whether the iterator points to a valid element of the normalised event. Typically used as part of the loop condition when iterating over the contents of an event.
*key - Return the key (name) associated with the current event element pointed to by the iterator.
*value - Return the value associated with the current event element pointed to by the iterator.
*next - Move the iterator to the next element of the underlying normalised event instance. The iterator must be in a valid state (such that the valid function would return true) before this function is called. Note that the order in which elements is returned is not necessarily the same as the order in which they were added. The order may change as elements are added to or removed from the underlying event.
*back - Move the iterator to the previous element of the underlying normalised event instance. The iterator must be in a valid state (such that the valid function would return true) before this function is called. Note that the order in which elements is returned is not necessarily the same as the order in which they were added. The order may change as elements are added to or removed from the underlying event.
There is no public constructor; iterators are created and returned only by NormalisedEvent methods.
Please see the Javadoc documentationfor full information about the classes introduced in this section.
Copyright © 2013 Software AG, Darmstadt, Germany and/or Software AG USA Inc., Reston, VA, USA, and/or Terracotta Inc., San Francisco, CA, USA, and/or Software AG (Canada) Inc., Cambridge, Ontario, Canada, and/or, Software AG (UK) Ltd., Derby, United Kingdom, and/or Software A.G. (Israel) Ltd., Or-Yehuda, Israel and/or their licensors.