mirror of
https://github.com/apache/commons-collections.git
synced 2025-03-08 17:59:22 +00:00
Port Jakarta-->Commons TLP changes to JDK5 branch
git-svn-id: https://svn.apache.org/repos/asf/commons/proper/collections/branches/collections_jdk5_branch@595918 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Niall Kegan Pemberton
parent
3ec2bc2604
commit
7e56206228
@ -16,13 +16,13 @@ limitations under the License.
|
||||
-->
|
||||
<html>
|
||||
<head>
|
||||
<title>Developers guide for Jakarta Commons "Collections" Package</title>
|
||||
<title>Developers guide for Apache Commons "Collections" Package</title>
|
||||
</head>
|
||||
<body bgcolor="white">
|
||||
|
||||
|
||||
<div align="center">
|
||||
<h1>The Jakarta Commons <em>Collections</em> Package</h1>
|
||||
<h1>The Apache Commons <em>Collections</em> Package</h1>
|
||||
<h2>Developers Guide</h2>
|
||||
$Id$<br />
|
||||
<a href="#Introduction">[Introduction]</a>
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
Jakarta Commons Collections
|
||||
Apache Commons Collections
|
||||
===========================
|
||||
|
||||
Welcome to the Collections component of the Jakarta Commons project.
|
||||
Welcome to the Collections component of the Apache Commons project.
|
||||
This component contains many new collections and collection utilities.
|
||||
|
||||
Two jar files are produced by this component.
|
||||
|
||||
@ -16,13 +16,13 @@ limitations under the License.
|
||||
-->
|
||||
<html>
|
||||
<head>
|
||||
<title>Status File for Jakarta Commons "Collections" Package</title>
|
||||
<title>Status File for Apache Commons "Collections" Package</title>
|
||||
<head>
|
||||
<body bgcolor="white">
|
||||
|
||||
|
||||
<div align="center">
|
||||
<h1>The Jakarta Commons <em>Collections</em> Package</h1>
|
||||
<h1>The Apache Commons <em>Collections</em> Package</h1>
|
||||
$Id$<br>
|
||||
<a href="#Introduction">[Introduction]</a>
|
||||
<a href="#Dependencies">[Dependencies]</a>
|
||||
|
||||
@ -41,7 +41,7 @@ limitations under the License.
|
||||
<property name="component.title" value="Commons Collections"/>
|
||||
|
||||
<!-- The full title of this component -->
|
||||
<property name="component.title.full" value="Apache Jakarta Commons Collections"/>
|
||||
<property name="component.title.full" value="Apache Commons Collections"/>
|
||||
|
||||
<!-- The current version number of this component -->
|
||||
<property name="component.version" value="3.3-SNAPSHOT"/>
|
||||
@ -438,7 +438,7 @@ limitations under the License.
|
||||
<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.title.full" value="Apache Commons Collections Test Framework"/>
|
||||
<property name="tf.version" value="${component.version}"/>
|
||||
|
||||
<property name="tf.build.conf" value="${build.home}/tfconf"/>
|
||||
|
||||
@ -1,55 +1,55 @@
|
||||
<?xml version="1.0"?>
|
||||
<!--
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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.
|
||||
-->
|
||||
<rdf:RDF xmlns="http://usefulinc.com/ns/doap#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:asfext="http://projects.apache.org/ns/asfext#" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#" xmlns:doap="http://usefulinc.com/ns/doap#" xml:lang="en">
|
||||
<Project rdf:about="http://jakarta.apache.org/commons/collections/">
|
||||
<name>Apache Jakarta Commons Collections</name>
|
||||
<homepage rdf:resource="http://jakarta.apache.org/commons/collections/"/>
|
||||
<programming-language>Java</programming-language>
|
||||
<category rdf:resource="http://projects.apache.org/category/library"/>
|
||||
<license rdf:resource="http://usefulinc.com/doap/licenses/asl20"/>
|
||||
<bug-database rdf:resource="http://issues.apache.org/bugzilla/buglist.cgi?product=Commons&component=collections"/>
|
||||
<download-page rdf:resource="http://jakarta.apache.org/site/downloads/downloads_commons-collections.cgi"/>
|
||||
<asfext:pmc rdf:resource="http://jakarta.apache.org/"/>
|
||||
<shortdesc xml:lang="en">Commons Collections</shortdesc>
|
||||
<description xml:lang="en">Types that extend and augment the Java Collections Framework.</description>
|
||||
<repository>
|
||||
<SVNRepository>
|
||||
<browse rdf:resource="http://svn.apache.org/repos/asf/jakarta/commons/proper/collections/trunk"/>
|
||||
<location rdf:resource="http://svn.apache.org/repos/asf/jakarta/commons/proper/collections"/>
|
||||
</SVNRepository>
|
||||
</repository>
|
||||
<release>
|
||||
<revision>
|
||||
<name>commons-collections</name>
|
||||
<created>2006-05-14</created>
|
||||
<version>3.2</version>
|
||||
</revision>
|
||||
<revision>
|
||||
<name>commons-collections</name>
|
||||
<created>2004-06-23</created>
|
||||
<version>3.1</version>
|
||||
</revision>
|
||||
<revision>
|
||||
<name>commons-collections</name>
|
||||
<created>2004-06-23</created>
|
||||
<version>2.1.1</version>
|
||||
</revision>
|
||||
</release>
|
||||
<mailing-list rdf:resource="http://jakarta.apache.org/site/mail2.html#Commons"/>
|
||||
</Project>
|
||||
</rdf:RDF>
|
||||
<?xml version="1.0"?>
|
||||
<!--
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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.
|
||||
-->
|
||||
<rdf:RDF xmlns="http://usefulinc.com/ns/doap#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:asfext="http://projects.apache.org/ns/asfext#" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#" xmlns:doap="http://usefulinc.com/ns/doap#" xml:lang="en">
|
||||
<Project rdf:about="http://commons.apache.org/collections/">
|
||||
<name>Apache Commons Collections</name>
|
||||
<homepage rdf:resource="http://commons.apache.org/collections/"/>
|
||||
<programming-language>Java</programming-language>
|
||||
<category rdf:resource="http://projects.apache.org/category/library"/>
|
||||
<license rdf:resource="http://usefulinc.com/doap/licenses/asl20"/>
|
||||
<bug-database rdf:resource="http://issues.apache.org/jira/browse/COLLECTIONS"/>
|
||||
<download-page rdf:resource="http://jakarta.apache.org/site/downloads/downloads_commons-collections.cgi"/>
|
||||
<asfext:pmc rdf:resource="http://commons.apache.org/"/>
|
||||
<shortdesc xml:lang="en">Commons Collections</shortdesc>
|
||||
<description xml:lang="en">Types that extend and augment the Java Collections Framework.</description>
|
||||
<repository>
|
||||
<SVNRepository>
|
||||
<browse rdf:resource="http://svn.apache.org/repos/asf/commons/proper/collections/trunk"/>
|
||||
<location rdf:resource="http://svn.apache.org/repos/asf/commons/proper/collections"/>
|
||||
</SVNRepository>
|
||||
</repository>
|
||||
<release>
|
||||
<revision>
|
||||
<name>commons-collections</name>
|
||||
<created>2006-05-14</created>
|
||||
<version>3.2</version>
|
||||
</revision>
|
||||
<revision>
|
||||
<name>commons-collections</name>
|
||||
<created>2004-06-23</created>
|
||||
<version>3.1</version>
|
||||
</revision>
|
||||
<revision>
|
||||
<name>commons-collections</name>
|
||||
<created>2004-06-23</created>
|
||||
<version>2.1.1</version>
|
||||
</revision>
|
||||
</release>
|
||||
<mailing-list rdf:resource="http://commons.apache.org/mail-lists.html"/>
|
||||
</Project>
|
||||
</rdf:RDF>
|
||||
|
||||
@ -17,7 +17,7 @@ maven.changelog.factory=org.apache.maven.svnlib.SvnChangeLogFactory
|
||||
|
||||
maven.xdoc.date=left
|
||||
maven.xdoc.version=${pom.currentVersion}
|
||||
maven.xdoc.developmentProcessUrl=http://jakarta.apache.org/commons/charter.html
|
||||
maven.xdoc.developmentProcessUrl=http://commons.apache.org/charter.html
|
||||
maven.xdoc.poweredby.image=maven-feather.png
|
||||
maven.xdoc.copy.excludes=images/file.gif,images/folder-closed.gif,images/folder-open.gif,images/icon_alert.gif,images/icon_alertsml.gif,images/icon_arrowfolder1_sml.gif,images/icon_arrowfolder2_sml.gif,images/icon_arrowmembers1_sml.gif,images/icon_arrowmembers2_sml.gif,images/icon_arrowusergroups1_sml.gif,images/icon_arrowusergroups2_sml.gif,images/icon_confirmsml.gif,images/icon_help_lrg.gif,images/icon_infosml.gif,images/icon_members_sml.gif,images/icon_sortleft.gif,images/icon_sortright.gif,images/icon_usergroups_sml.gif,images/icon_waste_lrg.gif,images/icon_waste_sml.gif,images/none.png,images/nw_maj.gif,images/nw_maj_hi.gif,images/nw_med.gif,images/nw_med_hi.gif,images/nw_med_rond.gif,images/nw_min.gif,images/nw_min_036.gif,images/nw_min_hi.gif,images/poweredby_036.gif,images/product_logo.gif,images/se_maj_rond.gif,images/sw_min.gif,images/logos/**
|
||||
maven.xdoc.copy.excludes.classic=images/external-classic.png,images/help_logo.gif,images/icon_arrowfolderclosed1_sml.gif,images/icon_arrowwaste1_sml.gif,images/icon_arrowwaste2_sml.gif,images/icon_doc_lrg.gif,images/icon_doc_sml.gif,images/icon_error_lrg.gif,images/icon_folder_lrg.gif,images/icon_folder_sml.gif,images/icon_help_sml.gif,images/icon_info_lrg.gif,images/icon_members_lrg.gif,images/icon_sortdown.gif,images/icon_sortup.gif,images/icon_success_lrg.gif,images/icon_usergroups_lrg.gif,images/icon_arrowfolderopen2_sml.gif,images/icon_warning_lrg.gif,images/newwindow-classic.png,images/nw_maj_rond.gif,images/strich.gif,images/sw_maj_rond.gif,images/sw_med_rond.gif
|
||||
|
||||
30
project.xml
30
project.xml
@ -26,13 +26,13 @@ limitations under the License.
|
||||
<description>Types that extend and augment the Java Collections Framework.</description>
|
||||
<logo>/images/logo.png</logo>
|
||||
|
||||
<url>http://jakarta.apache.org/commons/collections/</url>
|
||||
<url>http://commons.apache.org/collections/</url>
|
||||
<package>org.apache.commons.collections</package>
|
||||
|
||||
<organization>
|
||||
<name>The Apache Software Foundation</name>
|
||||
<url>http://jakarta.apache.org</url>
|
||||
<logo>http://jakarta.apache.org/images/original-jakarta-logo.gif</logo>
|
||||
<url>http://commons.apache.org/</url>
|
||||
<logo>http://commons.apache.org/images/logo.png</logo>
|
||||
</organization>
|
||||
|
||||
<licenses>
|
||||
@ -43,29 +43,29 @@ limitations under the License.
|
||||
</license>
|
||||
</licenses>
|
||||
|
||||
<gumpRepositoryId>jakarta</gumpRepositoryId>
|
||||
<gumpRepositoryId>commons</gumpRepositoryId>
|
||||
<issueTrackingUrl>http://issues.apache.org/jira/</issueTrackingUrl>
|
||||
<siteAddress>people.apache.org</siteAddress>
|
||||
<siteDirectory>/www/jakarta.apache.org/commons/collections/</siteDirectory>
|
||||
<distributionDirectory>/www/jakarta.apache.org/builds/jakarta-commons/collections/</distributionDirectory>
|
||||
<siteDirectory>/www/commons.apache.org/collections/</siteDirectory>
|
||||
<distributionDirectory>/www/people.apache.org/builds/commons/collections/</distributionDirectory>
|
||||
|
||||
<repository>
|
||||
<connection>scm:svn:http://svn.apache.org/repos/asf/jakarta/commons/proper/collections/trunk</connection>
|
||||
<url>http://svn.apache.org/repos/asf/jakarta/commons/proper/collections/trunk</url>
|
||||
<connection>scm:svn:http://svn.apache.org/repos/asf/commons/proper/collections/trunk</connection>
|
||||
<url>http://svn.apache.org/repos/asf/commons/proper/collections/trunk</url>
|
||||
</repository>
|
||||
|
||||
<mailingLists>
|
||||
<mailingList>
|
||||
<name>Commons Dev List</name>
|
||||
<subscribe>commons-dev-subscribe@jakarta.apache.org</subscribe>
|
||||
<unsubscribe>commons-dev-unsubscribe@jakarta.apache.org</unsubscribe>
|
||||
<archive>http://mail-archives.apache.org/eyebrowse/SummarizeList?listName=commons-dev@jakarta.apache.org</archive>
|
||||
<subscribe>dev-subscribe@commons.apache.org</subscribe>
|
||||
<unsubscribe>dev-unsubscribe@commons.apache.org</unsubscribe>
|
||||
<archive>http://mail-archives.apache.org/mod_mbox/commons-dev/</archive>
|
||||
</mailingList>
|
||||
<mailingList>
|
||||
<name>Commons User List</name>
|
||||
<subscribe>commons-user-subscribe@jakarta.apache.org</subscribe>
|
||||
<unsubscribe>commons-user-unsubscribe@jakarta.apache.org</unsubscribe>
|
||||
<archive>http://mail-archives.apache.org/eyebrowse/SummarizeList?listName=commons-user@jakarta.apache.org</archive>
|
||||
<subscribe>user-subscribe@commons.apache.org</subscribe>
|
||||
<unsubscribe>user-unsubscribe@commons.apache.org</unsubscribe>
|
||||
<archive>http://mail-archives.apache.org/mod_mbox/commons-user/</archive>
|
||||
</mailingList>
|
||||
</mailingLists>
|
||||
|
||||
@ -472,7 +472,7 @@ limitations under the License.
|
||||
</dependencies>
|
||||
|
||||
<build>
|
||||
<nagEmailAddress>commons-dev@jakarta.apache.org</nagEmailAddress>
|
||||
<nagEmailAddress>dev@commons.apache.org</nagEmailAddress>
|
||||
<sourceDirectory>src/java</sourceDirectory>
|
||||
<unitTestSourceDirectory>src/test</unitTestSourceDirectory>
|
||||
<integrationUnitTestSourceDirectory/>
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
<?xml version="1.0"?>
|
||||
<!--
|
||||
Copyright 2005-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
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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
|
||||
|
||||
@ -17,7 +18,7 @@ limitations under the License.
|
||||
<document>
|
||||
<properties>
|
||||
<title>Building</title>
|
||||
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
|
||||
<author email="dev@commons.apache.org">Commons Documentation Team</author>
|
||||
</properties>
|
||||
<body>
|
||||
<!-- ================================================== -->
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||
<!--
|
||||
Copyright 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
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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
|
||||
|
||||
@ -19,7 +20,7 @@
|
||||
|
||||
<properties>
|
||||
<title>Compatibility</title>
|
||||
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
|
||||
<author email="dev@commons.apache.org">Commons Documentation Team</author>
|
||||
</properties>
|
||||
|
||||
<body>
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
<?xml version="1.0"?>
|
||||
<!--
|
||||
Copyright 2005 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
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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
|
||||
|
||||
@ -17,26 +18,26 @@ limitations under the License.
|
||||
<document>
|
||||
<properties>
|
||||
<title>Source repository</title>
|
||||
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
|
||||
<author email="dev@commons.apache.org">Commons Documentation Team</author>
|
||||
</properties>
|
||||
<body>
|
||||
<!-- ================================================== -->
|
||||
<section name="Source repository">
|
||||
<p>
|
||||
Jakarta Commons Collections is hosted on the Apache
|
||||
Apache Commons Collections is hosted on the Apache
|
||||
<a href="http://subversion.tigris.org/">subversion</a> repository.
|
||||
</p>
|
||||
<p>
|
||||
The project URL is:<br />
|
||||
<code>http://svn.apache.org/repos/asf/jakarta/commons/proper/collections/trunk</code>
|
||||
<code>http://svn.apache.org/repos/asf/commons/proper/collections/trunk</code>
|
||||
</p>
|
||||
<p>
|
||||
The best way to view the repository is via the
|
||||
<a href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/collections/trunk/">subversion viewer</a>.
|
||||
<a href="http://svn.apache.org/viewvc/commons/proper/collections/trunk/">subversion viewer</a>.
|
||||
</p>
|
||||
<p>
|
||||
The alternative is to use the
|
||||
<a href="http://svn.apache.org/repos/asf/jakarta/commons/proper/collections/trunk/">native subversion</a> display.
|
||||
<a href="http://svn.apache.org/repos/asf/commons/proper/collections/trunk/">native subversion</a> display.
|
||||
</p>
|
||||
</section>
|
||||
<!-- ================================================== -->
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||
<!--
|
||||
Copyright 2004-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
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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
|
||||
|
||||
@ -19,7 +20,7 @@
|
||||
|
||||
<properties>
|
||||
<title>History</title>
|
||||
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
|
||||
<author email="dev@commons.apache.org">Commons Documentation Team</author>
|
||||
</properties>
|
||||
|
||||
<body>
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
<?xml version="1.0"?>
|
||||
<!--
|
||||
Copyright 2002-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
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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
|
||||
|
||||
@ -17,7 +18,7 @@
|
||||
<document>
|
||||
<properties>
|
||||
<title>Home</title>
|
||||
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
|
||||
<author email="dev@commons.apache.org">Commons Documentation Team</author>
|
||||
</properties>
|
||||
<body>
|
||||
<!-- ================================================== -->
|
||||
@ -65,18 +66,18 @@ The JavaDoc API documents are available online:
|
||||
</ul>
|
||||
<p>
|
||||
The <a href="cvs-usage.html">subversion repository</a> can be
|
||||
<a href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/collections/trunk/">browsed</a>.
|
||||
<a href="http://svn.apache.org/viewvc/commons/proper/collections/trunk/">browsed</a>.
|
||||
</p>
|
||||
</section>
|
||||
<!-- ================================================== -->
|
||||
<section name="Releases">
|
||||
<p>
|
||||
The latest version is v3.2. -
|
||||
<a href="http://jakarta.apache.org/site/downloads/downloads_commons-collections.cgi">Download now!</a><br />
|
||||
<a href="http://commons.apache.org/downloads/download_collections.cgi">Download now!</a><br />
|
||||
The <a href="release_3_2.html">release notes</a> are also available.
|
||||
</p>
|
||||
<p>
|
||||
For previous releases, see the <a href="http://archive.apache.org/dist/jakarta/commons/collections/">Apache Archive</a>
|
||||
For previous releases, see the <a href="http://archive.apache.org/dist/commons/collections/">Apache Archive</a>
|
||||
</p>
|
||||
</section>
|
||||
<!-- ================================================== -->
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
<?xml version="1.0"?>
|
||||
<!--
|
||||
Copyright 2005-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
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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
|
||||
|
||||
@ -17,7 +18,7 @@ limitations under the License.
|
||||
<document>
|
||||
<properties>
|
||||
<title>Issue tracking</title>
|
||||
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
|
||||
<author email="dev@commons.apache.org">Commons Documentation Team</author>
|
||||
</properties>
|
||||
<body>
|
||||
<!-- ================================================== -->
|
||||
@ -37,7 +38,7 @@ limitations under the License.
|
||||
<ol>
|
||||
<li><a href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310465&sorter/field=issuekey&sorter/order=DESC&status=1&status=4">Search existing open bugs</a>.
|
||||
If you find your issue listed then please add a comment with your details.</li>
|
||||
<li><a href="http://mail-archives.apache.org/mod_mbox/jakarta-commons-dev/">Search the mailing list archive</a>.
|
||||
<li><a href="http://mail-archives.apache.org/mod_mbox/commons-dev/">Search the mailing list archive</a>.
|
||||
You may find your issue or idea has already been discussed.</li>
|
||||
<li>Decide if your issue is a bug or an enhancement.</li>
|
||||
<li>Submit either a <a href="http://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310465&issuetype=1&priority=4&assignee=-1">bug report</a>
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||
<!--
|
||||
Copyright 2002-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
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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
|
||||
|
||||
@ -14,19 +15,19 @@
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
-->
|
||||
<!DOCTYPE org.apache.commons.menus SYSTEM 'http://jakarta.apache.org/commons/build/maven-build.dtd'>
|
||||
<!DOCTYPE org.apache.commons.menus SYSTEM 'http://commons.apache.org/build/maven-build.dtd'>
|
||||
<project name="Commons Collections">
|
||||
|
||||
<title>Commons Collections</title>
|
||||
|
||||
<body>
|
||||
<links>
|
||||
<item name="Jakarta Commons" href="http://jakarta.apache.org/commons/"/>
|
||||
<item name="Apache Commons" href="http://commons.apache.org/"/>
|
||||
</links>
|
||||
|
||||
<menu name="Commons Collections">
|
||||
<item name="Overview" href="/index.html"/>
|
||||
<item name="Download" href="http://jakarta.apache.org/site/downloads/downloads_commons-collections.cgi"/>
|
||||
<item name="Download" href="http://commons.apache.org/downloads/download_collections.cgi"/>
|
||||
<item name="User guide" href="/userguide.html"/>
|
||||
<item name="History" href="/history.html"/>
|
||||
<item name="Javadoc (3.2 release)" href="api-release/index.html"/>
|
||||
@ -38,7 +39,7 @@
|
||||
<item name="Team" href="/team-list.html"/>
|
||||
<item name="Tasks" href="/tasks.html"/>
|
||||
<item name="Proposal" href="/proposal.html"/>
|
||||
<item name="SVN repository" href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/collections/trunk/"/>
|
||||
<item name="SVN repository" href="http://svn.apache.org/viewvc/commons/proper/collections/trunk/"/>
|
||||
<item name="Javadoc (SVN latest)" href="apidocs/index.html"/>
|
||||
</menu>
|
||||
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||
<!--
|
||||
Copyright 2003-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
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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
|
||||
|
||||
@ -19,7 +20,7 @@
|
||||
|
||||
<properties>
|
||||
<title>Choosing a collection</title>
|
||||
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
|
||||
<author email="dev@commons.apache.org">Commons Documentation Team</author>
|
||||
</properties>
|
||||
|
||||
<body>
|
||||
@ -89,19 +90,19 @@ For example you could convert a country code to text <i>but not</i> text to coun
|
||||
<h3>BidiMap interface</h3>
|
||||
|
||||
<p>
|
||||
The <a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/BidiMap.html">BidiMap</a> interface and implementations in Commons Collections allow you to lookup data in both directions. There are three implementations:
|
||||
The <a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/BidiMap.html">BidiMap</a> interface and implementations in Commons Collections allow you to lookup data in both directions. There are three implementations:
|
||||
<table>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/bidimap/DualHashBidiMap.html">DualHashBidiMap</a></td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/bidimap/DualHashBidiMap.html">DualHashBidiMap</a></td>
|
||||
<td>Uses two <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/HashMap.html">HashMap</a> objects internally. This implementation is a useful general purpose BidiMap that can store any object. The objects are stored in any order, and the order may change over time.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/bidimap/DualTreeBidiMap.html">DualTreeBidiMap</a></td>
|
||||
<td>Uses two <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/TreeMap.html">TreeMap</a> objects internally which means that keys and values must implement <a href="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</a>, unless a comparator is supplied. If considering this class, the TreeBidiMap is usually a better choice. However, this is the only implementation of the <a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/SortedBidiMap.html">SortedBidiMap</a> interface.</td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/bidimap/DualTreeBidiMap.html">DualTreeBidiMap</a></td>
|
||||
<td>Uses two <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/TreeMap.html">TreeMap</a> objects internally which means that keys and values must implement <a href="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</a>, unless a comparator is supplied. If considering this class, the TreeBidiMap is usually a better choice. However, this is the only implementation of the <a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/SortedBidiMap.html">SortedBidiMap</a> interface.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/bidimap/TreeBidiMap.html">TreeBidiMap</a></td>
|
||||
<td>Dedicated implementation that requires keys and values to implement <a href="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</a>, unless a comparator is supplied. This is an efficient implementation using a data structure that avoids duplicating data. The keys and values are held and viewed in sorted order, and the class implements the <a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/OrderedBidiMap.html">OrderedBidiMap</a> interface.</td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/bidimap/TreeBidiMap.html">TreeBidiMap</a></td>
|
||||
<td>Dedicated implementation that requires keys and values to implement <a href="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</a>, unless a comparator is supplied. This is an efficient implementation using a data structure that avoids duplicating data. The keys and values are held and viewed in sorted order, and the class implements the <a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/OrderedBidiMap.html">OrderedBidiMap</a> interface.</td>
|
||||
</tr>
|
||||
</table>
|
||||
</p>
|
||||
@ -119,11 +120,11 @@ The <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/Map.html">Map</a> i
|
||||
<td>This map is the most commonly used and fastest implementation. It is suitable for most situations and can store any object. Objects are stored in any order, and the order may change over time.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/HashedMap.html">HashedMap</a></td>
|
||||
<td>The Commons Collections hash map implementation which is very similar in design to HashMap, but also supports easy iteration via a <a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/MapIterator.html">MapIterator</a>. This implementation is also designed to be subclassed. Use this map if you want to use the extra iterator, or to subclass. Otherwise, there is no advantage (or disadvantage) compared to the JDK HashMap.</td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/HashedMap.html">HashedMap</a></td>
|
||||
<td>The Commons Collections hash map implementation which is very similar in design to HashMap, but also supports easy iteration via a <a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/MapIterator.html">MapIterator</a>. This implementation is also designed to be subclassed. Use this map if you want to use the extra iterator, or to subclass. Otherwise, there is no advantage (or disadvantage) compared to the JDK HashMap.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/IdentityMap.html">IdentityMap</a></td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/IdentityMap.html">IdentityMap</a></td>
|
||||
<td>This map operates exactly as per HashedMap but compares keys and values using == not .equals().</td>
|
||||
</tr>
|
||||
<tr>
|
||||
@ -135,7 +136,7 @@ The <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/Map.html">Map</a> i
|
||||
<td>This map ensures that the keys are always sorted, and iteration order is consistent. All keys must implement <a href="http://java.sun.com/j2se/1.4/docs/api/java/lang/Comparable.html">Comparable</a>, unless a comparator is supplied. This map should be used if you need the map to be sorted.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/LinkedMap.html">LinkedMap</a></td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/LinkedMap.html">LinkedMap</a></td>
|
||||
<td>This map maintains the order that each object is added to the map. When the map is viewed via an iterator, the insertion order will be seen. This map should be used if you need to retain the insertion order.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
@ -143,15 +144,15 @@ The <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/Map.html">Map</a> i
|
||||
<td>This map, available from JDK 1.4, maintains the order that each object is added to the map. When the map is viewed via an iterator, the insertion order will be seen. Commons collections' LinkedMap provides the same functionality for JDK1.2 onwards and provides a MapIterator.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/ListOrderedMap.html">ListOrderedMap</a></td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/ListOrderedMap.html">ListOrderedMap</a></td>
|
||||
<td>This map decorates another map to maintains the order that each object is added to the map. The order is maintained using a list. This map should be used if you need to retain the insertion order but you also need the special features of another map.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/LRUMap.html">LRUMap</a></td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/LRUMap.html">LRUMap</a></td>
|
||||
<td>This map places a maximum size limit on the map and removes the least recently used (LRU) key-value when it is full. This map should be used for caches where you want to limit the maximum memory size used, and are happy with the least recently used algorithm for removals.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/ReferenceMap.html">ReferenceMap</a></td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/ReferenceMap.html">ReferenceMap</a></td>
|
||||
<td>This map enables keys and values to be garbage collected whilst still held in the map. This can be useful for building memory sensitive caches. This map should be used for caches where you want to allow garbage collection from the map.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
@ -159,19 +160,19 @@ The <a href="http://java.sun.com/j2se/1.4/docs/api/java/util/Map.html">Map</a> i
|
||||
<td>This map stores each key-value pair with a key that can be garbage collected. This can be useful for building memory sensitive caches. ReferenceMap provides the same functionality but with much more flexibility.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/ReferenceIdentityMap.html">ReferenceIdentityMap</a></td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/ReferenceIdentityMap.html">ReferenceIdentityMap</a></td>
|
||||
<td>This map operates exactly as per ReferenceMap but compares keys and values using == not .equals().</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/SingletonMap.html">SingletonMap</a></td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/SingletonMap.html">SingletonMap</a></td>
|
||||
<td>This map is restricted to storing one key-value pair. It may contain no more than and no less than one pair. It provides a MapIterator. This map should be used if you want to return one key-value pair and must use the Map interface.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/Flat3Map.html">Flat3Map</a></td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/Flat3Map.html">Flat3Map</a></td>
|
||||
<td>This map is optimised to store one, two or three key-value pairs and outperforms HashMap at these sizes. For size four and above performance is about 5% slower than HashMap. This map also has good garbage collection characteristics when below size four. It provides a MapIterator. This map should be used if are 99% sure that the map will be size three or less.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="http://jakarta.apache.org/commons/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/StaticBucketMap.html">StaticBucketMap</a></td>
|
||||
<td><a href="http://commons.apache.org/collections/apidocs-COLLECTIONS_3_1/org/apache/commons/collections/map/StaticBucketMap.html">StaticBucketMap</a></td>
|
||||
<td>This map is optimised to work well in a heavily loaded multi-threaded environment. It provides synchronization internally, locking on a per 'bucket' basis, where the buckets are fixed at construction time. You should use this class if you can predict the size of the map and you are working in a very intensive multi-threaded environment.</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
@ -45,7 +45,7 @@
|
||||
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>
|
||||
several future proposed components for the Apache Commons subproject. </p>
|
||||
|
||||
<p>No external configuration files are utilized.</p>
|
||||
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
<?xml version="1.0"?>
|
||||
<!--
|
||||
Copyright 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
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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
|
||||
|
||||
@ -17,7 +18,7 @@ limitations under the License.
|
||||
<document>
|
||||
<properties>
|
||||
<title>Release notes for v3.2</title>
|
||||
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
|
||||
<author email="dev@commons.apache.org">Commons Documentation Team</author>
|
||||
</properties>
|
||||
<body>
|
||||
|
||||
|
||||
@ -1 +1 @@
|
||||
@import url("http://jakarta.apache.org/style/jakarta-maven.css");
|
||||
@import url("http://commons.apache.org/style/commons-maven.css");
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
<?xml version="1.0"?>
|
||||
<!--
|
||||
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
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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
|
||||
|
||||
@ -19,7 +20,7 @@
|
||||
|
||||
<properties>
|
||||
<title>Tasks outstanding</title>
|
||||
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
|
||||
<author email="dev@commons.apache.org">Commons Documentation Team</author>
|
||||
</properties>
|
||||
|
||||
<body>
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||
<!--
|
||||
Copyright 2003-2005 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
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You 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
|
||||
|
||||
@ -19,7 +20,7 @@
|
||||
|
||||
<properties>
|
||||
<title>User guide</title>
|
||||
<author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
|
||||
<author email="dev@commons.apache.org">Commons Documentation Team</author>
|
||||
</properties>
|
||||
|
||||
<body>
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user