Java Doc for CaseInsensitiveMap.java in  » Library » Apache-common-Collections » org » apache » commons » collections » map » Java Source Code / Java DocumentationJava Source Code and Java Documentation

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");
 

Note that CaseInsensitiveMap 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 java.util.Collections.synchronizedMap(Map) . This class may throw exceptions when accessed by concurrent threads without synchronization.
since:
   Commons Collections 3.0
version:
   $Revision: 348007 $ $Date: 2005-11-21 22:52:57 +0000 (Mon, 21 Nov 2005) $
author:
   Commons-Collections team

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).
Parameters:
  map - the map to copy
throws:
  NullPointerException - if the map is null

Returns null if key is null.
Parameters:
  key - the key convert the converted key