org.apache.commons.collections.iterators
Class EnumerationIterator

java.lang.Object
  |
  +--org.apache.commons.collections.iterators.EnumerationIterator

public class EnumerationIterator

extends Object

implements Iterator

Adapter to make Enumeration instances appear to be Iterator instances.

Since:

1.0

Author:

James Strachan, Daniel Rall

Constructor Summary

EnumerationIterator()
Constructs a new EnumerationIterator that will not function until setEnumeration(Enumeration) is called.

EnumerationIterator(Enumeration enumeration)
Constructs a new EnumerationIterator that provides an iterator view of the given enumeration.

EnumerationIterator(Enumeration enum, Collection collection)
Constructs a new EnumerationIterator that will remove elements from the specified collection.

Method Summary

Enumeration	getEnumeration() Returns the underlying enumeration.
boolean	hasNext() Returns true if the underlying enumeration has more elements.
Object	next() Returns the next object from the enumeration.
void	remove() Functions if an associated Collection is known.
void	setEnumeration(Enumeration enumeration) Sets the underlying enumeration.

Methods inherited from class java.lang.Object

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

Constructor Detail

EnumerationIterator

public EnumerationIterator()

Constructs a new EnumerationIterator that will not function until setEnumeration(Enumeration) is called.

EnumerationIterator

public EnumerationIterator(Enumeration enumeration)

Constructs a new EnumerationIterator that provides an iterator view of the given enumeration.

Parameters:

enumeration - the enumeration to use

EnumerationIterator

public EnumerationIterator(Enumeration enum,
                           Collection collection)

Constructs a new EnumerationIterator that will remove elements from the specified collection.

Parameters:

enum - the enumeration to use

collection - the collection to remove elements form

Method Detail

hasNext

public boolean hasNext()

Returns true if the underlying enumeration has more elements.

Specified by:

hasNext in interface Iterator

Returns:

true if the underlying enumeration has more elements

Throws:

NullPointerException - if the underlying enumeration is null

next

public Object next()

Returns the next object from the enumeration.

Specified by:

next in interface Iterator

Returns:

the next object from the enumeration

Throws:

NullPointerException - if the enumeration is null

remove

public void remove()

Functions if an associated Collection is known. If so, the first occurrence of the last returned object from this iterator will be removed from the collection.

Specified by:

remove in interface Iterator

Throws:

IllegalStateException - next() not called.

UnsupportedOperationException - No associated Collection.

getEnumeration

public Enumeration getEnumeration()

Returns the underlying enumeration.

Returns:

the underlying enumeration

setEnumeration

public void setEnumeration(Enumeration enumeration)

Sets the underlying enumeration.

Parameters:

enumeration - the new underlying enumeration