2004-02-19 16:41:04 -05:00
|
|
|
<!--
|
2005-01-03 18:53:48 -05:00
|
|
|
Copyright 2003-2005 The Apache Software Foundation
|
2004-02-19 16:41:04 -05:00
|
|
|
|
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
|
you may not use this file except in compliance with the License.
|
|
|
|
|
You may obtain a copy of the License at
|
|
|
|
|
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
|
See the License for the specific language governing permissions and
|
|
|
|
|
limitations under the License.
|
|
|
|
|
-->
|
2004-12-24 06:10:24 -05:00
|
|
|
<html>
|
|
|
|
|
<head>
|
2004-06-28 19:26:33 -04:00
|
|
|
<title>RELEASE NOTES: COLLECTIONS 3.2</title>
|
2004-12-24 06:10:24 -05:00
|
|
|
</head>
|
|
|
|
|
<body>
|
2004-06-28 19:26:33 -04:00
|
|
|
<center><h2>RELEASE NOTES: COLLECTIONS 3.2</h2></center>
|
2003-09-29 18:46:15 -04:00
|
|
|
|
2005-06-25 12:39:34 -04:00
|
|
|
<p>
|
|
|
|
|
Commons collections is a project to develop and maintain collection classes
|
|
|
|
|
based on and inspired by the JDK collection framework.
|
|
|
|
|
This project is JDK1.2 compatible, and does not use JDK1.5 generics.
|
|
|
|
|
</p>
|
2003-12-29 13:04:36 -05:00
|
|
|
<p>
|
2004-06-10 18:14:59 -04:00
|
|
|
This release adds various new classes and fixes a number of bugs.
|
2004-06-09 17:13:14 -04:00
|
|
|
All feedback should be directed to commons-user at jakarta.apache.org.
|
2004-12-24 06:10:24 -05:00
|
|
|
</p>
|
2003-09-29 18:46:15 -04:00
|
|
|
<hr />
|
|
|
|
|
|
2004-05-03 18:43:57 -04:00
|
|
|
<center><h3>COMPATABILITY</h3></center>
|
2004-06-09 17:13:14 -04:00
|
|
|
<p>
|
2004-06-28 19:26:33 -04:00
|
|
|
This release is fully source and binary compatible with v3.1.
|
2004-06-22 18:24:29 -04:00
|
|
|
(Checks performed using JDiff and Clirr, thanks).
|
2005-03-22 17:14:15 -05:00
|
|
|
Please check the bug fixes to ensure you weren't relying on the behaviour of a bug.
|
2004-06-09 17:13:14 -04:00
|
|
|
</p>
|
|
|
|
|
<p>
|
2005-07-07 20:13:22 -04:00
|
|
|
There are two new <i>deprecations</i>:<br />
|
2005-03-22 18:47:45 -05:00
|
|
|
BeanMap is now deprecated and will be removed in v4.0.
|
|
|
|
|
The class is now available in commons-beanutils (full jar version).
|
|
|
|
|
This change was made to ensure that all bean related collections were in one place (ie. beanutils).
|
2005-07-07 20:13:22 -04:00
|
|
|
If this causes major headaches to anyone please contact commons-dev at jakarta.apache.org.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
MultiHashMap is now deprecated and will be removed in v4.0.
|
|
|
|
|
The class is now available as MultiValueMap in the map subpackage.
|
|
|
|
|
This new version of the class is a decorator and can wrap maps other than HashMap
|
|
|
|
|
making it much more flexible.
|
|
|
|
|
If this causes major headaches to anyone please contact commons-dev at jakarta.apache.org.
|
2004-06-09 17:13:14 -04:00
|
|
|
</p>
|
2004-05-03 18:43:57 -04:00
|
|
|
|
2004-03-13 10:54:34 -05:00
|
|
|
<center><h3>NEW CLASSES</h3></center>
|
2003-09-29 18:46:15 -04:00
|
|
|
<ul>
|
2005-05-21 17:12:54 -04:00
|
|
|
<li>MultiValueMap - Decorator implementation of MultiMap providing control over the map and collection implementations [29440]</li>
|
2005-03-22 17:53:50 -05:00
|
|
|
<li>DefaultedMap - Returns a default value when the key is not found, without adding the default value to the map itself [30911]</li>
|
2005-05-15 14:30:49 -04:00
|
|
|
<li>GrowthList - Decorator that causes set and indexed add to expand the list rather than throw IndexOutOfBoundsException [34171]</li>
|
2004-07-17 17:38:33 -04:00
|
|
|
<li>LoopingListIterator - When the end of the list is reached the iteration continues from the start [30166]</li>
|
2003-09-29 18:46:15 -04:00
|
|
|
</ul>
|
|
|
|
|
|
2004-03-13 10:54:34 -05:00
|
|
|
<center><h3>ENHANCEMENTS</h3></center>
|
|
|
|
|
<ul>
|
2004-07-17 17:38:33 -04:00
|
|
|
<li>CollectionUtils.addIgnoreNull - Adds to the collection if the value being added is not null [30020]</li>
|
2004-09-22 19:03:50 -04:00
|
|
|
<li>MapUtils.putAll - Puts an array of key/value pairs into a map [30882]</li>
|
2004-09-22 19:35:03 -04:00
|
|
|
<li>ExtendedProperties - No longer uses an exception in normal processing [30497]</li>
|
2004-12-24 06:10:24 -05:00
|
|
|
<li>CollectionUtils/ListUtils - retainAll/removeAll that don't change original colllection</li>
|
2005-05-15 05:36:15 -04:00
|
|
|
<li>BlockingBuffer - now includes stack trace if InterupttedException occurs [33700]</li>
|
2005-05-19 18:15:44 -04:00
|
|
|
<li>BlockingBuffer - new methods that allow get and remove with a timeout [27691]</li>
|
2004-04-09 10:35:10 -04:00
|
|
|
</ul>
|
|
|
|
|
|
2004-03-13 07:43:43 -05:00
|
|
|
<center><h3>BUG FIXES</h3></center>
|
2004-03-13 10:54:34 -05:00
|
|
|
<ul>
|
2004-06-28 19:26:33 -04:00
|
|
|
<li>FastArrayList - Fix iterators and views to work better in multithreaded environments</li>
|
2005-05-22 15:23:04 -04:00
|
|
|
<li>FastArrayList - Fix iterator remove where ConcurrentModificationException not as expected [34690]</li>
|
2005-01-29 07:51:12 -05:00
|
|
|
<li>SetUniqueList.set(int,Object) - Destroyed set status in certain circumstances [33294]</li>
|
2005-03-22 17:14:15 -05:00
|
|
|
<li>AbstractLinkedMap.init() - Now calls createEntry() to create the map entry object [33706]</li>
|
2005-05-07 14:04:32 -04:00
|
|
|
<li>AbstractHashedMap deserialization - Fix to prevent doubling of internal data array [34265]</li>
|
2005-05-22 15:24:47 -04:00
|
|
|
<li>AbstractHashedMap initialization - Fix to setup threshold correctly, improving performance [35012]</li>
|
|
|
|
|
<li>BeanMap.initialize() - Internal variable now correctly initialised with only write methods that actually exist [15895]</li>
|
|
|
|
|
<li>MultiHashMap.remove(key, item) - Was returning the item even when nothing was removed [32366]</li>
|
2005-07-07 20:06:50 -04:00
|
|
|
<li>MultiHashMap.putAll(multimap) - Was adding the collection as a single item rather than individually [35631]</li>
|
2005-05-15 05:22:50 -04:00
|
|
|
<li>Flat3Map.equals() - Fix to make flat mode comparison actually work [34917]</li>
|
2005-05-22 15:24:47 -04:00
|
|
|
<li>TransformedMap.putAll - Now allows putAll of an empty map [34686]</li>
|
2005-07-14 19:11:12 -04:00
|
|
|
<li>AbstractMapBag.BagIterator.remove - Removing the last entry used to break the class invariants [35747]</li>
|
2005-05-22 15:24:47 -04:00
|
|
|
<li>BoundedFifoBuffer/CircularFifoBuffer - Fix serialization to work in case where buffer serialized when full [31433]</li>
|
|
|
|
|
<li>BoundedFifoBuffer - Fix iterator remove bug causing ArrayIndexOutOfBounds error [33071]</li>
|
2005-07-16 07:17:02 -04:00
|
|
|
<li>UnboundedFifoBuffer - Fix iterator remove bug causing ArrayIndexOutOfBounds error [35733]</li>
|
2005-07-16 07:30:55 -04:00
|
|
|
<li>UnboundedFifoBuffer - Fix deserialization to work with subsequant object manipulation [35763]</li>
|
2005-05-22 13:27:34 -04:00
|
|
|
<li>IteratorChain.remove() - Fix to avoid IllegalStateException when one of the underlying iterators is a FilterIterator [34267]</li>
|
2005-05-22 19:04:44 -04:00
|
|
|
<li>ExtendedProperties.convertProperties() - Fix to handle default properties maps correctly [32204]</li>
|
2005-06-25 12:39:34 -04:00
|
|
|
<li>Add casts to avoid some JDK1.5 compilation warnings [35474]</li>
|
2004-03-13 10:54:34 -05:00
|
|
|
</ul>
|
2004-03-13 07:43:43 -05:00
|
|
|
|
2004-03-13 10:54:34 -05:00
|
|
|
<center><h3>JAVADOC</h3></center>
|
|
|
|
|
<ul>
|
2004-07-17 17:38:33 -04:00
|
|
|
<li>MapUtils.safeAddToMap - Better comment</li>
|
2005-01-03 19:01:31 -05:00
|
|
|
<li>ListOrderedSet.decorate(List) - Better comment [32073]</li>
|
2004-03-13 10:54:34 -05:00
|
|
|
</ul>
|
2004-12-24 06:10:24 -05:00
|
|
|
</body>
|
2005-01-15 17:47:41 -05:00
|
|
|
</html>
|
