Package org.apache.commons.collections.map

Class UnmodifiableOrderedMap

  • All Implemented Interfaces:
    java.io.Serializable, java.util.Map, IterableMap, OrderedMap, Unmodifiable
    @Deprecated(since="2021-04-30")
public final class UnmodifiableOrderedMap
extends AbstractOrderedMapDecorator
implements Unmodifiable, java.io.Serializable
    Deprecated.
    Commons Collections 3 is in maintenance mode. Commons Collections 4 should be used instead.
    Decorates another OrderedMap to ensure it can't be altered.

    This class is Serializable from Commons Collections 3.1.

    Since:
    Commons Collections 3.0
    See Also:
    Serialized Form

    • Method Detail

      • decorate

        public static OrderedMap decorate​(OrderedMap map)
        Deprecated.
        Factory method to create an unmodifiable sorted map.
        Parameters:
        map - the map to decorate, must not be null
        Throws:
        java.lang.IllegalArgumentException - if map is null

      • mapIterator

        public MapIterator mapIterator()
        Deprecated.
        Description copied from interface: IterableMap
        Obtains a MapIterator over the map.

        A map iterator is an efficient way of iterating over maps. There is no need to access the entry set or cast to Map Entry objects. 

         IterableMap map = new HashedMap();
 MapIterator it = map.mapIterator();
 while (it.hasNext()) {
   Object key = it.next();
   Object value = it.getValue();
   it.setValue("newValue");
 }
        Specified by:
        mapIterator in interface IterableMap
        Overrides:
        mapIterator in class AbstractOrderedMapDecorator
        Returns:
        a map iterator

      • orderedMapIterator

        public OrderedMapIterator orderedMapIterator()
        Deprecated.
        Description copied from interface: OrderedMap
        Obtains an OrderedMapIterator over the map.

        A ordered map iterator is an efficient way of iterating over maps in both directions. 

         BidiMap map = new TreeBidiMap();
 MapIterator it = map.mapIterator();
 while (it.hasNext()) {
   Object key = it.next();
   Object value = it.getValue();
   it.setValue("newValue");
   Object previousKey = it.previous();
 }
        Specified by:
        orderedMapIterator in interface OrderedMap
        Overrides:
        orderedMapIterator in class AbstractOrderedMapDecorator
        Returns:
        a map iterator

      • clear

        public void clear()
        Deprecated.
        Specified by:
        clear in interface java.util.Map
        Overrides:
        clear in class AbstractMapDecorator

      • put

        public java.lang.Object put​(java.lang.Object key,
                            java.lang.Object value)
        Deprecated.
        Specified by:
        put in interface java.util.Map
        Overrides:
        put in class AbstractMapDecorator

      • putAll

        public void putAll​(java.util.Map mapToCopy)
        Deprecated.
        Specified by:
        putAll in interface java.util.Map
        Overrides:
        putAll in class AbstractMapDecorator

      • remove

        public java.lang.Object remove​(java.lang.Object key)
        Deprecated.
        Specified by:
        remove in interface java.util.Map
        Overrides:
        remove in class AbstractMapDecorator

      • entrySet

        public java.util.Set entrySet()
        Deprecated.
        Specified by:
        entrySet in interface java.util.Map
        Overrides:
        entrySet in class AbstractMapDecorator

      • keySet

        public java.util.Set keySet()
        Deprecated.
        Specified by:
        keySet in interface java.util.Map
        Overrides:
        keySet in class AbstractMapDecorator

      • values

        public java.util.Collection values()
        Deprecated.
        Specified by:
        values in interface java.util.Map
        Overrides:
        values in class AbstractMapDecorator