Package org.magicwerk.brownies.collections
Brownies Collections complements the Java Collections Framework.
-
GapList combines the strengths of both ArrayList and LinkedList. It is implemented to offer both efficient random access to elements by index (as ArrayList does) and at the same time efficient adding and removing elements to and from beginning and end (as LinkedList does). It also exploits the locality of reference often seen in applications to further improve performance, e.g. for iterating over the list.
-
BigList is a list optimized for storing large number of elements. It stores the elements in fixed size blocks so for adding and removing only few elements must be moved. Blocks are split or merged as needed and maintained in a tree for fast access. Copying a BigList is very efficient as it is implemented using a copy-on-write approach.
-
Both GapList and BigList have been designed to be used as drop-in replacement for ArrayList, LinkedList or ArrayDequeu by offering all their methods. Additionally many more helpful methods are available provided by the common abstract class IList.
-
There are specialized List implementations for all primitive data types. As the storage is realized using arrays of primitives, memory is saved and execution speed increased. These classes are named IntGapList/IntBigList, LongGapList/LongBigList, etc.
-
For each primitive list class like IntGapList there is also wrapper which allows you to access the primitive data through the standard List interface. With this approach you can save memory and continue to use the code working with lists. These classes are named IntObjGapList/IntObjBigList, LongObjGapList/LongObjBigList, etc.
-
To increase developer productivity, keys and constraints have been added to collections in an orthogonal and declarative way. These features offered by classes implementing the Collection (classes KeyCollection, Key1Collection, Key2Collection) and the List interface (classes KeyList, Key1List, Key2List).
-
ClassDescriptionBigList<E>BigList is a list optimized for storing large number of elements.A block stores in maximum blockSize number of elements.Implements an AVLNode storing a Block.A read-only version of
Key1List
.Implements a Set based on a Collection.GapList<E>Class {link GapList} combines the strengths of bothArrayList
andLinkedList
.A read-only version ofGapList
.ICollection<E>IList is an abstract class which offers all interfaces offered by both ArrayList and LinkedList.ICollectionTools offers default implementations of Collection functionality.IList<E>ClassIList
is the abstract class which offers all interfaces implemented by ArrayList.Wrapper to treat an array asIListable
.Wrapper to treat aCollection
asIListable
.Wrapper to treat a repeated element asIListable
.IListable<E>InterfaceIListable
offers a minimalist interface for accessing a list or an array.IListAsDeque<E>ImmutableMapEntry<K,E> Read-only implementation of Map.Entry.Key1Collection<E,K> Key1Collection implements a collection with 1 key.Builder to construct Key1Collection instances.Key1List<E,K> Key1List implements a key list with 1 key.Key1List.Builder<E,K> Builder to construct Key1List instances.A read-only version ofKey1List
.Key1Set<E,K> Key1Set implements a set.Key1Set.Builder<E,K> Builder to construct Key1Set instances.Key2Collection<E,K1, K2> Key2Collection implements a collection with 2 keys.Key2Collection.Builder<E,K1, K2> Builder to construct Key2Collection instances.Key2List<E,K1, K2> Key2List implements a key list with 2 keys.Key2List.Builder<E,K1, K2> Builder to construct Key2List instances.Key2List.ReadOnlyKey2List<E,K1, K2> A read-only version ofKey2List
.Key2Set<E,K1, K2> Key2Set implements a set.Key2Set.Builder<E,K1, K2> Builder to construct Key2Set instances.KeyCollection implements a collection.Builder to construct KeyCollection instances.KeyCollectionAsMap<K,E> Implements a Map based on a key map in a KeyCollection or KeyList.Implements a Set based on a Collection.Add: - validation fails: null / constraint - duplicate not allowed (mode replace) Triggers: - triggers are called after the add/remove operation has finished - if an exception is thrown in the trigger, the change already made to the collection is not undoneImplementation of builder.List type used to store multiple elements.KeyList<E>KeyList implements a list.Builder to construct KeyList instances.A read-only version ofKeyList
.KeyListImpl<E>A KeyList add key handling features to GapList.KeySet<E>KeySet implements a set.Builder to construct KeySet instances.ClassListables.IListableArray
implements theIListable
interface for arrays.