Added myself as a committer
git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/collections/trunk@130473 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
James Strachan
parent
9f673d4da6
commit
a971c4055c
173
PROPOSAL.html
173
PROPOSAL.html
|
|
@ -1,86 +1,87 @@
|
|||
<html>
|
||||
<head>
|
||||
<title>Proposal for Collections Package</title>
|
||||
</head>
|
||||
<body bgcolor="white">
|
||||
|
||||
<div align="center">
|
||||
<h1>Proposal for <em>Collections</em> Package</h1>
|
||||
</div>
|
||||
|
||||
<h3>(0) Rationale</h3>
|
||||
<p>
|
||||
The Java Collections Framework provides a set of abstract data
|
||||
type interfaces and implementations that offer both a wealth
|
||||
of useful functionality, and a solid foundation for extending
|
||||
that functionality.
|
||||
</p>
|
||||
<p>
|
||||
Many Jakarta projects have needs or design criteria that extend
|
||||
beyond the core Collections API, such as introducing new abstract
|
||||
data types (e.g., Avalon's BinaryHeap) or changing the behaviour of
|
||||
existing abstract data types (e.g., Struts' FastHashMap).
|
||||
</p>
|
||||
<p>
|
||||
In keeping with the spirit of the Collections API and of abstract
|
||||
data types in general, these components can and should be shared
|
||||
assets. A Commons package for abstract data types would provide
|
||||
encourage the development and reuse of a robust set of collections
|
||||
classes.
|
||||
</p>
|
||||
|
||||
<h3>(1) Scope of the Package</h3>
|
||||
<p>
|
||||
The package will create and maintain a set of collections and
|
||||
related classes designed to be compatible with the Java Collections
|
||||
Framework, and to be distributed under the ASF license.
|
||||
</p>
|
||||
|
||||
<h3>(1.5) Interaction With Other Packages</h3>
|
||||
|
||||
<p><em>Collections</em> relies only on standard JDK 1.2 (or later) APIs for
|
||||
production deployment. It utilizes the JUnit unit testing framework for
|
||||
developing and executing unit tests, but this is of interest only to
|
||||
developers of the component. Collections will also be a dependency for
|
||||
several future proposed components for the Jakarta Commons subproject.
|
||||
|
||||
<p>No external configuration files are utilized.</p>
|
||||
|
||||
<h3>(2) Initial Source of the Package</h3>
|
||||
|
||||
<p>
|
||||
The initial codebase was harvested from existing and purposed
|
||||
Jakarta packages, including the Commons Database Connection Pool,
|
||||
Struts, and Avalon.
|
||||
</p>
|
||||
|
||||
<p>The proposed package name for the new component is
|
||||
<code>org.apache.commons.collections</code>.</p>
|
||||
|
||||
|
||||
<h3>(3) Required Jakarta-Commons Resources</h3>
|
||||
|
||||
<ul>
|
||||
<li>CVS Repository - New directory <code>collections</code> in the
|
||||
<code>jakarta-commons</code> CVS repository. All initial committers
|
||||
are already committers on <code>jakarta-commons</code>, so no
|
||||
additional user setups are required.</li>
|
||||
<li>Mailing List - Discussions will take place on the general
|
||||
<em>jakarta-commons@jakarta.apache.org</em> mailing list. To help
|
||||
list subscribers identify messages of interest, it is suggested that
|
||||
the message subject of messages about this component be prefixed with
|
||||
[Collections].</li>
|
||||
<li>Bugzilla - New component "Collections" under the "Commons" product
|
||||
category, with appropriate version identifiers as needed.</li>
|
||||
<li>Jyve FAQ - New category "commons-collections" (when available).
|
||||
</ul>
|
||||
|
||||
|
||||
<h3>(4) Initial Committers</h3>
|
||||
<ul>
|
||||
<li>Peter Donald</li>
|
||||
<li>Craig McClanahan</li>
|
||||
<li>Rodney Waldhoff</li>
|
||||
</ul>
|
||||
</body>
|
||||
</html>
|
||||
<html>
|
||||
<head>
|
||||
<title>Proposal for Collections Package</title>
|
||||
</head>
|
||||
<body bgcolor="white">
|
||||
|
||||
<div align="center">
|
||||
<h1>Proposal for <em>Collections</em> Package</h1>
|
||||
</div>
|
||||
|
||||
<h3>(0) Rationale</h3>
|
||||
<p>
|
||||
The Java Collections Framework provides a set of abstract data
|
||||
type interfaces and implementations that offer both a wealth
|
||||
of useful functionality, and a solid foundation for extending
|
||||
that functionality.
|
||||
</p>
|
||||
<p>
|
||||
Many Jakarta projects have needs or design criteria that extend
|
||||
beyond the core Collections API, such as introducing new abstract
|
||||
data types (e.g., Avalon's BinaryHeap) or changing the behaviour of
|
||||
existing abstract data types (e.g., Struts' FastHashMap).
|
||||
</p>
|
||||
<p>
|
||||
In keeping with the spirit of the Collections API and of abstract
|
||||
data types in general, these components can and should be shared
|
||||
assets. A Commons package for abstract data types would provide
|
||||
encourage the development and reuse of a robust set of collections
|
||||
classes.
|
||||
</p>
|
||||
|
||||
<h3>(1) Scope of the Package</h3>
|
||||
<p>
|
||||
The package will create and maintain a set of collections and
|
||||
related classes designed to be compatible with the Java Collections
|
||||
Framework, and to be distributed under the ASF license.
|
||||
</p>
|
||||
|
||||
<h3>(1.5) Interaction With Other Packages</h3>
|
||||
|
||||
<p><em>Collections</em> relies only on standard JDK 1.2 (or later) APIs for
|
||||
production deployment. It utilizes the JUnit unit testing framework for
|
||||
developing and executing unit tests, but this is of interest only to
|
||||
developers of the component. Collections will also be a dependency for
|
||||
several future proposed components for the Jakarta Commons subproject.
|
||||
|
||||
<p>No external configuration files are utilized.</p>
|
||||
|
||||
<h3>(2) Initial Source of the Package</h3>
|
||||
|
||||
<p>
|
||||
The initial codebase was harvested from existing and purposed
|
||||
Jakarta packages, including the Commons Database Connection Pool,
|
||||
Struts, and Avalon.
|
||||
</p>
|
||||
|
||||
<p>The proposed package name for the new component is
|
||||
<code>org.apache.commons.collections</code>.</p>
|
||||
|
||||
|
||||
<h3>(3) Required Jakarta-Commons Resources</h3>
|
||||
|
||||
<ul>
|
||||
<li>CVS Repository - New directory <code>collections</code> in the
|
||||
<code>jakarta-commons</code> CVS repository. All initial committers
|
||||
are already committers on <code>jakarta-commons</code>, so no
|
||||
additional user setups are required.</li>
|
||||
<li>Mailing List - Discussions will take place on the general
|
||||
<em>jakarta-commons@jakarta.apache.org</em> mailing list. To help
|
||||
list subscribers identify messages of interest, it is suggested that
|
||||
the message subject of messages about this component be prefixed with
|
||||
[Collections].</li>
|
||||
<li>Bugzilla - New component "Collections" under the "Commons" product
|
||||
category, with appropriate version identifiers as needed.</li>
|
||||
<li>Jyve FAQ - New category "commons-collections" (when available).
|
||||
</ul>
|
||||
|
||||
|
||||
<h3>(4) Initial Committers</h3>
|
||||
<ul>
|
||||
<li>Peter Donald</li>
|
||||
<li>Craig McClanahan</li>
|
||||
<li>Rodney Waldhoff</li>
|
||||
<li>James Strachan</li>
|
||||
</ul>
|
||||
</body>
|
||||
</html>
|
||||
|
|
|
|||
253
STATUS.html
253
STATUS.html
|
|
@ -1,124 +1,131 @@
|
|||
<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.4 2001/04/23 12:46:54 rwaldhoff 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>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>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.2 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: <strong>Unreleased, CVS Repository Only</strong></p>
|
||||
|
||||
<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:donaldp@apache.org">Peter Donald</a></li>
|
||||
<li><a href="mailto:craigmcc@apache.org">Craig McClanahan</a></li>
|
||||
<li><a href="mailto:rwaldhoff@apache.org">Rodney Waldhoff</a></li>
|
||||
<li><a href="mailto:geirm@apache.org">Geir Magnusson Jr.</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="70%">Action Item</th>
|
||||
<th width="10%">Required for 1.0 Release?</th>
|
||||
<th width="20%">Volunteer</th>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong>Additional Contributions</strong>. Other collections
|
||||
classes.</td>
|
||||
<td align="center">No?</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, etc.)</td>
|
||||
<td align="center">Yes</td>
|
||||
<td align="center">Rod</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong>Additional Documentation</strong>. Create simple
|
||||
User's Guide, examples, or other documentation for this package.</td>
|
||||
<td align="center">No (JavaDoc/Unit tests suffice for now?)</td>
|
||||
<td align="center"> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
</body>
|
||||
<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.5 2001/05/08 13:05:44 jstrachan 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.2 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: <strong>Unreleased, CVS Repository Only</strong></p>
|
||||
|
||||
<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:donaldp@apache.org">Peter Donald</a></li>
|
||||
<li><a href="mailto:craigmcc@apache.org">Craig McClanahan</a></li>
|
||||
<li><a href="mailto:rwaldhoff@apache.org">Rodney Waldhoff</a></li>
|
||||
<li><a href="mailto:geirm@apache.org">Geir Magnusson Jr.</a></li>
|
||||
<li><a href="mailto:jvanzyl@apache.org">Jason van Zyl</a></li>
|
||||
<li><a href="mailto:jstrachan@apache.org">James Strachan</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="70%">Action Item</th>
|
||||
<th width="10%">Required for 1.0 Release?</th>
|
||||
<th width="20%">Volunteer</th>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong>Additional Contributions</strong>. Other collections
|
||||
classes.</td>
|
||||
<td align="center">No?</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, etc.)</td>
|
||||
<td align="center">Yes</td>
|
||||
<td align="center">Rod</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong>Additional Documentation</strong>. Create simple
|
||||
User's Guide, examples, or other documentation for this package.</td>
|
||||
<td align="center">No (JavaDoc/Unit tests suffice for now?)</td>
|
||||
<td align="center"> </td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
Loading…
Reference in New Issue