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.
    Apache Commons Collections version 3.x is being deprecated from AEMaaCS. The upgraded version 4.4 of Commons Collections is already included as replacement. Customers are advised to upgrade to this version of the library. Please note: the package name was changed to org.apache.commons.collections4. Further note that there are AEM APIs currently exposing the old collections classes; these will be updated in upcoming releases.
    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