| <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> |
| $Id: STATUS.html,v 1.8 2002/02/13 20:21:05 morgand Exp $<br> |
| <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 |
| extend or augment the Java Collections Framework. |
| The following classes are included:</p> |
| <ul> |
| <li><strong>ArrayEnumeration</strong> - a java.util.Enumeration wrapper for arrays.</li> |
| <li><strong>ArrayIterator</strong> - a java.util.Iterator wrapper for arrays.</li> |
| <li><strong>ArrayStack</strong> - An implementation of the java.util.Stack API |
| that is based on an ArrayList instead of a Vector, so it is not synchronized to |
| protect against multi-threaded access.</li> |
| <li><strong>BeanMap</strong> - An implementation of the java.util.Map API |
| that is based on a JavaBean using introspection. The property names are the |
| keys of the map and the property values are the values of the map.</li> |
| <li><strong>CollectionUtils</strong> - a variety of helper methods |
| for working with collections.</li> |
| <li><strong>CursorableLinkedList</strong> - an implementation of the java.util.List |
| interface supporting a java.util.ListIterator that allows concurrent |
| modifications to the underlying list.</li> |
| <li><strong>ExtendedProperties</strong> - extends normal Java properties by adding |
| the possibility to use the same key many times, concatenating the value strings |
| instead of overwriting them.</li> |
| <li><strong>FastArrayList</strong> - a custom implementation of java.util.ArrayList |
| designed to operate in a multithreaded environment where the large majority of |
| method calls are read-only, instead of structural changes.</li> |
| <li><strong>FastHashMap</strong> - a custom implementation of java.util.HashMap |
| designed to operate in a multithreaded environment where the large majority of |
| method calls are read-only, instead of structural changes.</li> |
| <li><strong>FastTreeMap</strong> - a custom implementation of java.util.TreeMap |
| designed to operate in a multithreaded environment where the large majority of |
| method calls are read-only, instead of structural changes.</li> |
| <li><strong>ListUtils</strong> - miscelaneous utilities to manipulate Lists.</li> |
| <li><strong>PriorityQueue</strong> - a PriorityQueue interface, with |
| <strong>BinaryHeap</strong> and <strong>SynchronizedPriorityQueue</strong> |
| implementations.</li> |
| </ul> |
| |
| <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> |
| (Version 3.7 or later) - for unit tests only, not required |
| for deployment</li> |
| </ul> |
| |
| |
| <a name="Release Info"></a> |
| <h3>3. RELEASE INFO</h3> |
| |
| <p>Current Release: |
| <a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-collections/v1.0">Version 1.0</a> |
| |
| <p>Planned Next Release: TBD</p> |
| |
| <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> |
| <li><a href="mailto:morgand@apache.org">Morgan Delagrange</a></li> |
| <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> |
| </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 |
| or collection-related classes.</td> |
| <td align="center"> </td> |
| </tr> |
| |
| <tr> |
| <td><strong>Generalized Unit Tests</strong>. Create a generic |
| set of Unit Tests that test the standard contracts of the basic |
| Java Collections interfaces (List, Set, Map, etc.)</td> |
| <td align="center"> </td> |
| </tr> |
| |
| <tr> |
| <td><strong>Additional Documentation</strong>. Create simple |
| User's Guide, examples, or other documentation for this package.</td> |
| <td align="center"> </td> |
| </tr> |
| </table> |
| |
| </body> |
| </html> |
