58 lines
2.1 KiB
Plaintext
58 lines
2.1 KiB
Plaintext
|
|
||
|
|
Commons Collections Generics Package
|
||
|
|
Version X.X
|
||
|
|
Release Notes
|
||
|
|
|
||
|
|
|
||
|
|
INTRODUCTION:
|
||
|
|
|
||
|
|
Commons collections is a project to develop and maintain collection classes
|
||
|
|
based on and inspired by the JDK collection framework.
|
||
|
|
This version uses the generics features of JDK1.5 and is not compatible with
|
||
|
|
earlier JDK versions.
|
||
|
|
|
||
|
|
The process of generifying an API is complex.
|
||
|
|
For commons-collections, we have chosen to break the API in various ways.
|
||
|
|
The aim behind this is to provide an API design that better suits generics.
|
||
|
|
We have also removed all deprecated classes and fixed oddities in the previous
|
||
|
|
API that we couldn't fix due to backwards compatability restrictions.
|
||
|
|
|
||
|
|
As such, this release should not be considered to be a simple, drop-in, replacement
|
||
|
|
for commons-collections. You will probably receive compile errors, and you will
|
||
|
|
certainly have generification warnings to solve. These release notes will try
|
||
|
|
to guide you in the process of upgrading, however you should remember that this
|
||
|
|
is a new API based on the original, so some concepts have changed.
|
||
|
|
|
||
|
|
|
||
|
|
Changes from commons-collections
|
||
|
|
--------------------------------
|
||
|
|
- Removed all deprecated classes and methods
|
||
|
|
|
||
|
|
- Removed FastArrayList
|
||
|
|
- use CopyOnWriteList
|
||
|
|
- Removed FastHashMap
|
||
|
|
- use ConcurrentHashMap, but beware null keys and values
|
||
|
|
- Removed FastTreeSet
|
||
|
|
- no direct replacement - use ConcurrentHashMap or synchronized TreeMap
|
||
|
|
|
||
|
|
- Removed Typed* containers such as TypedList and TypedMap
|
||
|
|
- use generics for type safety, or Collections.checked*()
|
||
|
|
|
||
|
|
- Switch Abstract*Decorator classes to expose decorated() protected method
|
||
|
|
instead of the decorated collection directly. Each class overrides decorated()
|
||
|
|
to add its type covariantly, thus getList()/getSet() etc. methods are removed
|
||
|
|
|
||
|
|
|
||
|
|
Feedback
|
||
|
|
--------
|
||
|
|
Open source works best when you give feedback:
|
||
|
|
http://jakarta.apache.org/commons/collections/
|
||
|
|
|
||
|
|
Please direct all bug reports to JIRA
|
||
|
|
http://issues.apache.org/jira/browse/COLLECTIONS
|
||
|
|
|
||
|
|
Or subscribe to the commons-user mailing list (prefix emails by [collections])
|
||
|
|
http://jakarta.apache.org/site/mail.html
|
||
|
|
|
||
|
|
The Commons-Collections-Generics Team
|