sun.com/j2se/1.4/docs/api/java/util/WeakHashMap.html">
WeakHashMap
. However, you can also specify hard keys and weak values, or any other combination. The default constructor uses hard keys and soft values, providing a memory-sensitive cache.
This map is similar to {@link org.apache.commons.collections15.map.ReferenceIdentityMap ReferenceIdentityMap}. It differs in that keys and values in this class are compared using
equals()
.
This {@link java.util.Map} implementation does
not allow null elements.Attempting to add a null key or value to the map will raise a
NullPointerException
.
This implementation is not synchronized. You can use {@link java.util.Collections#synchronizedMap} toprovide synchronized access to a
ReferenceMap
. Remember that synchronization will not stop the garbage collecter removing entries.
All the available iterators can be reset back to the start by casting to
ResettableIterator
and calling
reset()
.
NOTE: As from Commons Collections 3.1 this map extends
AbstractReferenceMap
(previously it extended AbstractMap). As a result, the implementation is now extensible and provides a
MapIterator
.
@author Paul Jack
@author Matt Hall, John Watkinson, Stephen Colebourne
@version $Revision: 1.1 $ $Date: 2005/10/11 17:05:32 $
@see java.lang.ref.Reference
@since Commons Collections 3.0 (previously in main package v2.1)