Apache
/
commons-collections
mirror of https://github.com/apache/commons-collections.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Tagged current head prior to creation of JDK5 branch 

git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/collections/tags/PRE_GENERICS@468105 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Kristopher J. Nuttycombe 2006-10-26 19:50:40 +00:00
parent b73b147176
commit decf5c8da9
691 changed files with 95221 additions and 23656 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
.cvsignore
View File

@ -1,2 +0,0 @@
build.properties
dist

52
DEVELOPERS-GUIDE.html
View File

@ -1,19 +1,36 @@
<!--
Copyright 2002-2004 The Apache Software Foundation
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.
-->
<html>
<head>
<title>Developers guide for Jakarta Commons "Collections" Package</title>
<head>
</head>
<body bgcolor="white">
<div align="center">
<h1>The Jakarta Commons <em>Collections</em> Package</h1>
<h2>Developers Guide</h2>
$Id: DEVELOPERS-GUIDE.html,v 1.2 2002/07/03 02:34:09 mas Exp $<br>
$Id$<br />
<a href="#Introduction">[Introduction]</a>
<a href="#CollectionInterfaces">[Collection Interfaces]</a>
<a href="#CollectionImplementations">[Collection Implementations]</a>
<a href="#UtilityClasses">[Utility Classes]</a>
<br><br>
<a href="#CodingStandards">[Coding Standards]</a>
<br />
<br />
</div>
@ -89,13 +106,28 @@ Occasionally, such construct is awkward and a more suitable adjective can be
used instead. For example, <code>lazyList</code>,
<code>unmodifiableList</code>.</p>
<p>Typically, these decorators should be implemented as non-public, static,
inner classes; however, if warranted due to maintenance or other reasons, these
decorator classes may be moved to top-level classes in a subpackage. The
naming of such a subpackage should be discussed and agreed upon on the
developers mailing list.</p>
<p>These decorators should be implemented either as non-public, static,
inner classes, or as public classes in a subpackage. If a subpackage is used,
the constructors should be protected and a public static decorate() method
provided on each class for construction.</p>
<a name="CodingStandards"></a>
<h3>5. CODING STANDARDS</h3>
<p>Commons Collections follows similar style rules to many other Java open source
projects, and the Sun conventions. Some specific conventions are:</p>
<ul>
<li>No tabs, 4 space indentations</li>
<li>Curly brackets open at line end</li>
<li>Else, catch and finally statements after the closing bracket</li>
<li>Single space after keyword such as if</li>
<li>Two spaces between parameter name and description in @param</li>
<li>Generally copy the style of the surounding code</li>
</ul>
<p>And rememeber, the commons-dev mailing list is there for any discussions
or queries about patches or new additions to collections.</p>
</body>
</html>

262
LICENSE.txt
View File

@ -1,60 +1,202 @@
/*
* $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//collections/LICENSE.txt,v 1.1 2002/07/25 02:36:45 jvanzyl Exp $
* $Revision: 1.1 $
* $Date: 2002/07/25 02:36:45 $
*
* ====================================================================
*
* The Apache Software License, Version 1.1
*
* Copyright (c) 1999-2001 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The end-user documentation included with the redistribution, if
* any, must include the following acknowlegement:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowlegement may appear in the software itself,
* if and wherever such third-party acknowlegements normally appear.
*
* 4. The names "The Jakarta Project", "Commons", and "Apache Software
* Foundation" must not be used to endorse or promote products derived
* from this software without prior written permission. For written
* permission, please contact apache@apache.org.
*
* 5. Products derived from this software may not be called "Apache"
* nor may "Apache" appear in their names without prior written
* permission of the Apache Group.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation. For more
* information on the Apache Software Foundation, please see
* <http://www.apache.org/>.
*
*/
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright [yyyy] [name of copyright owner]
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.

2
NOTICE.txt Normal file
View File

@ -0,0 +1,2 @@
This product includes software developed by
The Apache Software Foundation (http://www.apache.org/).

189
PROPOSAL.html
View File

@ -1,87 +1,102 @@
<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>
<!--
Copyright 2001-2004 The Apache Software Foundation
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.
-->
<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
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>
<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 proposed
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). </li>
</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>

52
README.txt
View File

@ -1,13 +1,21 @@
Jakarta Commons Collections
===========================
Welcome to the Collections component of the Jakarta Commons
project.
Welcome to the Collections component of the Jakarta Commons project.
This component contains many new collections and collection utilities.
This component requires the excellent Ant utility. It can
be found here :
Two jar files are produced by this component.
The first, commons-collections.jar is the main jar used by applications.
The second, commons-collections-testframework.jar is an extension to junit
for testing new collection implementations and is not normally used by applications.
http://jakarta.apache.org/ant/
Building from source
--------------------
This component requires the excellent Ant utility.
It can be found here :
http://ant.apache.org/
For testing the project, you will also need JUnit :
@ -19,24 +27,26 @@ build.properties, and modify to reflect
the location of the junit.jar on your computer.
Once you have Ant propertly installed, and the
Once you have Ant properly installed, and the
build.properties file correctly reflects the location
of your junit.jar, you are ready to build and test.
The major targets are:
To compile and test the component :
$ ant test
To build a jar :
$ ant dist-jar
To build the API documentation :
$ ant doc
To build the jar and API doc at once :
$ ant dist
ant compile - compile the code
ant test - test using junit
ant jar - create a jar file
ant javadoc - build the javadoc
ant dist - create folders as per a distribution
ant tf.jar - create the testframework jar file
ant tf.javadoc - build the testframework javadoc
Maven
-----
The component can also be built using Maven. (Ant is the primary build tool.)
It can be found here :
http://maven.apache.org/
Once installed, the jars may be built with 'maven jar'.

219
RELEASE-NOTES-2.0.html
View File

@ -1,219 +0,0 @@
<title>RELEASE NOTES: COLLECTIONS 2.0</title>
<center><h2>RELEASE NOTES: COLLECTIONS 2.0</h2></center>
<center><h3>NEW COLLECTIONS AND COMPARATORS</h3></center>
<p><i>Collections 2.0</i> includes a significant number of new collections, in addition to several
useful Comparator classes. Descriptions of the new collections and comparators follow.
(For descriptions of all classes in <i>Collections</i>, see the <i>STATUS.html</i> file.)</p>
<p>These collections are new to <i>Collections 2.0</i>:</p>
<ul>
<li><strong>Bag</strong> - A Collection that counts the number of times an
object appears in the collection. Suppose
you have a Bag that contains <code>{a, a, b, c}</code>. Calling
getCount on <code>a</code> would return 2, while calling
uniqueSet would return <code>{a, b, c}</code>. <i>Note: this is an
interface with several implementations.</i></li>
<li><strong>DoubleOrderedMap</strong> - Red-Black tree-based implementation of Map.
This class guarantees
that the map will be in both ascending key order and ascending
value order, sorted according to the natural order for the key's
and value's classes.</li>
<li><strong>FilterListIterator</strong> - A proxy <code>ListIterator</code> which
takes a <code>Predicate</code> instance to filter
out objects from an underlying <code>ListIterator</code>
instance. Only objects for which the specified
<code>Predicate</code> evaluates to <code>true</code> are
returned by the iterator.</li>
<li><strong>HashBag</strong> - An implementation of <strong>Bag</strong> that is backed by a
HashMap.</li>
<li><strong>MultiMap</strong> - This is simply a Map with slightly different semantics.
Instead of returning an Object, it returns a Collection.
So for example, you can put( key, new Integer(1) );
and then a Object get( key ); will return you a Collection
instead of an Integer. This is an interface implemented
by <strong>MultiHashMap</strong>.</li>
<li><strong>ProxyMap</strong> - This <code>Map</code> wraps another <code>Map</code>
implementation, using the wrapped instance for its default
implementation. This class is used as a framework on which to
build to extensions for its wrapped <code>Map</code> object which
would be unavailable or inconvenient via sub-classing (but usable
via composition).</li>
<li><strong>SequencedHashMap</strong> - A map of objects whose mapping entries are
sequenced based on the order in
which they were added.</li>
<li><strong>SortedBag</strong> - A type of <strong>Bag</strong> that maintains order among its unique
representative members</li>
<li><strong>TreeBag</strong> - An implementation of <strong>Bag</strong> that is backed by a
TreeMap. Order will be maintained among the unique representative
members.</li>
</ul>
<p>These are the new Comparator classes:</p>
<ul>
<li><strong>ComparableComparator</strong> - A Comparator that compares Comparable objects.
This Comparator is useful, for example,
for enforcing the natural order in custom implementations
of SortedSet and SortedMap.</li>
<li><strong>ComparatorChain</strong> - ComparatorChain is a Comparator that wraps one or
more Comparators in sequence. The ComparatorChain
calls each Comparator in sequence until either 1)
any single Comparator returns a non-zero result
(and that result is then returned),
or 2) the ComparatorChain is exhausted (and zero is
returned). This type of sorting is very similar
to multi-column sorting in SQL, and this class
allows Java classes to emulate that kind of behaviour
when sorting a List.</li>
<li><strong>ReverseComparator</strong> - Reverses the order of another comparator.</li>
</ul>
<center><h3>CHANGED COLLECTIONS</h3></center>
These classes have changed since <i>Collections 1.0</i>:
<p><u>ArrayEnumeration</u></p>
<p>ArrayEnumeration has been <b>deprecated</b>. This class has significant overlap with
ArrayIterator, and Collections focuses mainly on Java2-style
collections. If you need to enumerate an array,
create an ArrayIterator and wrap it with an
IteratorEnumeration instead.</p>
<p><u>ArrayIterator</u></p>
<p><i>Bugs fixed:</i></p>
<ul>
<li>ArrayIterator can now iterate over arrays of primatives.</li>
<li>ArrayIterator.setArray(Object) will no longer throw an
ArrayIndexOutOfBounds exception.</li>
</ul>
<p><u>LRUMap</u></p>
<p>LRUMap has been reimplemented as a subclass of
SynchronizedHashMap. The new implementation of
LRUMap should be faster, and it also offers true LRU
capabilities; now any get(Object) or
put(Object,Object) from this collection
promotes the key to the Most Recently Used position.</p>
<p><i>LRUMap 2.0 compatibility changes:</i></p>
<ul>
<li>LRUMap can no longer be cast to a HashMap.</li>
<li>The removeLRU() method now has a different
signature, and is no longer public. Instead, use
remove(getFirstKey()).</li>
<li>"Externalized" LRUMap 1.0 Objects cannot be
read by LRUMap 2.0.</li>
</ul>
<p><i>New features:</i></p>
<ul>
<li>True LRU algorithm.</li>
<li>New methods from SequencedHashMap superclass.</li>
<li>processRemovedLRU(Object key, Object value) method
allows subclasses to perform custom actions on
keys and values that are expunged from the Map.</li>
</ul>
<p><i>Bugs fixed:</i></p>
<ul>
<li>calling setMaximumSize(int) will remove excess LRUs
when the current size of the Map exceeds the new
maximum size</li>
</ul>
<p><u>BeanMap</u></p>
<p>BeanMap's entrySet() now properly returns a set containing Map.Entry
objects. Previously, entrySet() was equivalent to keySet() (returns a set of
the readable properties) and there was no mechanism to retrieve all of the
readable properties along with their values. Additionally, the BeanMap clone
method has been revamped to work better for subclasses. </p>
<p><i>BeanMap 2.0 compatibility changes:</i></p>
<ul>
<li>BeanMap's clone() method now declares it throws
CloneNotSupportedException. This allows subclasses of BeanMap to not require
being Cloneable and facilitates subclasses that wish to be cloneable (allows
the subclass to call super.clone() and have it return an instance of the
child rather than the parent).</li>
<li>If a BeanMap is not cloneable because a new instance of the underlying
bean cannot be constructed, a CloneNotSupportedException is thrown rather
than an UnsupportedOperationException or other RuntimeException.</li>
<li>BeanMap's entrySet() method now returns a set of Map.Entry objects rather
than the set of readable properties. To retrieve a set of readable
properties, use keySet() instead.</li>
</ul>
<p><i>Bugs fixed:</i></p>
<ul>
<li>If no bean is set in the BeanMap, or setBean(Object) was called with a
null argument, many BeanMap methods threw NullPointerExceptions. These have
been fixed to properly handle the case where there is no bean established in
the map.</li>
</ul>
<p><u>PriorityQueue</u></p>
<p>Changed to allow priority queue implementations that support determining
priorities using means other than the object's natural ordering (i.e. a
priority queue that does not depend on the object implementing the Comparable
interface).</p>
<p><i>PriorityQueue 2.0 compatibility changes:</i></p>
<ul>
<li>The pop() and peek() methods were changed to return a generic Object
rather than a comparable.</li>
<li>The insert(Comparable) method was changed to take an Object argument
rather than a comparable.</li>
</ul>
<p><u>BinaryHeap</u></p>
<p>Changed to allow the specification of a Comparator that should be used to
compare objects to determine "priority" of the objects. If no comparator is
specified, the object's natural ordering is used.</p>
<p><i>BinaryHeap 2.0 compatibility changes:</i></p>
<ul>
<li>The pop() and peek() methods were changed to return a generic Object
rather than a comparable.</li>
<li>The insert(Comparable) method was changed to take an Object argument
rather than a comparable.</li>
</ul>
<p><i>New features:</i></p>
<ul>
<li>The BinaryHeap supports objects that do not implement Comparable. To use
such objects in the binary heap, a suitable Comparator must be provided in
the constructor so that the binary heap is capable of ordering elements in
their relative priorities.</li>
</ul>

69
RELEASE-NOTES.html Normal file
View File

@ -0,0 +1,69 @@
<!--
Copyright 2003-2006 The Apache Software Foundation
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.
-->
<html>
<head>
<title>RELEASE NOTES: COLLECTIONS 3.3</title>
</head>
<body>
<center><h2>RELEASE NOTES: COLLECTIONS 3.3</h2></center>
<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>
<p>
This release adds various new classes and fixes a number of bugs.
All feedback should be directed to commons-user at jakarta.apache.org.
</p>
<hr />
<center><h3>COMPATIBILITY</h3></center>
<p>
This release is fully source and binary compatible with v3.2.
(Checks performed using JDiff and Clirr, thanks).
Please check the bug fixes to ensure you weren't relying on the behaviour of a bug.
</p>
<p>
There are xxxxxxxxxxxxxxxxxxx new <i>deprecations</i>:<br />
If this causes major headaches to anyone please contact commons-dev at jakarta.apache.org.
</p>
<center><h3>NEW CLASSES</h3></center>
<ul>
<li>xxxxxxxxxxxxxx</li>
</ul>
<center><h3>ENHANCEMENTS</h3></center>
<ul>
<li>xxxxxxxxxxxxxx</li>
</ul>
<center><h3>BUG FIXES</h3></center>
<ul>
<li>Flat3Map - Fix setValue in MapIterator and EntrySetIterator to work correctly [COLLECTIONS-217]</li>
<li>ExtendedProperties - Include property name had confused static/instance semantics [COLLECTIONS-214]</li>
<li>CollectionUtils - Fix removeAll() method which was completely broken [COLLECTIONS-219]</li>
</ul>
<center><h3>JAVADOC</h3></center>
<ul>
<li>IteratorChain - Clarify constructor behaviour</li>
<li>MuliKey - Spelling [COLLECTIONS-216]</li>
<li>DefaultedMap - Clarify transformer behaviour [COLLECTIONS-215]</li>
</ul>
</body>
</html>

162
STATUS.html
View File

@ -1,3 +1,18 @@
<!--
Copyright 2001-2004 The Apache Software Foundation
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.
-->
<html>
<head>
<title>Status File for Jakarta Commons "Collections" Package</title>
@ -7,7 +22,7 @@
<div align="center">
<h1>The Jakarta Commons <em>Collections</em> Package</h1>
$Id: STATUS.html,v 1.13 2002/03/15 05:41:23 morgand Exp $<br>
$Id$<br>
<a href="#Introduction">[Introduction]</a>
<a href="#Dependencies">[Dependencies]</a>
<a href="#Release Info">[Release Info]</a>
@ -21,101 +36,10 @@ $Id: STATUS.html,v 1.13 2002/03/15 05:41:23 morgand Exp $<br>
<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>Bag</strong> - A Collection that keeps a count of its members of the same
type, using <code>hashCode</code> to check for equality. Suppose
you have a Bag that contains <code>{a, a, b, c}</code>. Calling
getCount on <code>a</code> would return 2, while calling
uniqueSet would return <code>{a, b, c}</code>. <i>Note: this is an
interface with several implementations.</i></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>ComparableComparator</strong> - A Comparator that compares Comparable objects.
This Comparator is useful, for example,
for enforcing the natural order in custom implementations
of SortedSet and SortedMap.</li>
<li><strong>ComparatorChain</strong> - ComparatorChain is a Comparator that wraps one or
more Comparators in sequence. The ComparatorChain
calls each Comparator in sequence until either 1)
any single Comparator returns a non-zero result
(and that result is then returned),
or 2) the ComparatorChain is exhausted (and zero is
returned). This type of sorting is very similar
to multi-column sorting in SQL, and this class
allows Java classes to emulate that kind of behaviour
when sorting a List.</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>DoubleOrderedMap</strong> - Red-Black tree-based implementation of Map.
This class guarantees
that the map will be in both ascending key order and ascending
value order, sorted according to the natural order for the key's
and value's classes.</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>FilterIterator</strong> - A Proxy <code>Iterator</code> which takes a
<code>Predicate</code>
instance to filter out objects from an underlying <code>Iterator</code> instance.
Only objects for which the
specified <code>Predicate</code> evaluates to <code>true</code> are
returned.</li>
<li><strong>FilterListIterator</strong> - A proxy <code>ListIterator</code> which
takes a <code>Predicate</code> instance to filter
out objects from an underlying <code>ListIterator</code>
instance. Only objects for which the specified
<code>Predicate</code> evaluates to <code>true</code> are
returned by the iterator.</li>
<li><strong>HashBag</strong> - An implementation of <strong>Bag</strong> that is backed by a
HashMap.</li>
<li><strong>ListUtils</strong> - miscelaneous utilities to manipulate Lists.</li>
<li><strong>MultiMap</strong> - This is simply a Map with slightly different semantics.
Instead of returning an Object, it returns a Collection.
So for example, you can put( key, new Integer(1) );
and then a Object get( key ); will return you a Collection
instead of an Integer. This is an interface implemented
by <strong>MultiHashMap</strong>.</li>
<li><strong>PriorityQueue</strong> - a PriorityQueue interface, with
<strong>BinaryHeap</strong> and <strong>SynchronizedPriorityQueue</strong>
implementations.</li>
<li><strong>ProxyMap</strong> - This <code>Map</code> wraps another <code>Map</code>
implementation, using the wrapped instance for its default
implementation. This class is used as a framework on which to
build to extensions for its wrapped <code>Map</code> object which
would be unavailable or inconvenient via sub-classing (but usable
via composition).</li>
<li><strong>ReverseComparator</strong> - Reverses the order of another comparator.</li>
<li><strong>SequencedHashMap</strong> - A map of objects whose mapping entries are
sequenced based on the order in
which they were added.</li>
<li><strong>SingletonIterator</strong> - An Iterator over a single
object instance.</li>
<li><strong>SortedBag</strong> - A type of <strong>Bag</strong> that maintains order among its unique
representative members</li>
<li><strong>TreeBag</strong> - An implementation of <strong>Bag</strong> that is backed by a
TreeMap. Order will be maintained among the unique representative
members.</li>
</ul>
extend or augment the Java Collections Framework. This includes new interfaces
and new implementations together with supporting utility classes.
<p>In addition to the main commons-collections jar, a testframework jar file is also produced.
<a name="Dependencies"></a>
<h3>2. DEPENDENCIES</h3>
@ -126,7 +50,7 @@ components for development and use:</p>
<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
(Version 3.8.1 or later) - for unit tests only, not required
for deployment</li>
</ul>
@ -135,9 +59,9 @@ components for development and use:</p>
<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>
<a href="http://jakarta.apache.org/site/binindex.cgi">Version 3.2</a>
<p>Planned Next Release: TBD</p>
<p>Planned Next Release: 3.3</p>
<a name="Committers"></a>
<h3>4. COMMITTERS</h3>
@ -147,7 +71,6 @@ 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:mas@apache.org">Michael A. Smith</a></li>
<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>
@ -156,38 +79,23 @@ component to ensure that it continues to meet a variety of needs.</p>
<li><a href="mailto:rwaldhoff@apache.org">Rodney Waldhoff</a></li>
<li><a href="mailto:jvanzyl@apache.org">Jason van Zyl</a></li>
<li><a href="mailto:bayard@apache.org">Henri Yandell</a></li>
<li><a href="mailto:scolebourne@apache.org">Stephen Colebourne</a></li>
<li><a href="mailto:rdonkin@apache.org">Robert Burrell Donkin</a></li>
<li><a href="mailto:psteitz@apache.org">Phil Steitz</a></li>
<li><a href="mailto:matth@apache.org">Matthew Hawthorne</a></li>
<li><a href="mailto:jcarman@apache.org">James Carman</a></li>
<li>Arun M. Thomas</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">&nbsp;</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">&nbsp;</td>
</tr>
<tr>
<td><strong>Additional Documentation</strong>. Create simple
User's Guide, examples, or other documentation for this package.</td>
<td align="center">&nbsp;</td>
</tr>
</table>
<p>
Want to help?
All ideas and suggestions should be made to the commons mailing lists,
commons-user at jakarta.apache.org and commons-dev at jakarta.apache.org.
Please prefix any emails by [collections] to pass mail filters.
</p>
</body>
</html>

4
build.properties.sample
View File

@ -1,4 +0,0 @@
# junit.jar - JUnit 3.2+ Classpath
junit.jar=/java/junit/junit.jar
# optional variable, used for creating source distributions
cvs.root=:pserver:username@localhost:/home/cvs

909
build.xml
View File

@ -1,346 +1,635 @@
<!-- $Id: build.xml,v 1.29 2002/07/25 18:08:05 costin Exp $ -->
<project name="commons-collections" default="test" basedir=".">
<!--
Copyright 2001-2006 The Apache Software Foundation
<!-- patternset describing files to be copied from the doc directory -->
<patternset id="patternset-doc"/>
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
<!-- patternset describing test classes -->
<patternset id="patternset-test-classes">
<include name="**/Test*.class"/>
</patternset>
http://www.apache.org/licenses/LICENSE-2.0
<!-- patternset describing non test classes -->
<patternset id="patternset-non-test-classes">
<include name="**/*.class"/>
<exclude name="**/Test*.class"/>
</patternset>
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.
-->
<project name="commons-collections" default="compile" basedir=".">
<!-- patternset describing non test source files (*.java, *html, etc.) -->
<patternset id="patternset-javadocable-sources">
<include name="**/*"/>
<exclude name="**/Test*.java"/>
</patternset>
<!-- ========== Properties ================================================ -->
<!-- ######################################################### -->
<!-- This can be used to define 'junit.jar' property if necessary -->
<property file="build.properties"/>
<target name="init">
<tstamp/>
<!-- ========== Component Declarations ==================================== -->
<!-- read properties from the build.properties, if any -->
<property name="component-propfile" value="${basedir}/build.properties"/>
<property file="${component-propfile}"/>
<!-- The name of this component -->
<property name="component.name" value="commons-collections"/>
<!-- read properties from the commons build.properties, if any -->
<property name="commons-propfile" value="${basedir}/../build.properties"/>
<property file="${commons-propfile}"/>
<!-- The primary package name of this component -->
<property name="component.package" value="org.apache.commons.collections"/>
<!-- read properties from the ${user.home}/propfile, if any -->
<property name="user-propfile" value="${user.home}/build.properties"/>
<property file="${user-propfile}"/>
<!-- The short title of this component -->
<property name="component.title" value="Commons Collections"/>
<!-- command line classpath, if any -->
<property name="cp" value=""/>
<!-- The full title of this component -->
<property name="component.title.full" value="Apache Jakarta Commons Collections"/>
<!-- now combine the classpaths -->
<property name="classpath" value="${cp}:${junit.jar}"/>
<!-- The current version number of this component -->
<property name="component.version" value="3.3-SNAPSHOT"/>
<property name="name" value="commons-collections"/>
<property name="Name" value="Commons-Collections"/>
<property name="Name-Long" value="Jakarta Commons Collections Package"/>
<!-- The base directory for component configuration files -->
<property name="source.conf" value="src/conf"/>
<!-- The current version number of this component -->
<property name="component.version" value="2.0"/>
<property name="doc.release.notes" value="RELEASE-NOTES-${component.version}.html"/>
<property name="doc.status" value="STATUS.html"/>
<!-- The base directory for component sources -->
<property name="source.java" value="src/java"/>
<property name="test.entry" value="org.apache.commons.collections.TestAll"/>
<property name="test.failonerror" value="true" />
<property name="test.runner" value="junit.textui.TestRunner" />
<!-- The base directory for unit test sources -->
<property name="source.test" value="src/test"/>
<property name="workdir" value="${java.io.tmpdir}/buildtemp_${DSTAMP}${TSTAMP}"/>
<property name="source" value="${basedir}"/>
<property name="source.src" value="${basedir}/src"/>
<property name="source.src.java" value="${source.src}/java"/>
<property name="source.src.test" value="${source.src}/test"/>
<property name="source.doc" value="${basedir}/doc"/>
<property name="dest" value="${basedir}/dist"/>
<property name="dest.classes" value="${dest}/classes"/>
<property name="dest.doc" value="${dest}/docs"/>
<property name="dest.doc.api" value="${dest.doc}/api"/>
<property name="dest.jardir" value="${dest}"/>
<property name="dest.jardir.jar" value="${dest.jardir}/${name}.jar"/>
<property name="bin.name" value="${name}-${component.version}"/>
<property name="dest.bin.tar" value="${dest}/${bin.name}.tar"/>
<property name="dest.bin.tar.gz" value="${dest}/${bin.name}.tar.gz"/>
<property name="dest.bin.zip" value="${dest}/${bin.name}.zip"/>
<property name="src.name" value="${bin.name}-src"/>
<property name="dest.src.tar" value="${dest}/${src.name}.tar"/>
<property name="dest.src.tar.gz" value="${dest}/${src.name}.tar.gz"/>
<property name="dest.src.zip" value="${dest}/${src.name}.zip"/>
<patternset id="patternset-exclude-distros">
<exclude name="**/${bin.name}.tar.gz"/>
<exclude name="**/${bin.name}.zip"/>
<exclude name="**/${src.name}.tar.gz"/>
<exclude name="**/${src.name}.zip"/>
</patternset>
<!-- set the cvs.root property in the build.properties file -->
<property name="cvs.tag" value="COLLECTIONS_2_0"/>
<available property="available-doc" file="${source.doc}"/> <!-- does this module have docs? -->
<available property="available-src-java" file="${source.src.java}"/> <!-- does this module have java src? -->
<available property="available-src-test" file="${source.src.test}"/> <!-- does this module have test src? -->
<!-- The directories for compilation targets -->
<property name="build.home" value="build"/>
<property name="build.conf" value="${build.home}/conf"/>
<property name="build.classes" value="${build.home}/classes"/>
<property name="build.tests" value="${build.home}/tests"/>
<property name="build.docs" value="${build.home}/docs/apidocs"/>
<property name="build.src" value="${build.home}/src-ide" />
<!-- The name/location of the jar file to build -->
<property name="final.name" value="${component.name}-${component.version}"/>
<property name="jar.name" value="${final.name}.jar"/>
<property name="build.jar.name" value="${build.home}/${jar.name}"/>
<!-- The name/location of the zip files to build -->
<property name="build.dist.bin" value="${build.home}/bin"/>
<property name="build.dist.bin.work" value="${build.dist.bin}/${component.name}-${component.version}"/>
<property name="build.dist.src" value="${build.home}/src"/>
<property name="build.dist.src.work" value="${build.dist.src}/${component.name}-${component.version}-src"/>
<property name="build.dist" value="${build.home}/dist"/>
<property name="build.bin.tar.name" value="${build.dist}/${component.name}-${component.version}.tar"/>
<property name="build.bin.gz.name" value="${build.dist}/${component.name}-${component.version}.tar.gz"/>
<property name="build.bin.zip.name" value="${build.dist}/${component.name}-${component.version}.zip"/>
<property name="build.src.tar.name" value="${build.dist}/${component.name}-${component.version}-src.tar"/>
<property name="build.src.gz.name" value="${build.dist}/${component.name}-${component.version}-src.tar.gz"/>
<property name="build.src.zip.name" value="${build.dist}/${component.name}-${component.version}-src.zip"/>
<property name="dist.home" value="dist"/> <!-- for nightly builds -->
</target>
<!-- ######################################################### -->
<!-- ========== Settings ================================================== -->
<target name="copy-javadoc-source" depends="init" if="available-src-java">
<mkdir dir="${javadoc-source-dir}"/>
<copy todir="${javadoc-source-dir}" filtering="no">
<fileset dir="${source.src.java}">
<patternset refid="patternset-javadocable-sources"/>
</fileset>
</copy>
</target>
<!-- Javac -->
<property name="compile.debug" value="true"/>
<property name="compile.deprecation" value="true"/>
<property name="compile.optimize" value="false"/>
<target name="copy-doc" depends="init" if="available-doc">
<mkdir dir="${doc-source-dir}/${name}"/>
<copy todir="${doc-source-dir}/${name}" filtering="no">
<fileset dir="${source.doc}">
<patternset refid="patternset-doc"/>
</fileset>
</copy>
</target>
<!-- Javadoc -->
<property name="javadoc.access" value="protected"/>
<property name="javadoc.links" value="http://java.sun.com/j2se/1.3/docs/api/"/>
<!-- ######################################################### -->
<!-- JUnit -->
<property name="test.failonerror" value="true"/>
<target name="clean" depends="init" description="removes generated files">
<delete dir="${dest}"/>
</target>
<!-- Maven -->
<property name="maven.repo" value="${user.home}/.maven/repository" />
<target name="clean-doc" depends="init,clean-javadoc">
<delete dir="${dest.doc}"/>
</target>
<target name="clean-javadoc" depends="init">
<delete dir="${dest.doc.api}"/>
</target>
<!-- ====================================================================== -->
<!-- ========== Executable Targets ======================================== -->
<!-- ====================================================================== -->
<target name="clean-build" depends="init">
<delete dir="${dest.classes}"/>
</target>
<target name="clean"
description="Clean build and distribution directories">
<delete dir="${build.home}"/>
</target>
<target name="clean-dist" depends="init">
<delete file="${dest.jardir.jar}"/>
</target>
<!-- ====================================================================== -->
<!-- ######################################################### -->
<target name="init"
description="Initialize and evaluate conditionals">
<echo message="-------- ${component.name} ${component.version} --------"/>
</target>
<target name="doc" depends="init,doc-top,doc-copy,doc-javadoc" description="generates javadocs and other documentation">
</target>
<!-- ====================================================================== -->
<target name="doc-top" depends="init">
<mkdir dir="${dest}"/>
<copy todir="${dest}" file="./LICENSE.txt"/>
<copy todir="${dest}" file="${doc.status}"/>
<copy todir="${dest}" file="${doc.release.notes}"/>
</target>
<target name="prepare" depends="init"
description="Prepare build directory">
<mkdir dir="${build.home}"/>
</target>
<target name="doc-copy" depends="init" if="available-doc">
<mkdir dir="${dest.doc}"/>
<copy todir="${dest.doc}">
<fileset dir="${source.doc}">
<patternset refid="patternset-doc"/>
</fileset>
</copy>
</target>
<!-- ====================================================================== -->
<target name="doc-javadoc" depends="init" if="available-src-java">
<!-- copy all the non-test sources out to the work directory and javadoc that -->
<mkdir dir="${workdir}"/>
<copy todir="${workdir}">
<fileset dir="${source.src.java}">
<patternset refid="patternset-javadocable-sources"/>
</fileset>
</copy>
<mkdir dir="${dest.doc.api}"/>
<javadoc packagenames="org.*"
sourcepath="${workdir}"
destdir="${dest.doc.api}"
windowtitle="${Name-Long}"
doctitle="${Name-Long}"
bottom="&lt;small&gt;Copyright &amp;copy; 2001-2002 Apache Software Foundation. Documenation generated ${TODAY}&lt;/small&gt;."
protected="true"
version="true"
author="true"
overview="${source.src.java}/org/apache/commons/collections/package.html"
splitindex="false"
nodeprecated="true"
nodeprecatedlist="true"
notree="true"
noindex="false"
nohelp="true"
nonavbar="false"
serialwarn="false">
<group title="Jakarta-commons Collections" packages="org.apache.commons.collections"/>
<link href="http://java.sun.com/products/jdk/1.3/docs/api"/>
</javadoc>
<delete dir="${workdir}"/>
</target>
<target name="compile" depends="prepare"
description="Compile main code">
<mkdir dir="${build.classes}"/>
<javac srcdir="${source.java}"
destdir="${build.classes}"
debug="${compile.debug}"
deprecation="${compile.deprecation}"
optimize="${compile.optimize}">
</javac>
</target>
<!-- ######################################################### -->
<!-- ====================================================================== -->
<target name="build" depends="init,build-java" description="compiles source files"/>
<target name="build-java" depends="init" if="available-src-java">
<mkdir dir="${dest.classes}"/>
<javac destdir="${dest.classes}"
srcdir="${source.src.java}"
classpath="${classpath}"
debug="false"
deprecation="true"
optimize="true"/>
</target>
<target name="build-test" depends="init,build-java" if="available-src-test">
<mkdir dir="${dest.classes}"/>
<javac destdir="${dest.classes}"
srcdir="${source.src.test}"
classpath="${classpath}"
debug="false"
deprecation="true"
optimize="true"/>
</target>
<!-- ######################################################### -->
<target name="test" depends="build-test" if="test.entry" description="runs (junit) unit tests">
<!--
<junit printsummary="yes" fork="on" haltonfailure="yes">
<formatter type="plain" usefile="false"/>
<test name="${test.entry}"/>
<classpath>
<pathelement location="${dest.classes}" />
<pathelement path="${classpath}" />
<pathelement path="${java.class.path}" />
</classpath>
</junit>
-->
<java classname="${test.runner}" fork="yes" failonerror="${test.failonerror}">
<arg value="${test.entry}"/>
<classpath>
<pathelement location="${dest.classes}" />
<pathelement path="${classpath}" />
<pathelement path="${java.class.path}" />
</classpath>
</java>
</target>
<!-- ######################################################### -->
<target name="dist" depends="dist-jar,doc,dist-tar,dist-zip" description="builds binary distribution"/>
<target name="dist-jar" depends="build">
<mkdir dir="${dest.jardir}"/>
<mkdir dir="${workdir}"/>
<copy todir="${workdir}">
<fileset dir="${dest.classes}">
<patternset refid="patternset-non-test-classes"/>
</fileset>
</copy>
<mkdir dir="${workdir}/META-INF"/>
<copy todir="${workdir}/META-INF" file="./LICENSE.txt"/>
<jar jarfile="${dest.jardir.jar}" manifest="${source.src}/conf/MANIFEST.MF">
<fileset dir="${workdir}"/>
</jar>
<delete dir="${workdir}"/>
<delete dir="${dest.classes}"/>
</target>
<target name="dist-tar" depends="dist-jar,doc">
<mkdir dir="${workdir}/${bin.name}"/>
<copy todir="${workdir}/${bin.name}">
<fileset dir="${dest}">
<patternset refid="patternset-exclude-distros"/>
</fileset>
</copy>
<!-- create tar.gz -->
<tar longfile="gnu" tarfile="${dest.bin.tar}">
<tarfileset dir="${workdir}"/>
</tar>
<gzip zipfile="${dest.bin.tar.gz}"
src="${dest.bin.tar}">
</gzip>
<delete file="${dest.bin.tar}" />
<delete dir="${workdir}"/>
</target>
<target name="dist-zip" depends="dist-jar,doc">
<mkdir dir="${workdir}/${bin.name}"/>
<copy todir="${workdir}/${bin.name}">
<fileset dir="${dest}">
<patternset refid="patternset-exclude-distros"/>
</fileset>
</copy>
<!-- create a zip file -->
<zip zipfile="${dest.bin.zip}" >
<zipfileset dir="${workdir}" />
</zip>
<delete dir="${workdir}"/>
</target>
<!-- ######################################################### -->
<target name="dist-src" depends="init">
<!-- not executed in default dist, because it is configuration-rich
and requires an active network connection -->
<mkdir dir="${workdir}"/>
<mkdir dir="${dest.jardir}"/>
<cvs dest="${workdir}" cvsRoot="${cvs.root}"
package="jakarta-commons" tag="${cvs.tag}"/>
<move toDir="${workdir}/${src.name}">
<fileset dir="${workdir}/jakarta-commons/collections"/>
</move>
<delete dir="${workdir}/jakarta-commons"/>
<copy file="./LICENSE.txt" toDir="${workdir}/${src.name}"/>
<!-- create tar.gz -->
<tar longfile="gnu" tarfile="${dest.src.tar}">
<tarfileset dir="${workdir}"/>
</tar>
<gzip zipfile="${dest.src.tar.gz}"
src="${dest.src.tar}">
</gzip>
<delete file="${dest.src.tar}" />
<!-- create a zip file -->
<zip zipfile="${dest.src.zip}" >
<zipfileset dir="${workdir}" />
</zip>
<target name="jar" depends="compile"
description="Create jar">
<mkdir dir="${build.classes}/META-INF"/>
<copy file="LICENSE.txt"
tofile="${build.classes}/META-INF/LICENSE.txt"/>
<copy file="NOTICE.txt"
tofile="${build.classes}/META-INF/NOTICE.txt"/>
<delete dir="${workdir}"/>
<tstamp/>
<mkdir dir="${build.conf}"/>
<copy todir="${build.conf}" filtering="on">
<filterset>
<filter token="name" value="${component.name}"/>
<filter token="title" value="${component.title}"/>
<filter token="package" value="${component.package}"/>
<filter token="version" value="${component.version}"/>
</filterset>
<fileset dir="${source.conf}" includes="*.MF"/>
</copy>
<!-- NOTE: A jar built using JDK1.4 is incompatible with JDK1.2 -->
<jar jarfile="${build.jar.name}"
basedir="${build.classes}"
manifest="${build.conf}/MANIFEST.MF"/>
</target>
<!-- ====================================================================== -->
<!-- Targets you might use to get smaller jar files - not recommended -->
<target name="splitjar" depends="jar"
description="Create split jar">
<jar jarfile="${build.home}/${component.name}-bag-${component.version}.jar"
basedir="${build.classes}"
manifest="${build.conf}/MANIFEST.MF">
<include name="**/META-INF/*"/>
<include name="**/BagUtils*.class"/>
<include name="**/bag/*.class"/>
</jar>
<jar jarfile="${build.home}/${component.name}-bidimap-${component.version}.jar"
basedir="${build.classes}"
manifest="${build.conf}/MANIFEST.MF">
<include name="**/META-INF/*"/>
<include name="**/bidimap/*.class"/>
</jar>
<jar jarfile="${build.home}/${component.name}-buffer-${component.version}.jar"
basedir="${build.classes}"
manifest="${build.conf}/MANIFEST.MF">
<include name="**/META-INF/*"/>
<include name="**/BufferUtils*.class"/>
<include name="**/buffer/*.class"/>
</jar>
<jar jarfile="${build.home}/${component.name}-functors-${component.version}.jar"
basedir="${build.classes}"
manifest="${build.conf}/MANIFEST.MF">
<include name="**/META-INF/*"/>
<include name="**/ClosureUtils*.class"/>
<include name="**/FactoryUtils*.class"/>
<include name="**/PredicateUtils*.class"/>
<include name="**/TransformerUtils*.class"/>
<include name="**/functors/*.class"/>
</jar>
<jar jarfile="${build.home}/${component.name}-core-${component.version}.jar"
basedir="${build.classes}"
manifest="${build.conf}/MANIFEST.MF">
<include name="**/META-INF/*"/>
<include name="**/*"/>
<exclude name="**/BagUtils*.class"/>
<exclude name="**/BufferUtils*.class"/>
<exclude name="**/ClosureUtils*.class"/>
<exclude name="**/FactoryUtils*.class"/>
<exclude name="**/PredicateUtils*.class"/>
<exclude name="**/TransformerUtils*.class"/>
<exclude name="**/bag/*.class"/>
<exclude name="**/bidimap/*.class"/>
<exclude name="**/buffer/*.class"/>
<exclude name="**/functors/*.class"/>
<exclude name="**/iterators/ProxyIterator*.class"/>
<exclude name="**/iterators/ProxyListIterator*.class"/>
<exclude name="**/map/*.class"/>
<exclude name="org/apache/commons/collections/BeanMap*.class"/>
<exclude name="org/apache/commons/collections/BinaryHeap*.class"/>
<exclude name="org/apache/commons/collections/BoundedFifoBuffer*.class"/>
<exclude name="org/apache/commons/collections/CursorableLinkedList*.class"/>
<exclude name="org/apache/commons/collections/CursorableSubList*.class"/>
<exclude name="org/apache/commons/collections/DefaultMapBag*.class"/>
<exclude name="org/apache/commons/collections/DefaultMapEntry*.class"/>
<exclude name="org/apache/commons/collections/DoubleOrderedMap*.class"/>
<exclude name="org/apache/commons/collections/HashBag*.class"/>
<exclude name="org/apache/commons/collections/LRUMap*.class"/>
<exclude name="org/apache/commons/collections/MultiHashMap*.class"/>
<exclude name="org/apache/commons/collections/PriorityQueue*.class"/>
<exclude name="org/apache/commons/collections/ProxyMap*.class"/>
<exclude name="org/apache/commons/collections/ReferenceMap*.class"/>
<exclude name="org/apache/commons/collections/SequencedHashMap*.class"/>
<exclude name="org/apache/commons/collections/StaticBucketMap*.class"/>
<exclude name="org/apache/commons/collections/SynchronizedPriorityQueue*.class"/>
<exclude name="org/apache/commons/collections/TreeBag*.class"/>
<exclude name="org/apache/commons/collections/UnboundedFifoBuffer*.class"/>
</jar>
<jar jarfile="${build.home}/${component.name}-deprecated-${component.version}.jar"
basedir="${build.classes}"
manifest="${build.conf}/MANIFEST.MF">
<include name="**/META-INF/*"/>
<include name="**/iterators/ProxyIterator*.class"/>
<include name="**/iterators/ProxyListIterator*.class"/>
<include name="org/apache/commons/collections/BeanMap*.class"/>
<include name="org/apache/commons/collections/BinaryHeap*.class"/>
<include name="org/apache/commons/collections/BoundedFifoBuffer*.class"/>
<include name="org/apache/commons/collections/CursorableLinkedList*.class"/>
<include name="org/apache/commons/collections/CursorableSubList*.class"/>
<include name="org/apache/commons/collections/DefaultMapBag*.class"/>
<include name="org/apache/commons/collections/DefaultMapEntry*.class"/>
<include name="org/apache/commons/collections/DoubleOrderedMap*.class"/>
<include name="org/apache/commons/collections/HashBag*.class"/>
<include name="org/apache/commons/collections/LRUMap*.class"/>
<include name="org/apache/commons/collections/MultiHashMap*.class"/>
<include name="org/apache/commons/collections/PriorityQueue*.class"/>
<include name="org/apache/commons/collections/ProxyMap*.class"/>
<include name="org/apache/commons/collections/ReferenceMap*.class"/>
<include name="org/apache/commons/collections/SequencedHashMap*.class"/>
<include name="org/apache/commons/collections/StaticBucketMap*.class"/>
<include name="org/apache/commons/collections/SynchronizedPriorityQueue*.class"/>
<include name="org/apache/commons/collections/TreeBag*.class"/>
<include name="org/apache/commons/collections/UnboundedFifoBuffer*.class"/>
</jar>
</target>
<!-- ====================================================================== -->
<target name="compile.tests" depends="compile"
description="Compile unit test cases">
<mkdir dir="${build.tests}"/>
<javac srcdir="${source.test}"
destdir="${build.tests}"
debug="true"
deprecation="false"
optimize="false">
<classpath>
<pathelement location="${build.classes}"/>
<pathelement location="${junit.jar}"/>
</classpath>
</javac>
</target>
<!-- ====================================================================== -->
<!-- Tests collections, either running all or one test -->
<target name="test" depends="-test-all,-test-single"
description="Run unit tests" />
<!-- Runs all tests -->
<target name="-test-all" depends="compile.tests" unless="testcase">
<junit printsummary="yes" haltonfailure="yes" showoutput="yes">
<formatter type="brief" />
<classpath>
<pathelement location="${build.classes}"/>
<pathelement location="${build.tests}"/>
<pathelement location="${junit.jar}"/>
</classpath>
<batchtest fork="yes">
<fileset dir="${source.test}">
<include name="**/Test*.java"/>
<exclude name="**/TestAll*.java"/>
<exclude name="**/TestAbstract*"/>
<exclude name="**/TestArrayList.java"/>
<exclude name="**/TestLinkedList.java"/>
<exclude name="**/TestHashMap.java"/>
<exclude name="**/TestTreeMap.java"/>
<exclude name="**/TestTypedCollection.java"/>
</fileset>
<formatter type="brief" usefile="false" />
</batchtest>
</junit>
</target>
<!-- Runs a single test -->
<target name="-test-single" depends="compile.tests" if="testcase">
<junit printsummary="yes" haltonfailure="yes" showoutput="yes">
<formatter type="brief" />
<classpath>
<pathelement location="${build.classes}"/>
<pathelement location="${build.tests}"/>
<pathelement location="${junit.jar}"/>
</classpath>
<test name="${testcase}" fork="yes">
<formatter type="brief" usefile="false" />
</test>
</junit>
</target>
<!-- ====================================================================== -->
<target name="testjar" depends="compile.tests,jar"
description="Run all unit test cases">
<echo message="Running collections tests against built jar ..."/>
<junit printsummary="yes" haltonfailure="yes">
<classpath>
<pathelement location="${build.jar.name}"/>
<pathelement location="${build.tests}"/>
<pathelement location="${junit.jar}"/>
</classpath>
<batchtest fork="yes">
<fileset dir="${source.test}">
<include name="**/TestAllPackages.java"/>
</fileset>
<formatter type="brief" usefile="false" />
</batchtest>
</junit>
</target>
<!-- ====================================================================== -->
<target name="javadoc" depends="prepare"
description="Create component Javadoc documentation">
<tstamp><format property="year" pattern="yyyy"/></tstamp>
<delete dir="${build.docs}"/>
<mkdir dir="${build.docs}"/>
<javadoc sourcepath="${source.java}"
destdir="${build.docs}"
packagenames="${component.package}.*"
access="${javadoc.access}"
author="true"
version="true"
use="true"
link="${javadoc.links}"
overview="${source.java}/org/apache/commons/collections/overview.html"
doctitle="${component.title} ${component.version} API;"
windowtitle="${component.title} ${component.version} API"
bottom="Copyright &amp;copy; 2001-${year} Apache Software Foundation. All Rights Reserved.">
</javadoc>
</target>
<!-- ====================================================================== -->
<!-- ========== Test framework ============================================ -->
<!-- ====================================================================== -->
</target>
<property name="tf.name" value="commons-collections-testframework"/>
<property name="tf.package" value="org.apache.commons.collections"/>
<property name="tf.title" value="Commons Collections Test Framework"/>
<property name="tf.title.full" value="Apache Jakarta Commons Collections Test Framework"/>
<property name="tf.version" value="${component.version}"/>
<property name="tf.build.conf" value="${build.home}/tfconf"/>
<property name="tf.build.tf" value="${build.home}/testframework"/>
<property name="tf.build.docs" value="${build.home}/docs/testframework"/>
<property name="tf.jar.name" value="${tf.name}-${tf.version}.jar"/>
<property name="tf.build.jar.name" value="${build.home}/${tf.jar.name}"/>
<!-- ====================================================================== -->
<!-- patternset describing test framework source not dependent on collections jar -->
<patternset id="tf.patternset.validate">
<include name="**/AbstractTestObject.java"/>
<include name="**/AbstractTestCollection.java"/>
<include name="**/AbstractTestSet.java"/>
<include name="**/AbstractTestSortedSet.java"/>
<include name="**/AbstractTestList.java"/>
<include name="**/AbstractTestMap.java"/>
<include name="**/AbstractTestSortedMap.java"/>
<include name="**/AbstractTestComparator.java"/>
<include name="**/AbstractTestIterator.java"/>
<include name="**/AbstractTestListIterator.java"/>
<include name="**/AbstractTestMapEntry.java"/>
<include name="**/BulkTest.java"/>
</patternset>
<target name="tf.validate" depends="prepare"
description="Testframework - Validate testframework independence">
<delete dir="${tf.build.tf}"/>
<mkdir dir="${tf.build.tf}"/>
<javac srcdir="${source.test}"
destdir="${tf.build.tf}"
debug="true"
deprecation="false"
optimize="false">
<patternset refid="tf.patternset.validate" />
<classpath>
<pathelement location="${junit.jar}"/>
</classpath>
</javac>
<delete dir="${tf.build.tf}"/>
</target>
<!-- ====================================================================== -->
<target name="tf.jar" depends="compile.tests"
description="Testframework - Create jar">
<mkdir dir="${tf.build.tf}"/>
<copy todir="${tf.build.tf}">
<fileset dir="${build.tests}">
<include name="**/AbstractTest*.class"/>
<include name="**/BulkTest*.class"/>
</fileset>
</copy>
<mkdir dir="${tf.build.tf}/META-INF"/>
<copy file="LICENSE.txt"
tofile="${tf.build.tf}/META-INF/LICENSE.txt"/>
<copy file="NOTICE.txt"
tofile="${tf.build.tf}/META-INF/NOTICE.txt"/>
<tstamp/>
<mkdir dir="${tf.build.conf}"/>
<copy todir="${tf.build.conf}" filtering="on">
<filterset>
<filter token="name" value="${tf.name}"/>
<filter token="title" value="${tf.title}"/>
<filter token="package" value="${tf.package}"/>
<filter token="version" value="${tf.version}"/>
</filterset>
<fileset dir="${source.conf}" includes="*.MF"/>
</copy>
<!-- NOTE: A jar built using JDK1.4 is incompatible with JDK1.2 -->
<jar jarfile="${tf.build.jar.name}"
basedir="${tf.build.tf}"
manifest="${tf.build.conf}/MANIFEST.MF"/>
</target>
<!-- ====================================================================== -->
<target name="tf.javadoc" depends="prepare"
description="Testframework - Create Javadoc documentation">
<tstamp><format property="year" pattern="yyyy"/></tstamp>
<delete dir="${tf.build.docs}"/>
<mkdir dir="${tf.build.docs}"/>
<javadoc destdir="${tf.build.docs}"
access="protected"
author="false"
version="false"
link="${javadoc.links}"
overview="${source.test}/org/apache/commons/collections/overview.html"
doctitle="${tf.title} ${tf.version} API;"
windowtitle="${tf.title} ${tf.version} API"
bottom="Copyright &amp;copy; 2001-${year} Apache Software Foundation. All Rights Reserved.">
<fileset dir="${source.test}">
<include name="**/AbstractTest*.java"/>
<include name="**/BulkTest*.java"/>
</fileset>
</javadoc>
</target>
<!-- ====================================================================== -->
<!-- ========== Distributions ============================================= -->
<!-- ====================================================================== -->
<!-- ====================================================================== -->
<!-- Target needed for nightly builds -->
<target name="dist" depends="javadoc,dist.create"
description="Create distribution folders">
<delete dir="${dist.home}"/>
<mkdir dir="${dist.home}" />
<copy todir="${dist.home}">
<fileset dir="${build.dist.bin}" />
</copy>
</target>
<target name="dist.create" depends="jar,testjar,tf.validate,tf.jar,dist.bin,dist.src">
</target>
<target name="dist.bin">
<copy todir="${build.src}">
<fileset dir="${basedir}/src/java" includes="**/*.java" />
</copy>
<copy todir="${build.src}/META-INF">
<fileset dir="${basedir}" includes="LICENSE*, NOTICE*" />
</copy>
<jar jarfile="${build.home}/${final.name}-src-ide.zip" basedir="${build.src}" />
<antcall target="internal-md5">
<param name="path" value="${build.home}/${final.name}.jar"/>
</antcall>
<mkdir dir="${build.dist.bin.work}"/>
<copy todir="${build.dist.bin.work}">
<fileset dir=".">
<include name="LICENSE.txt"/>
<include name="NOTICE.txt"/>
<include name="README.txt"/>
<include name="RELEASE-NOTES.html"/>
</fileset>
</copy>
<copy todir="${build.dist.bin.work}">
<fileset dir="${build.home}">
<include name="*.jar"/>
<include name="docs/**"/>
</fileset>
</copy>
</target>
<target name="dist.src">
<mkdir dir="${build.dist.src.work}"/>
<copy todir="${build.dist.src.work}">
<fileset dir=".">
<include name="LICENSE.txt"/>
<include name="NOTICE.txt"/>
<include name="README.txt"/>
<include name="RELEASE-NOTES.html"/>
<include name="DEVELOPERS-GUIDE.html"/>
<include name="PROPOSAL.html"/>
<include name="STATUS.html"/>
<include name="build.xml"/>
<include name="maven.xml"/>
<include name="project.xml"/>
<include name="project.properties"/>
</fileset>
</copy>
<copy todir="${build.dist.src.work}">
<fileset dir="${build.home}">
<include name="${final.name}.jar"/>
</fileset>
</copy>
<copy todir="${build.dist.src.work}">
<fileset dir=".">
<include name="data/**"/>
<include name="src/**"/>
<include name="xdocs/**"/>
</fileset>
</copy>
</target>
<!-- ====================================================================== -->
<target name="release" depends="dist.create,zip"
description="Create release">
<!-- POM -->
<copy file="project.xml" tofile="${build.home}/${final.name}.pom" />
<antcall target="internal-md5">
<param name="path" value="${build.home}/${final.name}.pom"/>
</antcall>
</target>
<target name="zip" depends="zip.bin,zip.src">
</target>
<target name="zip.bin">
<mkdir dir="${build.dist}"/>
<fixcrlf srcdir="${build.dist.bin.work}" eol="lf" includes="*.txt" />
<tar longfile="gnu" tarfile="${build.bin.tar.name}">
<tarfileset dir="${build.dist.bin}"/>
</tar>
<gzip zipfile="${build.bin.gz.name}" src="${build.bin.tar.name}"/>
<delete file="${build.bin.tar.name}" />
<antcall target="internal-md5">
<param name="path" value="${build.bin.gz.name}"/>
</antcall>
<fixcrlf srcdir="${build.dist.bin.work}" eol="crlf" includes="*.txt" />
<zip zipfile="${build.bin.zip.name}" >
<zipfileset dir="${build.dist.bin}"/>
</zip>
<antcall target="internal-md5">
<param name="path" value="${build.bin.zip.name}"/>
</antcall>
</target>
<target name="zip.src">
<mkdir dir="${build.dist}"/>
<fixcrlf srcdir="${build.dist.src.work}" eol="lf" includes="*.txt,*.properties" />
<tar longfile="gnu" tarfile="${build.src.tar.name}">
<tarfileset dir="${build.dist.src}"/>
</tar>
<gzip zipfile="${build.src.gz.name}" src="${build.src.tar.name}"/>
<delete file="${build.src.tar.name}" />
<antcall target="internal-md5">
<param name="path" value="${build.src.gz.name}"/>
</antcall>
<fixcrlf srcdir="${build.dist.src.work}" eol="crlf" includes="*.txt,*.properties" />
<zip zipfile="${build.src.zip.name}" >
<zipfileset dir="${build.dist.src}"/>
</zip>
<antcall target="internal-md5">
<param name="path" value="${build.src.zip.name}"/>
</antcall>
</target>
<target name="internal-md5">
<basename property="_base" file="${path}"/>
<checksum file="${path}" property="md5"/>
<echo message="${md5} *${_base}" file="${path}.md5"/>
</target>
<!-- ====================================================================== -->
<target name="clirr">
<taskdef resource="clirrtask.properties">
<classpath path="${maven.repo}/clirr/jars/clirr-core-0.6-uber.jar;" />
</taskdef>
<clirr>
<origfiles dir="${maven.repo}/commons-collections/jars" includes="commons-collections-3.1.jar"/>
<newfiles dir="${build.home}" includes="${final.name}.jar" />
<formatter type="plain" outfile="${build.home}/clirr.txt" />
</clirr>
</target>
</project>

BIN
data/test/BlockingBuffer.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/BlockingBuffer.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/BooleanComparator.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/BoundedBuffer.emptyCollection.version3.2.obj Normal file
View File

Binary file not shown.

BIN
data/test/BoundedBuffer.fullCollection.version3.2.obj Normal file
View File

Binary file not shown.

BIN
data/test/BoundedFifoBuffer.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/BoundedFifoBuffer.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/CaseInsensitiveMap.emptyCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/CaseInsensitiveMap.fullCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/CircularFifoBuffer.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/CircularFifoBuffer.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/DefaultedMap.emptyCollection.version3.2.obj Normal file
View File

Binary file not shown.

BIN
data/test/DefaultedMap.fullCollection.version3.2.obj Normal file
View File

Binary file not shown.

BIN
data/test/DualHashBidiMap.emptyCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/DualHashBidiMap.fullCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/DualTreeBidiMap.emptyCollection.version3.Test2.obj Normal file
View File

Binary file not shown.

BIN
data/test/DualTreeBidiMap.emptyCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/DualTreeBidiMap.fullCollection.version3.Test2.obj Normal file
View File

Binary file not shown.

BIN
data/test/DualTreeBidiMap.fullCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/FixedSizeList.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/FixedSizeList.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/FixedSizeMap.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/FixedSizeMap.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/FixedSizeSortedMap.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/FixedSizeSortedMap.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/Flat3Map.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/Flat3Map.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/GrowthList.emptyCollection.version3.2.obj Normal file
View File

Binary file not shown.

BIN
data/test/GrowthList.fullCollection.version3.2.obj Normal file
View File

Binary file not shown.

BIN
data/test/HashBag.emptyCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/HashBag.fullCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/HashedMap.emptyCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/HashedMap.fullCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/IdentityMap.emptyCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/IdentityMap.fullCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/LRUMap.emptyCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/LRUMap.fullCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/LazyMap.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/LazyMap.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/LazySortedMap.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/LazySortedMap.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/LinkedMap.emptyCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/LinkedMap.fullCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/ListOrderedMap.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/ListOrderedMap.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/ListOrderedSet.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/ListOrderedSet.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/MapBackedSet.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/MapBackedSet.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/MultiKeyMap.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/MultiKeyMap.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/NodeCachingLinkedList.emptyCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/NodeCachingLinkedList.fullCollection.version3.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedBag.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedBag.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedBuffer.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedBuffer.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedCollection.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedCollection.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedList.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedList.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedMap.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedMap.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedSet.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedSet.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedSortedBag.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedSortedBag.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedSortedMap.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedSortedMap.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedSortedSet.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PredicatedSortedSet.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/PriorityBuffer.emptyCollection.version3.2.obj Normal file
View File

Binary file not shown.

BIN
data/test/PriorityBuffer.fullCollection.version3.2.obj Normal file
View File

Binary file not shown.

BIN
data/test/ReferenceIdentityMap.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/ReferenceIdentityMap.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/ReferenceMap.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/ReferenceMap.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/SetUniqueList.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/SetUniqueList.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/SingletonMap.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/SingletonMap.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/SynchronizedBuffer.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/SynchronizedBuffer.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/SynchronizedCollection.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/SynchronizedCollection.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/SynchronizedList.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/SynchronizedList.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/SynchronizedSet.emptyCollection.version3.1.obj Normal file
View File

Binary file not shown.

BIN
data/test/SynchronizedSet.fullCollection.version3.1.obj Normal file
View File

Binary file not shown.

Some files were not shown because too many files have changed in this diff Show More