Class EntrySetMapIterator
- java.lang.Object
-
- org.apache.commons.collections.iterators.EntrySetMapIterator
-
- All Implemented Interfaces:
Iterator
,MapIterator
,ResettableIterator
public class EntrySetMapIterator extends Object implements MapIterator, ResettableIterator
Implements aMapIterator
using a Map entrySet. Reverse iteration is not supported.MapIterator it = map.mapIterator(); while (it.hasNext()) { Object key = it.next(); Object value = it.getValue(); it.setValue(newValue); }
- Since:
- Commons Collections 3.0
- Version:
- $Revision: 646777 $ $Date: 2008-04-10 14:33:15 +0200 (Thu, 10 Apr 2008) $
- Author:
- Stephen Colebourne
-
-
Constructor Summary
Constructors Constructor Description EntrySetMapIterator(Map map)
Constructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Object
getKey()
Gets the current key, which is the key returned by the last call tonext()
.Object
getValue()
Gets the current value, which is the value associated with the last key returned bynext()
.boolean
hasNext()
Checks to see if there are more entries still to be iterated.Object
next()
Gets the next key from theMap
.void
remove()
Removes the last returned key from the underlyingMap
.void
reset()
Resets the state of the iterator.Object
setValue(Object value)
Sets the value associated with the current key.String
toString()
Gets the iterator as a String.-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface java.util.Iterator
forEachRemaining
-
-
-
-
Constructor Detail
-
EntrySetMapIterator
public EntrySetMapIterator(Map map)
Constructor.- Parameters:
map
- the map to iterate over
-
-
Method Detail
-
hasNext
public boolean hasNext()
Checks to see if there are more entries still to be iterated.- Specified by:
hasNext
in interfaceIterator
- Specified by:
hasNext
in interfaceMapIterator
- Returns:
true
if the iterator has more elements
-
next
public Object next()
Gets the next key from theMap
.- Specified by:
next
in interfaceIterator
- Specified by:
next
in interfaceMapIterator
- Returns:
- the next key in the iteration
- Throws:
NoSuchElementException
- if the iteration is finished
-
remove
public void remove()
Removes the last returned key from the underlyingMap
.This method can be called once per call to
next()
.- Specified by:
remove
in interfaceIterator
- Specified by:
remove
in interfaceMapIterator
- Throws:
UnsupportedOperationException
- if remove is not supported by the mapIllegalStateException
- ifnext()
has not yet been calledIllegalStateException
- ifremove()
has already been called since the last call tonext()
-
getKey
public Object getKey()
Gets the current key, which is the key returned by the last call tonext()
.- Specified by:
getKey
in interfaceMapIterator
- Returns:
- the current key
- Throws:
IllegalStateException
- ifnext()
has not yet been called
-
getValue
public Object getValue()
Gets the current value, which is the value associated with the last key returned bynext()
.- Specified by:
getValue
in interfaceMapIterator
- Returns:
- the current value
- Throws:
IllegalStateException
- ifnext()
has not yet been called
-
setValue
public Object setValue(Object value)
Sets the value associated with the current key.- Specified by:
setValue
in interfaceMapIterator
- Parameters:
value
- the new value- Returns:
- the previous value
- Throws:
UnsupportedOperationException
- if setValue is not supported by the mapIllegalStateException
- ifnext()
has not yet been calledIllegalStateException
- ifremove()
has been called since the last call tonext()
-
reset
public void reset()
Resets the state of the iterator.- Specified by:
reset
in interfaceResettableIterator
-
-