RELEASE NOTES: COLLECTIONS 3.1

This release focusses on bug fixes and minor enhancements. No interface changes, or deprecations have occurred.

SingletonMap - fully featured singleton Map implementation
TransformedPredicate - A predicate where the input object is transformed [26946]
ObjectGraphIterator - An iterator that can iterate over a graph of objects
AbstractReferenceMap - New base class for reference maps [26503]

ReferenceMap - Changed to extend AbstractReferenceMap, thus gaining a mapIterator() and subclassability [26503]
Fast3Map - Add clone() method
MultiKey - Add getKey(index) and size() methods and make constructor public
MultiHashMap - Add five methods to improve the API
AbstractHashedMap,AbstractLinkedMap - Add methods to access entry methods when protected scope blocks
Functors - Add get methods to retrieve internal state [27515]
Functors - Add additional getInstance() methods for consistency [27856,27857]
CollectionUtils - get(Object,int) method now supports primitive arrays
CollectionUtils - Add size(Object) method to find the size of various collection-like objects [27909]
SingletonIterator - make remove() functionality optional

Map/BidiMap implementations only checked key and not value in entry set contains(Object) and remove(Object)
AbstractHashedMap subclasses failed to clone() correctly [27159]
ExtendedProperties - Close input stream in constructor [27737]
Flat3Map - Handle infinite loops in toString

TreeBidiMap - Add javadoc about requiring Comparable entries [26470]
MultiKey - Add extra explanatations, examples and warnings
MultiMap,MultiHashMap - Add extra documentation to clarify the interface and implementation
XxxUtils - Clarify the internal workings of the predicated decorator classes [28115]