Summary
=======
The Java Collections Framework was a major addition in JDK 1.2. It added
many powerful data structures that accelerate development of most 
significant Java applications. Since that time it has become the recognised 
standard for collection handling in Java.

Commons-Collections seek to build upon the JDK classes by providing new 
interfaces, implementations and utilities. 

Commons-Collections has many features, including:

* Bag interface for collections that have a number of copies of each object
* Buffer interface for collections that have a well defined removal order, 
  like FIFOs
* BidiMap interface for maps that can be looked up from value to key as well 
  and key to value
* MapIterator interface to provide simple and quick iteration over maps
* Type checking decorators to ensure that only instances of a certain type 
  can be added
* Transforming decorators that alter each object as it is added to the collection
* Composite collections that make multiple collections look like one
* Ordered maps and sets that retain the order elements are added in, including 
  an LRU based map
* Identity map that compares objects based on their identity (==) instead of the 
  equals method
* Reference map that allows keys and/or values to be garbage collected under 
  close control
* Many comparator implementations
* Many iterator implementations
* Adapter classes from array and enumerations to collections
* Utilities to test or create typical set-theory properties of collections 
  such as union, intersection, and closure

Commons-Collections 3.2.1 will be integrated into the SFW consolidation as 
part of this proposal, and will be installed as SUNWcommons-collections.

The Commons-Collections package will contain commonly used versions of 
Commons-Collections. The file name will be used to manage multiple versions, 
for example:

-------------------------------------------------------------------
/usr/share/lib/java/commons-collections.jar     link to most recent version
/usr/share/lib/java/commons-collections-3.2.1.jar
/usr/share/lib/java/commons-collections-3.1.1.jar
-------------------------------------------------------------------

This project requests a minor release binding. 

The Commons-Collections man page is included in the case materials directory.

Dependencies
============

SUNWjunit


Interfaces
==========

Exported Interfaces		Classification	Comment
-------------------		--------------	-------------
SUNWcommons-collections		Uncommitted	Commons-Collections Package

/usr/share/lib/java/commons-collections-3.2.1.jar
				Uncommitted	Commons-Collections Classes
/usr/share/lib/java/commons-collections.jar
				Uncommitted	Symbolic Link

	org.apache.commons.collections 
		Bag 	
		BidiMap 	
		BoundedCollection 	
		BoundedMap 	
		Buffer 	
		Closure 	
		Factory 	
		IterableMap 	
		KeyValue 	
		MapIterator 	
		MultiMap 	
		OrderedBidiMap 	
		OrderedIterator 	
		OrderedMap 	
		OrderedMapIterator 	
		Predicate 	
		PriorityQueue 	
		ResettableIterator 	
		ResettableListIterator 	
		SortedBag 	
		SortedBidiMap 	
		Transformer 	
		Unmodifiable 	

	org.apache.commons.collections.collection 
		CompositeCollection.CollectionMutator 	

	org.apache.commons.collections.functors 
		PredicateDecorator 	

	org.apache.commons.collections.map 
		CompositeMap.MapMutator 	

	org.apache.commons.collections.set 
		CompositeSet.SetMutator 	

Project Private 		Classification	Comment
-------------------		--------------	-------------
non-interface classes 		Project Private	Interal Classes

/usr/share/lib/java/commons-collections-testframework-3.2.1.jar
				Project Private	Testframework Classes
/usr/share/lib/java/commons-collections-testframework.jar
				Project Private Symbolic Link

Documentation
----------------
/usr/share/lib/java/javadoc/commons-collections[2]
/usr/share/doc/commons-collections

Imported Interfaces		Classification		Comment
-------------------		--------------		-------------
SUNWjunit			Uncommitted		LSARC/2008/633
JDK 1.5  or higher 		Uncommitted		Java Development Kit


Reference Documents
===================
[1] http://commons.apache.org/collections
[2] http://commons.apache.org/collections/api-release