org.apache.commons.collections.map
Class CaseInsensitiveMap
- Cloneable, Map, Serializable, IterableMap
public class CaseInsensitiveMap
implements Serializable, Cloneable
A case-insensitive
Map
.
As entries are added to the map, keys are converted to all lowercase. A new
key is compared to existing keys by comparing
newKey.toString().toLower()
to the lowercase values in the current
KeySet.
Null keys are supported.
The
keySet()
method returns all lowercase keys, or nulls.
Example:
Map map = new CaseInsensitiveMap();
map.put("One", "One");
map.put("Two", "Two");
map.put(null, "Three");
map.put("one", "Four");
creates a
CaseInsensitiveMap
with three entries.
map.get(null)
returns
"Three"
and
map.get("ONE")
returns
"Four".
The
Set
returned by
keySet()
equals
{"one", "two", null}.
Version:
- Commons-Collections team
- Commons Collections 3.0
DEFAULT_CAPACITY , DEFAULT_LOAD_FACTOR , DEFAULT_THRESHOLD , GETKEY_INVALID , GETVALUE_INVALID , MAXIMUM_CAPACITY , NO_NEXT_ENTRY , NO_PREVIOUS_ENTRY , NULL , REMOVE_INVALID , SETVALUE_INVALID , data , entrySet , keySet , loadFactor , modCount , size , threshold , values |
CaseInsensitiveMap() - Constructs a new empty map with default size and load factor.
|
CaseInsensitiveMap(Map map) - Constructor copying elements from another map.
|
CaseInsensitiveMap(int initialCapacity) - Constructs a new, empty map with the specified initial capacity.
|
CaseInsensitiveMap(int initialCapacity, float loadFactor) - Constructs a new, empty map with the specified initial capacity and
load factor.
|
Object | clone() - Clones the map without cloning the keys or values.
|
protected Object | convertKey(Object key) - Overrides convertKey() from
AbstractHashedMap to convert keys to
lower case.
|
addEntry , addMapping , calculateNewCapacity , calculateThreshold , checkCapacity , clear , clone , 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 |
CaseInsensitiveMap
public CaseInsensitiveMap()
Constructs a new empty map with default size and load factor.
CaseInsensitiveMap
public CaseInsensitiveMap(Map map)
Constructor copying elements from another map.
Keys will be converted to lower case strings, which may cause
some entries to be removed (if string representation of keys differ
only by character case).
map
- the map to copy
CaseInsensitiveMap
public CaseInsensitiveMap(int initialCapacity)
Constructs a new, empty map with the specified initial capacity.
initialCapacity
- the initial capacity
CaseInsensitiveMap
public CaseInsensitiveMap(int initialCapacity,
float loadFactor)
Constructs a new, empty map with the specified initial capacity and
load factor.
initialCapacity
- the initial capacityloadFactor
- the load factor
clone
public Object clone()
Clones the map without cloning the keys or values.
- clone in interface AbstractHashedMap
- a shallow clone
convertKey
protected Object convertKey(Object key)
Overrides convertKey() from
AbstractHashedMap
to convert keys to
lower case.
Returns null if key is null.
- convertKey in interface AbstractHashedMap
key
- the key convert
- the converted key
Copyright © 2001-2005 Apache Software Foundation. All Rights Reserved.