Class HashedMap
- java.lang.Object
-
- java.util.AbstractMap
-
- org.apache.commons.collections.map.AbstractHashedMap
-
- org.apache.commons.collections.map.HashedMap
-
- All Implemented Interfaces:
java.io.Serializable
,java.lang.Cloneable
,java.util.Map
,IterableMap
public class HashedMap extends AbstractHashedMap implements java.io.Serializable, java.lang.Cloneable
AMap
implementation that is a general purpose alternative toHashMap
.This implementation improves on the JDK1.4 HashMap by adding the
MapIterator
functionality and many methods for subclassing.Note that HashedMap 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
Collections.synchronizedMap(Map)
. This class may throw exceptions when accessed by concurrent threads without synchronization.- Since:
- Commons Collections 3.0
- Version:
- $Revision: 646777 $ $Date: 2008-04-10 14:33:15 +0200 (Thu, 10 Apr 2008) $
- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class org.apache.commons.collections.map.AbstractHashedMap
AbstractHashedMap.EntrySet, AbstractHashedMap.EntrySetIterator, AbstractHashedMap.HashEntry, AbstractHashedMap.HashIterator, AbstractHashedMap.HashMapIterator, AbstractHashedMap.KeySet, AbstractHashedMap.KeySetIterator, AbstractHashedMap.Values, AbstractHashedMap.ValuesIterator
-
-
Field Summary
Fields Modifier and Type Field Description private static long
serialVersionUID
Serialisation version-
Fields inherited from class org.apache.commons.collections.map.AbstractHashedMap
data, DEFAULT_CAPACITY, DEFAULT_LOAD_FACTOR, DEFAULT_THRESHOLD, entrySet, GETKEY_INVALID, GETVALUE_INVALID, keySet, loadFactor, MAXIMUM_CAPACITY, modCount, NO_NEXT_ENTRY, NO_PREVIOUS_ENTRY, NULL, REMOVE_INVALID, SETVALUE_INVALID, size, threshold, values
-
-
Constructor Summary
Constructors Constructor Description HashedMap()
Constructs a new empty map with default size and load factor.HashedMap(int initialCapacity)
Constructs a new, empty map with the specified initial capacity.HashedMap(int initialCapacity, float loadFactor)
Constructs a new, empty map with the specified initial capacity and load factor.HashedMap(java.util.Map map)
Constructor copying elements from another map.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.lang.Object
clone()
Clones the map without cloning the keys or values.private void
readObject(java.io.ObjectInputStream in)
Read the map in using a custom routine.private void
writeObject(java.io.ObjectOutputStream out)
Write the map out using a custom routine.-
Methods inherited from class org.apache.commons.collections.map.AbstractHashedMap
addEntry, addMapping, calculateNewCapacity, calculateThreshold, checkCapacity, clear, containsKey, containsValue, convertKey, createEntry, createEntrySetIterator, createKeySetIterator, createValuesIterator, destroyEntry, doReadObject, doWriteObject, ensureCapacity, entryHashCode, entryKey, entryNext, entrySet, entryValue, equals, get, getEntry, hash, hashCode, hashIndex, init, isEmpty, isEqualKey, isEqualValue, keySet, mapIterator, put, putAll, remove, removeEntry, removeMapping, reuseEntry, size, toString, updateEntry, values
-
-
-
-
Field Detail
-
serialVersionUID
private static final long serialVersionUID
Serialisation version- See Also:
- Constant Field Values
-
-
Constructor Detail
-
HashedMap
public HashedMap()
Constructs a new empty map with default size and load factor.
-
HashedMap
public HashedMap(int initialCapacity)
Constructs a new, empty map with the specified initial capacity.- Parameters:
initialCapacity
- the initial capacity- Throws:
java.lang.IllegalArgumentException
- if the initial capacity is less than one
-
HashedMap
public HashedMap(int initialCapacity, float loadFactor)
Constructs a new, empty map with the specified initial capacity and load factor.- Parameters:
initialCapacity
- the initial capacityloadFactor
- the load factor- Throws:
java.lang.IllegalArgumentException
- if the initial capacity is less than onejava.lang.IllegalArgumentException
- if the load factor is less than zero
-
HashedMap
public HashedMap(java.util.Map map)
Constructor copying elements from another map.- Parameters:
map
- the map to copy- Throws:
java.lang.NullPointerException
- if the map is null
-
-
Method Detail
-
clone
public java.lang.Object clone()
Clones the map without cloning the keys or values.- Overrides:
clone
in classAbstractHashedMap
- Returns:
- a shallow clone
-
writeObject
private void writeObject(java.io.ObjectOutputStream out) throws java.io.IOException
Write the map out using a custom routine.- Throws:
java.io.IOException
-
readObject
private void readObject(java.io.ObjectInputStream in) throws java.io.IOException, java.lang.ClassNotFoundException
Read the map in using a custom routine.- Throws:
java.io.IOException
java.lang.ClassNotFoundException
-
-