2001-05-16 18:32:04 -04:00
|
|
|
<html>
|
|
|
|
|
<head>
|
|
|
|
|
<title>Status File for Jakarta Commons "Collections" Package</title>
|
|
|
|
|
<head>
|
|
|
|
|
<body bgcolor="white">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div align="center">
|
|
|
|
|
<h1>The Jakarta Commons <em>Collections</em> Package</h1>
|
2003-12-29 13:04:36 -05:00
|
|
|
$Id: STATUS.html,v 1.30 2003/12/29 18:04:36 scolebourne Exp $<br>
|
2001-05-16 18:32:04 -04:00
|
|
|
<a href="#Introduction">[Introduction]</a>
|
|
|
|
|
<a href="#Dependencies">[Dependencies]</a>
|
|
|
|
|
<a href="#Release Info">[Release Info]</a>
|
|
|
|
|
<a href="#Committers">[Committers]</a>
|
|
|
|
|
<a href="#Action Items">[Action Items]</a>
|
|
|
|
|
<br><br>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a name="Introduction"></a>
|
|
|
|
|
<h3>1. INTRODUCTION</h3>
|
|
|
|
|
|
|
|
|
|
<p>The <em>Collections</em> package contains a set of Java classes that
|
2003-12-29 13:04:36 -05:00
|
|
|
extend or augment the Java Collections Framework. This includes new interfaces
|
|
|
|
|
and new implementations together with supporting utility classes.
|
2002-08-19 20:50:07 -04:00
|
|
|
|
2003-12-29 13:04:36 -05:00
|
|
|
<p>In addition to the main commons-collections jar, a testframework jar file is also produced.
|
2001-05-16 18:32:04 -04:00
|
|
|
|
|
|
|
|
<a name="Dependencies"></a>
|
|
|
|
|
<h3>2. DEPENDENCIES</h3>
|
|
|
|
|
|
|
|
|
|
<p>The <em>Collections</em> package is dependent upon the following external
|
|
|
|
|
components for development and use:</p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li><a href="http://java.sun.com/j2se">Java Development Kit</a>
|
|
|
|
|
(Version 1.2 or later)</li>
|
|
|
|
|
<li><a href="http://www.junit.org">JUnit Testing Framework</a>
|
2001-07-14 19:43:11 -04:00
|
|
|
(Version 3.7 or later) - for unit tests only, not required
|
2001-05-16 18:32:04 -04:00
|
|
|
for deployment</li>
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a name="Release Info"></a>
|
|
|
|
|
<h3>3. RELEASE INFO</h3>
|
|
|
|
|
|
2001-07-14 19:43:11 -04:00
|
|
|
<p>Current Release:
|
2002-10-20 22:03:29 -04:00
|
|
|
<a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-collections/v2.1">Version 2.1</a>
|
2001-05-16 18:32:04 -04:00
|
|
|
|
2002-10-20 22:03:29 -04:00
|
|
|
<p>Planned Next Release: ?</p>
|
2001-05-16 18:32:04 -04:00
|
|
|
|
|
|
|
|
<a name="Committers"></a>
|
|
|
|
|
<h3>4. COMMITTERS</h3>
|
|
|
|
|
|
|
|
|
|
<p>The following individuals are the primary developers and maintainers of this
|
|
|
|
|
component. Developers who plan to use <em>Collections</em> in their own
|
|
|
|
|
projects are encouraged to collaborate on the future development of this
|
|
|
|
|
component to ensure that it continues to meet a variety of needs.</p>
|
|
|
|
|
<ul>
|
2002-02-20 21:01:21 -05:00
|
|
|
<li><a href="mailto:mas@apache.org">Michael A. Smith</a></li>
|
2002-02-13 15:21:05 -05:00
|
|
|
<li><a href="mailto:morgand@apache.org">Morgan Delagrange</a></li>
|
2001-05-16 18:32:04 -04:00
|
|
|
<li><a href="mailto:donaldp@apache.org">Peter Donald</a></li>
|
|
|
|
|
<li><a href="mailto:geirm@apache.org">Geir Magnusson Jr.</a></li>
|
|
|
|
|
<li><a href="mailto:craigmcc@apache.org">Craig McClanahan</a></li>
|
|
|
|
|
<li><a href="mailto:jstrachan@apache.org">James Strachan</a></li>
|
|
|
|
|
<li><a href="mailto:rwaldhoff@apache.org">Rodney Waldhoff</a></li>
|
|
|
|
|
<li><a href="mailto:jvanzyl@apache.org">Jason van Zyl</a></li>
|
2002-02-21 12:38:28 -05:00
|
|
|
<li><a href="mailto:bayard@apache.org">Henri Yandell</a></li>
|
2002-08-15 20:14:41 -04:00
|
|
|
<li><a href="mailto:pjack@apache.org">Paul Jack</a></li>
|
2002-08-17 07:39:50 -04:00
|
|
|
<li><a href="mailto:scolebourne@apache.org">Stephen Colebourne</a></li>
|
2003-05-06 09:22:37 -04:00
|
|
|
<li><a href="mailto:rdonkin@apache.org">Robert Burrell Donkin</a></li>
|
2003-09-04 21:58:48 -04:00
|
|
|
<li><a href="mailto:psteitz@apache.org">Phil Steitz</a></li>
|
2003-09-23 16:45:50 -04:00
|
|
|
<li><a href="mailto:matth@apache.org">Matthew Hawthorne</a></li>
|
2003-12-10 19:56:47 -05:00
|
|
|
<li>Arun M. Thomas</li>
|
2001-05-16 18:32:04 -04:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<a name="Action Items"></a>
|
|
|
|
|
<h3>5. ACTION ITEMS</h3>
|
|
|
|
|
|
|
|
|
|
<p>Want to help? Here's some "to do" items the team has identified.</p>
|
|
|
|
|
|
|
|
|
|
<table border="1">
|
|
|
|
|
<tr>
|
|
|
|
|
<th width="80%">Action Item</th>
|
|
|
|
|
<th width="20%">Volunteer</th>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td><strong>Additional Contributions</strong>. Other collection
|
2002-08-17 07:39:50 -04:00
|
|
|
or collection-related classes or decorators.</td>
|
2001-05-16 18:32:04 -04:00
|
|
|
<td align="center"> </td>
|
|
|
|
|
</tr>
|
2002-10-15 17:44:24 -04:00
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td><strong>MultiMap ideas</strong>. Updates to MultiMap, maybe based on
|
|
|
|
|
<a href="http://www.innig.org/util/innig-util/build/javadoc">this library</a>.</td>
|
|
|
|
|
<td align="center"> </td>
|
|
|
|
|
</tr>
|
2001-05-16 18:32:04 -04:00
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td><strong>Additional Documentation</strong>. Create simple
|
|
|
|
|
User's Guide, examples, or other documentation for this package.</td>
|
|
|
|
|
<td align="center"> </td>
|
|
|
|
|
</tr>
|
2002-08-19 20:50:07 -04:00
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td><strong>Serializable Collections</strong>. All of the concrete
|
|
|
|
|
Collection and Map implementations should be properly Serializable
|
|
|
|
|
across all versions of the JDK. Also, decorators should be
|
|
|
|
|
Serializable if the underlying instance is.</td>
|
|
|
|
|
<td align="center"> </td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td><strong>Fail-Fast Iterators</strong>. All concrete Collection and
|
|
|
|
|
Map implementations that can have fail-fast iterators should have
|
|
|
|
|
them. Some classes, like StaticBucketMap, cannot possibly have
|
|
|
|
|
fail-fast iterators, but otherwise everything else should.</td>
|
|
|
|
|
<td align="center"> </td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
2002-11-21 18:09:57 -05:00
|
|
|
<tr>
|
|
|
|
|
<td><strong>LoopingListIterator</strong>. A ListIterator similar to LoopingIterator</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
2002-08-19 20:50:07 -04:00
|
|
|
<tr>
|
|
|
|
|
<td><strong>Standard Constructors</strong>. All concrete Collection and
|
|
|
|
|
Map implementations should have the standard copy and no-argument
|
|
|
|
|
constructors.</td>
|
|
|
|
|
<td align="center"> </td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td><strong>Additional Unit Tests</strong>. Create generic unit tests
|
|
|
|
|
for SortedSet and SortedMap.</td>
|
|
|
|
|
<td align="center"> </td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
2001-05-16 18:32:04 -04:00
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
</body>
|
2001-07-14 19:43:11 -04:00
|
|
|
</html>
|
