Class AbstractMapIteratorDecorator<K,V>

java.lang.Object
org.apache.commons.collections4.iterators.AbstractMapIteratorDecorator<K,V>
Type Parameters:
K - the type of keys
V - the type of mapped values
All Implemented Interfaces:
Iterator<K>, MapIterator<K,V>

public class AbstractMapIteratorDecorator<K,V> extends Object implements MapIterator<K,V>
Provides basic behaviour for decorating a map iterator with extra functionality.

All methods are forwarded to the decorated map iterator.

Since:
3.0
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    private final MapIterator<K,V>
    The iterator being decorated
  • Constructor Summary

    Constructors
    Constructor
    Description
    Constructor that decorates the specified iterator.
  • Method Summary

    Modifier and Type
    Method
    Description
    Gets the current key, which is the key returned by the last call to next().
    protected MapIterator<K,V>
    Gets the iterator being decorated.
    Gets the current value, which is the value associated with the last key returned by next().
    boolean
    Checks to see if there are more entries still to be iterated.
    Gets the next key from the Map.
    void
    Removes the last returned key from the underlying Map (optional operation).
    setValue(V obj)
    Sets the value associated with the current key (optional operation).

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface java.util.Iterator

    forEachRemaining
  • Field Details

    • iterator

      private final MapIterator<K,V> iterator
      The iterator being decorated
  • Constructor Details

    • AbstractMapIteratorDecorator

      public AbstractMapIteratorDecorator(MapIterator<K,V> iterator)
      Constructor that decorates the specified iterator.
      Parameters:
      iterator - the iterator to decorate, must not be null
      Throws:
      NullPointerException - if the iterator is null
  • Method Details

    • getMapIterator

      protected MapIterator<K,V> getMapIterator()
      Gets the iterator being decorated.
      Returns:
      the decorated iterator
    • hasNext

      public boolean hasNext()
      Checks to see if there are more entries still to be iterated.
      Specified by:
      hasNext in interface Iterator<K>
      Specified by:
      hasNext in interface MapIterator<K,V>
      Returns:
      true if the iterator has more elements
    • next

      public K next()
      Gets the next key from the Map.
      Specified by:
      next in interface Iterator<K>
      Specified by:
      next in interface MapIterator<K,V>
      Returns:
      the next key in the iteration
    • remove

      public void remove()
      Removes the last returned key from the underlying Map (optional operation).

      This method can be called once per call to next().

      Specified by:
      remove in interface Iterator<K>
      Specified by:
      remove in interface MapIterator<K,V>
    • getKey

      public K getKey()
      Gets the current key, which is the key returned by the last call to next().
      Specified by:
      getKey in interface MapIterator<K,V>
      Returns:
      the current key
    • getValue

      public V getValue()
      Gets the current value, which is the value associated with the last key returned by next().
      Specified by:
      getValue in interface MapIterator<K,V>
      Returns:
      the current value
    • setValue

      public V setValue(V obj)
      Sets the value associated with the current key (optional operation).
      Specified by:
      setValue in interface MapIterator<K,V>
      Parameters:
      obj - the new value
      Returns:
      the previous value