public class

FixedSizeMap

extends AbstractMapDecorator
implements Serializable Map<K, V> BoundedMap
java.lang.Object
   ↳ org.apache.commons.collections.map.AbstractMapDecorator
     ↳ org.apache.commons.collections.map.FixedSizeMap

Class Overview

Decorates another Map to fix the size, preventing add/remove.

Any action that would change the size of the map is disallowed. The put method is allowed to change the value associated with an existing key however.

If trying to remove or clear the map, an UnsupportedOperationException is thrown. If trying to put a new mapping into the map, an IllegalArgumentException is thrown. This is because the put method can succeed if the mapping's key already exists in the map, so the put method is not always unsupported.

Note that FixedSizeMap is not synchronized and is not thread-safe. If you wish to use this map from multiple threads concurrently, you must use appropriate synchronization. The simplest approach is to wrap this map using synchronizedMap(Map). This class may throw exceptions when accessed by concurrent threads without synchronization.

This class is Serializable from Commons Collections 3.1.

Summary

[Expand]
Inherited Fields
From class org.apache.commons.collections.map.AbstractMapDecorator
Protected Constructors
FixedSizeMap(Map map)
Constructor that wraps (not copies).
Public Methods
void clear()
static Map decorate(Map map)
Factory method to create a fixed size map.
Set entrySet()
boolean isFull()
Returns true if this map is full and no new elements can be added.
Set keySet()
int maxSize()
Gets the maximum size of the map (the bound).
Object put(Object key, Object value)
void putAll(Map mapToCopy)
Object remove(Object key)
Collection values()
[Expand]
Inherited Methods
From class org.apache.commons.collections.map.AbstractMapDecorator
From class java.lang.Object
From interface java.util.Map
From interface org.apache.commons.collections.BoundedMap

Protected Constructors

protected FixedSizeMap (Map map)

Constructor that wraps (not copies).

Parameters
map the map to decorate, must not be null
Throws
IllegalArgumentException if map is null

Public Methods

public void clear ()

public static Map decorate (Map map)

Factory method to create a fixed size map.

Parameters
map the map to decorate, must not be null
Throws
IllegalArgumentException if map is null

public Set entrySet ()

public boolean isFull ()

Returns true if this map is full and no new elements can be added.

Returns
  • true if the map is full

public Set keySet ()

public int maxSize ()

Gets the maximum size of the map (the bound).

Returns
  • the maximum number of elements the map can hold

public Object put (Object key, Object value)

public void putAll (Map mapToCopy)

public Object remove (Object key)

public Collection values ()