[COLLECTIONS-323] Behavior of constructors CaseInsensitiveMap inconsistent with standard Java HashMap

• Type: Bug
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 3.2
• Fix Version/s: 4.0-alpha1, 4.0
• Component/s: Map

Environment

Any

• Assignee: Jochen Wiedmann
• Reporter: Maarten Brak
• Created: 22/Apr/09 08:43
• Updated: 09/Nov/14 14:31
• Resolved: 08/Mar/11 23:39

Description

The constructor CaseInsensitiveMap(int initialCapacity) throws an IllegalArgumentException if "the initial capacity is less than one". This is inconsistent with the standard Java HashMap constructor HashMap(int initialCapacity), which throws an if IllegalArgumentException if "the initial capacity is negative".

Thus:
new HashMap(0) ==> no exception
new CaseInsensitiveMap(0) ==> IllegalArgumentException.

This inconsistency is confusing.

Actions:

• Change Javadoc (this shouldn't be a problem in practice since surely there is no code around depending on the fact that the constructor throws an IllegalArgumentException )
• Change code.