Package org.geotoolkit.util.collection

Addition to the collection framework.

See:
Description

Interface Summary

Cache.Handler<V>	The handler returned by Cache.lock(K), to be used for unlocking and storing the result.
CheckedCollection<E>	Collection that ensures that all elements are assignable to a given base type.
CheckedContainer<E>	A container that ensures that all elements are assignable to a given base type.

Class Summary

Cache<K,V>	A concurrent cache mechanism.
CheckedArrayList<E>	A checked and synchronized List.
CheckedHashMap<K,V>	A checked and synchronized Map.
CheckedHashSet<E>	A checked and synchronized Set.
DeferringIterator<E>	An iterator deferring to the iteration end any object which comply to some criterion.
DerivedMap<BK,K,V>	A map whose keys are derived from an other map.
DerivedSet<B,E>	A set whose values are derived from an other set.
DisjointSet<E>	A set which is disjoint from others DisjointSets.
FrequencySortedSet<E>	A set with elements ordered by the amount of time they were added.
IntegerList	A list of unsigned integer values.
KeySortedList<K extends Comparable<K>,V>	List of elements sorted by a key which is not the element itself.
LazyList<E>	An immutable list filled when needed from the values returned by an iterator.
RangeSet<T extends Comparable<? super T>>	An ordered set of ranges.
UnmodifiableArrayList<E>	An unmodifiable view of an array.
WeakHashSet<E>	A set of objects hold by weak references.
WeakValueHashMap<K,V>	A hashtable-based map implementation that uses weak references, leaving memory when an entry is not used anymore.
XCollections	Static methods working on Collection objects.

Exception Summary

BackingStoreException

Thrown to indicate that an operation could not complete because of a failure in the backing store (a file or a database).

Package org.geotoolkit.util.collection Description

Addition to the collection framework. Most classes in this package implement interfaces from the Java Collection Framework defined in the java.util package.

• WeakHashSet provides a way to ensure that a factory returns unique instances for all values that are equal in the sense of Object.equals(Object). The values that were created in previous factory operations are retained by weak references for reuse.

• Cache and WeakValueHashMap are java.util.Map implementations that may be used for some caching or pseudo-caching functionalities. The Cache implementation is the most full-featured one and supports concurrency, while the other implementations are more lightweight, sometime thread-safe but without concurrency support.

• CheckedCollection, CheckedArrayList, CheckedHashSet and CheckedHashMap can be used for combining runtime type safety with thread-safety (without concurrency). They are similar in functionalities to the wrappers provided by the standard Collections methods, except that they combine both functionalities in a single class (so reducing the amount of indirection), provide a hook for making the collections read-only and allow the caller to specify the synchronization lock of his choice.

• DerivedMap and DerivedSet are wrapper collections in which the keys or the values are derived on-the-fly from the content of an other collection.

• IntegerList and RangeSet are collections specialized for a particular kind of content, providing more efficient storage than what we would get with the general-purpose collection implementations.

• DisjointSet, KeySortedList and FrequencySortedSet provides specialized ways to organize their elements.

Since:

1.0

Version:

3.01

Author:

Martin Desruisseaux (IRD)

Module:

utility/geotk-utility (download)