craterdog.collections.abstractions

Class SortableCollection<E>

java.lang.Object

craterdog.smart.SmartObject<Collection<E>>

craterdog.collections.abstractions.Collection<E>

craterdog.collections.abstractions.OpenCollection<E>

craterdog.collections.abstractions.SortableCollection<E>

Type Parameters:

E - The type of element managed by the collection.

All Implemented Interfaces:

Accessible<E>, Dynamic<E>, Sortable<E>, Composite, Sequential<E>, java.lang.Comparable<Collection<E>>, java.lang.Iterable<E>

Direct Known Subclasses:

List, Map

public abstract class SortableCollection<E>
extends OpenCollection<E>
implements Sortable<E>

This abstract class defines the invariant methods that all sortable collections must inherit. A sortable collection allows the order of its elements to be determined externally. By default, the elements will be placed in the order in which they were added to the collection. Additionally, the elements can be sorted in various ways depending on a specified sorting algorithm and comparison function.

Author:

Derk Norton

Constructor Summary

Constructors

Constructor and Description
SortableCollection()

Method Summary

Modifier and Type	Method and Description
static <E> SortableCollection<E>	concatenate(SortableCollection<E> collection1, SortableCollection<E> collection2) This method returns a new collection that is the concatenation of this collection with the specified collection.
void	shuffleElements() This method shuffles the elements in the collection using a randomizing algorithm.
void	sortElements() This method sorts the elements in the collection using the default (merge) sorting algorithm and the elements' compareTo method.
void	sortElements(java.util.Comparator<? super E> comparator) This method sorts the elements in the collection using the default (merge) sorting algorithm and the specified comparison function.
void	sortElements(Sorter<E> sorter, java.util.Comparator<? super E> comparator) This method sorts the elements in the collection using the specified sorting algorithm and the specified comparison function.

Methods inherited from class craterdog.collections.abstractions.OpenCollection

addElements, addElements, removeElements, removeElements

Methods inherited from class craterdog.collections.abstractions.Collection

compareTo, containsAllElementsIn, containsAnyElementsIn, containsElement, equals, hashCode, isEmpty, iterator, normalizedIndex, toArray

Methods inherited from class craterdog.smart.SmartObject

addSerializableClass, addSerializableClass, copy, toExposedString, toString, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface craterdog.collections.interfaces.Sortable

createDefaultManipulator

Methods inherited from interface craterdog.collections.interfaces.Dynamic

addElement, removeElement

Methods inherited from interface craterdog.collections.interfaces.Accessible

createDefaultIterator, getElementAtIndex, getElementsInRange, getIndexOfElement, removeAllElements

Methods inherited from interface craterdog.core.Sequential

getNumberOfElements

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

SortableCollection

public SortableCollection()

Method Detail

shuffleElements

public void shuffleElements()

Description copied from interface: Sortable

This method shuffles the elements in the collection using a randomizing algorithm.

Specified by:

shuffleElements in interface Sortable<E>

sortElements

public void sortElements()

Description copied from interface: Sortable

This method sorts the elements in the collection using the default (merge) sorting algorithm and the elements' compareTo method. It provides an easy way to sort a collection using its natural ordering.

Specified by:

sortElements in interface Sortable<E>

sortElements

public void sortElements(java.util.Comparator<? super E> comparator)

Description copied from interface: Sortable

This method sorts the elements in the collection using the default (merge) sorting algorithm and the specified comparison function.

Specified by:

sortElements in interface Sortable<E>

Parameters:

comparator - The desired comparison function.

sortElements

public void sortElements(Sorter<E> sorter,
                         java.util.Comparator<? super E> comparator)

Description copied from interface: Sortable

This method sorts the elements in the collection using the specified sorting algorithm and the specified comparison function.

Specified by:

sortElements in interface Sortable<E>

Parameters:

sorter - The desired sorting algorithm.

comparator - The desired comparison function.

concatenate

public static <E> SortableCollection<E> concatenate(SortableCollection<E> collection1,
                                                    SortableCollection<E> collection2)

This method returns a new collection that is the concatenation of this collection with the specified collection.

Type Parameters:

E - The type of element contained in the collections.

Parameters:

collection1 - The first collection to be concatenated.

collection2 - The second collection to be concatenated.

Returns:

The resulting collection.