|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--net.sourceforge.esw.util.JoiningIterator
JoiningIterator
makes an Iterator
of
Iterators
appear as one Iterator
.
For purposes of a Facade or an Aggregate pattern, you may want a collection
of elements to appear as a single element. This JoiningIterator
instance allows you to aggregate a collection of Iterators
as a
single Iterator
.
The order of iteration through the collection of iterators is defined by the
type of iterator added to this JoiningIterator
. If the
referenced Iterator
is from a List
, then the
iteratation is ordered. If the referenced Iterator
is from a
Map
, then the order of iteration is undefined.
Iterator
Constructor Summary | |
JoiningIterator(java.util.Iterator listOfIterators)
Creates a new JoiningIterator instance. |
Method Summary | |
boolean |
hasNext()
Returns true if the iteration has more elements. |
java.lang.Object |
next()
Returns the next element in the interation. |
void |
remove()
Unsupported in JoiningIterator . |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public JoiningIterator(java.util.Iterator listOfIterators)
JoiningIterator
instance.listOfIterators
- the Iterator
of iterators to treat as
a single Interator
.Method Detail |
public boolean hasNext()
In this JoiningIterator
instance, checks to see if any
remaining Iterator
has any other elements.
hasNext
in interface java.util.Iterator
public java.lang.Object next()
In JoiningIterator
, returns the next available Object from
the iterator that has another element.
next
in interface java.util.Iterator
java.util.NoSuchElementException
- iteration has no more elements.public void remove()
JoiningIterator
.
Removes from the underlying collection the last element returned by the iterator (optional operation). This method can be called only once per call to next. The behavior of an iterator is unspecified if the underlying collection is modified while the iteration is in progress in any way other than by calling this method.
remove
in interface java.util.Iterator
java.lang.UnsupportedOperationException
- if the remove
operation is not supported by this Iterator.java.lang.IllegalStateException
- if the next method has not
yet been called, or the remove method has already
been called after the last call to the next
method.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |