Package org.apache.commons.collections.map

Class UnmodifiableMap

java.lang.Object

org.apache.commons.collections.map.AbstractMapDecorator

org.apache.commons.collections.map.UnmodifiableMap

All Implemented Interfaces:

Serializable, Map, IterableMap, Unmodifiable

@Deprecated(since="2021-04-30")
public final class UnmodifiableMap
extends AbstractMapDecorator
implements IterableMap, Unmodifiable, 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 Map 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

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Method Summary

Modifier and Type	Method	Description
void	clear()	Deprecated.
static Map	decorate(Map map)	Deprecated. Factory method to create an unmodifiable map.
Set	entrySet()	Deprecated.
Set	keySet()	Deprecated.
MapIterator	mapIterator()	Deprecated. Obtains a MapIterator over the map.
Object	put(Object key, Object value)	Deprecated.
void	putAll(Map mapToCopy)	Deprecated.
Object	remove(Object key)	Deprecated.
Collection	values()	Deprecated.

Methods inherited from class org.apache.commons.collections.map.AbstractMapDecorator

containsKey, containsValue, equals, get, hashCode, isEmpty, size, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, equals, forEach, get, getOrDefault, hashCode, isEmpty, merge, putIfAbsent, remove, replace, replace, replaceAll, size

Method Details

decorate

public static Map decorate(Map map)

Deprecated.

Factory method to create an unmodifiable map.

Parameters:

map - the map to decorate, must not be null

Throws:

IllegalArgumentException - if map is null

clear

public void clear()

Deprecated.

Specified by:

clear in interface Map

Overrides:

clear in class AbstractMapDecorator

put

public Object put(Object key,
 Object value)

Deprecated.

Specified by:

put in interface Map

Overrides:

put in class AbstractMapDecorator

putAll

public void putAll(Map mapToCopy)

Deprecated.

Specified by:

putAll in interface Map

Overrides:

putAll in class AbstractMapDecorator

remove

public Object remove(Object key)

Deprecated.

Specified by:

remove in interface Map

Overrides:

remove in class AbstractMapDecorator

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

Returns:

a map iterator

entrySet

public Set entrySet()

Deprecated.

Specified by:

entrySet in interface Map

Overrides:

entrySet in class AbstractMapDecorator

keySet

public Set keySet()

Deprecated.

Specified by:

keySet in interface Map

Overrides:

keySet in class AbstractMapDecorator

values

public Collection values()

Deprecated.

Specified by:

values in interface Map

Overrides:

values in class AbstractMapDecorator