Package org.apache.commons.collections.iterators

Class UnmodifiableMapIterator

  • All Implemented Interfaces:
    Iterator, MapIterator, Unmodifiable
    public final class UnmodifiableMapIterator
extends Object
implements MapIterator, Unmodifiable
    Decorates a map iterator such that it cannot be modified.
    Since:
    Commons Collections 3.0
    Version:
    $Revision: 646777 $ $Date: 2008-04-10 14:33:15 +0200 (Thu, 10 Apr 2008) $
    Author:
    Stephen Colebourne

    • Method Detail

      • decorate

        public static MapIterator decorate​(MapIterator iterator)
        Decorates the specified iterator such that it cannot be modified.
        Parameters:
        iterator - the iterator to decorate
        Throws:
        IllegalArgumentException - if the iterator is null

      • hasNext

        public boolean hasNext()
        Description copied from interface: MapIterator
        Checks to see if there are more entries still to be iterated.
        Specified by:
        hasNext in interface Iterator
        Specified by:
        hasNext in interface MapIterator
        Returns:
        true if the iterator has more elements

      • next

        public Object next()
        Description copied from interface: MapIterator
        Gets the next key from the Map.
        Specified by:
        next in interface Iterator
        Specified by:
        next in interface MapIterator
        Returns:
        the next key in the iteration

      • getKey

        public Object getKey()
        Description copied from interface: MapIterator
        Gets the current key, which is the key returned by the last call to next().
        Specified by:
        getKey in interface MapIterator
        Returns:
        the current key

      • getValue

        public Object getValue()
        Description copied from interface: MapIterator
        Gets the current value, which is the value associated with the last key returned by next().
        Specified by:
        getValue in interface MapIterator
        Returns:
        the current value

      • setValue

        public Object setValue​(Object value)
        Description copied from interface: MapIterator
        Sets the value associated with the current key (optional operation).
        Specified by:
        setValue in interface MapIterator
        Parameters:
        value - the new value
        Returns:
        the previous value

      • remove

        public void remove()
        Description copied from interface: MapIterator
        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
        Specified by:
        remove in interface MapIterator