org.boon.sort

Class Sorting

java.lang.Object

org.boon.sort.Sorting

public class Sorting
extends Object

Constructor Summary

Constructors

Constructor and Description
Sorting()

Method Summary

Methods

Modifier and Type	Method and Description
static int	compare(Object value1, Object value2) This compares two values.
static int	compare(Object value1, Object value2, boolean nullsLast) This compares two values.
static <T> Collection<T>	sort(Class<T> componentType, Collection<T> collection) Sorts a collection based on the natural ascending order.
static <T> Collection<T>	sort(Class<T> componentType, Collection<T> collection, String sortBy) Sorts collection ascending Nulls last.
static <T> Iterable<T>	sort(Class<T> componentType, Iterable<T> iterable) Sorts a iterable based on the natural ascending order.
static <T> Iterable<T>	sort(Class<T> componentType, Iterable<T> iterable, String sortBy) Sorts iterable ascending Nulls last.
static <V> Collection<V>	sort(Class<V> componentType, Collection<V> collection, String sortBy, boolean ascending, boolean nullsFirst) Sort collection.
static <V> Iterable<V>	sort(Class<V> componentType, Iterable<V> iterable, String sortBy, boolean ascending, boolean nullsFirst) Sort collection.
static void	sort(List list) Sorts a list based on the natural ascending order.
static void	sort(List list, Sort... sorts) Takes a list an an array or sorts
static void	sort(List list, String sortBy) Sorts lists ascending Nulls last.
static void	sort(List list, String sortBy, boolean ascending, boolean nullsFirst) Sort a list.
static <T> void	sort(T[] array) Sorts a array based on the natural ascending order.
static <T> void	sort(T[] array, String sortBy) Sorts array ascending Nulls last.
static <T> void	sort(T[] array, String sortBy, boolean ascending, boolean nullsFirst) Sort an array.
static <T> Collection<T>	sortDesc(Class<T> componentType, Collection<T> collection) Sorts a collection based on the natural descending order.
static <T> Collection<T>	sortDesc(Class<T> componentType, Collection<T> collection, String sortBy) Sorts collection ascending Nulls last.
static <T> Iterable<T>	sortDesc(Class<T> componentType, Iterable<T> iterable) Sorts a iterable based on the natural descending order.
static <T> Iterable<T>	sortDesc(Class<T> componentType, Iterable<T> iterable, String sortBy) Sorts iterable ascending Nulls last.
static void	sortDesc(List list) Sorts a list based on the natural order descending order.
static void	sortDesc(List list, String sortBy) Sorts lists Descending
static <T> void	sortDesc(T[] array) Sorts a array based on the natural order descending order.
static <T> void	sortDesc(T[] array, String sortBy) Sorts array Descending Nulls last.
static <T> Collection<T>	sortDescNullsFirst(Class<T> componentType, Collection<T> collection) Sorts a collection based on the natural descending order.
static <T> Collection<T>	sortDescNullsFirst(Class<T> componentType, Collection<T> collection, String sortBy) Sorts collection ascending Nulls first.
static <T> Iterable<T>	sortDescNullsFirst(Class<T> componentType, Iterable<T> iterable) Sorts a iterable based on the natural descending order.
static <T> Iterable<T>	sortDescNullsFirst(Class<T> componentType, Iterable<T> iterable, String sortBy) Sorts iterable ascending Nulls first.
static void	sortDescNullsFirst(List list) Sorts a list based on the natural order descending order.
static void	sortDescNullsFirst(List list, String sortBy) Sorts lists Descending
static <T> void	sortDescNullsFirst(T[] array) Sorts a array based on the natural order descending order.
static <T> void	sortDescNullsFirst(T[] array, String sortBy) Sorts array Descending Nulls first.
static <K,V> Collection<Map.Entry<K,V>>	sortEntries(Class<V> componentType, Map<K,V> map, String sortBy, boolean ascending, boolean nullsFirst) Sort map entries.
static <K,V> Collection<Map.Entry<K,V>>	sortKeys(Class<V> componentType, Map<K,V> map, String sortBy, boolean ascending, boolean nullsFirst) Sort map keys.
static <T> Collection<T>	sortNullsFirst(Class<T> componentType, Collection<T> collection) Sorts a collection based on the natural ascending order.
static <T> Collection<T>	sortNullsFirst(Class<T> componentType, Collection<T> collection, String sortBy) Sorts collection ascending Nulls first.
static <T> Iterable<T>	sortNullsFirst(Class<T> componentType, Iterable<T> iterable) Sorts an iterable based on the natural ascending order.
static <T> Iterable<T>	sortNullsFirst(Class<T> componentType, Iterable<T> iterable, String sortBy) Sorts iterable ascending Nulls first.
static void	sortNullsFirst(List list) Sorts a list based on the natural ascending order and puts null values first.
static void	sortNullsFirst(List list, String sortBy) Sorts lists Ascending Null first Nulls first.
static <T> void	sortNullsFirst(T[] array) Sorts an array based on the natural ascending order and puts null values first.
static <T> void	sortNullsFirst(T[] array, String sortBy) Sorts array ascending Nulls first.
static <K,V> Collection<Map.Entry<K,V>>	sortValues(Class<V> componentType, Map<K,V> map, String sortBy, boolean ascending, boolean nullsFirst) Sort map values.
static Comparator	thisUniversalComparator(boolean ascending, boolean nullsFirst) This creates the universal comparator object used for "this".
static Comparator	universalComparator(FieldAccess field, boolean ascending, boolean nullsFirst) This creates the universal comparator object which is used by the sort work horse.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Sorting

public Sorting()

Method Detail

sort

public static void sort(List list,
        Sort... sorts)

Takes a list an an array or sorts

Parameters:

list - list to sorts

sorts - what you want to sore the list by

sort

public static void sort(List list,
        String sortBy,
        boolean ascending,
        boolean nullsFirst)

Sort a list.

Parameters:

list - the list you want to sort

sortBy - what you want to sort the list by

ascending - do you want ascending order

nullsFirst - do you want nulls first

sort

public static <V> Collection<V> sort(Class<V> componentType,
                     Collection<V> collection,
                     String sortBy,
                     boolean ascending,
                     boolean nullsFirst)

Sort collection.

Parameters:

collection - the collection you want to sort

sortBy - what you want to sort the list by

ascending - do you want ascending order

nullsFirst - do you want nulls first

sortEntries

public static <K,V> Collection<Map.Entry<K,V>> sortEntries(Class<V> componentType,
                                           Map<K,V> map,
                                           String sortBy,
                                           boolean ascending,
                                           boolean nullsFirst)

Sort map entries.

Parameters:

map - the map entries you want to sort

sortBy - what you want to sort the list by

ascending - do you want ascending order

nullsFirst - do you want nulls first

sortValues

public static <K,V> Collection<Map.Entry<K,V>> sortValues(Class<V> componentType,
                                          Map<K,V> map,
                                          String sortBy,
                                          boolean ascending,
                                          boolean nullsFirst)

Sort map values.

Parameters:

map - the map entries you want to sort

sortBy - what you want to sort the list by

ascending - do you want ascending order

nullsFirst - do you want nulls first

sortKeys

public static <K,V> Collection<Map.Entry<K,V>> sortKeys(Class<V> componentType,
                                        Map<K,V> map,
                                        String sortBy,
                                        boolean ascending,
                                        boolean nullsFirst)

Sort map keys.

Parameters:

map - the map entries you want to sort

sortBy - what you want to sort the list by

ascending - do you want ascending order

nullsFirst - do you want nulls first

sort

public static <V> Iterable<V> sort(Class<V> componentType,
                   Iterable<V> iterable,
                   String sortBy,
                   boolean ascending,
                   boolean nullsFirst)

Sort collection.

Parameters:

iterable - the iterable you want to sort

sortBy - what you want to sort the list by

ascending - do you want ascending order

nullsFirst - do you want nulls first

sort

public static <T> void sort(T[] array,
            String sortBy,
            boolean ascending,
            boolean nullsFirst)

Sort an array.

Parameters:

array - the list you want to sort

sortBy - what you want to sort the list by

ascending - do you want ascending order

nullsFirst - do you want nulls first

sort

public static void sort(List list)

Sorts a list based on the natural ascending order. This puts null values last.

Parameters:

list - the list you want to sort.

sort

public static <T> void sort(T[] array)

Sorts a array based on the natural ascending order. This puts null values last.

Parameters:

array - the list you want to sort.

sort

public static <T> Collection<T> sort(Class<T> componentType,
                     Collection<T> collection)

Sorts a collection based on the natural ascending order. This puts null values last.

Parameters:

collection - the list you want to sort.

sort

public static <T> Iterable<T> sort(Class<T> componentType,
                   Iterable<T> iterable)

Sorts a iterable based on the natural ascending order. This puts null values last.

Parameters:

iterable - the list you want to sort.

sortNullsFirst

public static void sortNullsFirst(List list)

Sorts a list based on the natural ascending order and puts null values first.

Parameters:

list - the list you want to sort.

sortNullsFirst

public static <T> void sortNullsFirst(T[] array)

Sorts an array based on the natural ascending order and puts null values first.

Parameters:

array - the list you want to sort.

sortNullsFirst

public static <T> Collection<T> sortNullsFirst(Class<T> componentType,
                               Collection<T> collection)

Sorts a collection based on the natural ascending order. This puts null values first.

Parameters:

collection - the collection you want to sort.

sortNullsFirst

public static <T> Iterable<T> sortNullsFirst(Class<T> componentType,
                             Iterable<T> iterable)

Sorts an iterable based on the natural ascending order. This puts null values first.

Parameters:

iterable - the list you want to sort.

sortDesc

public static void sortDesc(List list)

Sorts a list based on the natural order descending order. This puts null values last.

Parameters:

list - the list you want to sort.

sortDesc

public static <T> void sortDesc(T[] array)

Sorts a array based on the natural order descending order. This puts null values last.

Parameters:

array - the list you want to sort.

sortDesc

public static <T> Iterable<T> sortDesc(Class<T> componentType,
                       Iterable<T> iterable)

Sorts a iterable based on the natural descending order. This puts null values last.

Parameters:

iterable - the iterable you want to sort.

sortDesc

public static <T> Collection<T> sortDesc(Class<T> componentType,
                         Collection<T> collection)

Sorts a collection based on the natural descending order. This puts null values last.

Parameters:

collection - the collection you want to sort.

sortDescNullsFirst

public static void sortDescNullsFirst(List list)

Sorts a list based on the natural order descending order. This puts null values first.

Parameters:

list - the list you want to sort.

sortDescNullsFirst

public static <T> void sortDescNullsFirst(T[] array)

Sorts a array based on the natural order descending order. This puts null values first.

Parameters:

array - the list you want to sort.

sortDescNullsFirst

public static <T> Iterable<T> sortDescNullsFirst(Class<T> componentType,
                                 Iterable<T> iterable)

Sorts a iterable based on the natural descending order. This puts null values first.

Parameters:

iterable - the iterable you want to sort.

sortDescNullsFirst

public static <T> Collection<T> sortDescNullsFirst(Class<T> componentType,
                                   Collection<T> collection)

Sorts a collection based on the natural descending order. This puts null values first.

Parameters:

collection - the collection you want to sort.

sort

public static void sort(List list,
        String sortBy)

Sorts lists ascending Nulls last.

Parameters:

list - the list you want to sort

sortBy - what you want to sort the list by

sort

public static <T> void sort(T[] array,
            String sortBy)

Sorts array ascending Nulls last.

Parameters:

array - the list you want to sort

sortBy - what you want to sort the array by

sort

public static <T> Iterable<T> sort(Class<T> componentType,
                   Iterable<T> iterable,
                   String sortBy)

Sorts iterable ascending Nulls last.

Parameters:

iterable - the list you want to sort

sortBy - what you want to sort the array by

sort

public static <T> Collection<T> sort(Class<T> componentType,
                     Collection<T> collection,
                     String sortBy)

Sorts collection ascending Nulls last.

Parameters:

collection - the list you want to sort

sortBy - what you want to sort the array by

sortNullsFirst

public static void sortNullsFirst(List list,
                  String sortBy)

Sorts lists Ascending Null first Nulls first.

Parameters:

list - the list you want to sort

sortBy - what you want to sort the list by

sortNullsFirst

public static <T> void sortNullsFirst(T[] array,
                      String sortBy)

Sorts array ascending Nulls first.

Parameters:

array - the list you want to sort

sortBy - what you want to sort the array by

sortNullsFirst

public static <T> Iterable<T> sortNullsFirst(Class<T> componentType,
                             Iterable<T> iterable,
                             String sortBy)

Sorts iterable ascending Nulls first.

Parameters:

iterable - the list you want to sort

sortBy - what you want to sort the array by

sortNullsFirst

public static <T> Collection<T> sortNullsFirst(Class<T> componentType,
                               Collection<T> collection,
                               String sortBy)

Sorts collection ascending Nulls first.

Parameters:

collection - the list you want to sort

sortBy - what you want to sort the array by

sortDesc

public static void sortDesc(List list,
            String sortBy)

Sorts lists Descending

Parameters:

list - the list you want to sort

sortBy - what you want to sort the list by

sortDesc

public static <T> void sortDesc(T[] array,
                String sortBy)

Sorts array Descending Nulls last.

Parameters:

array - the list you want to sort

sortBy - what you want to sort the array by

sortDesc

public static <T> Iterable<T> sortDesc(Class<T> componentType,
                       Iterable<T> iterable,
                       String sortBy)

Sorts iterable ascending Nulls last.

Parameters:

iterable - the list you want to sort

sortBy - what you want to sort the array by

sortDesc

public static <T> Collection<T> sortDesc(Class<T> componentType,
                         Collection<T> collection,
                         String sortBy)

Sorts collection ascending Nulls last.

Parameters:

collection - the list you want to sort

sortBy - what you want to sort the array by

sortDescNullsFirst

public static void sortDescNullsFirst(List list,
                      String sortBy)

Sorts lists Descending

Parameters:

list - the list you want to sort

sortBy - what you want to sort the list by

sortDescNullsFirst

public static <T> void sortDescNullsFirst(T[] array,
                          String sortBy)

Sorts array Descending Nulls first.

Parameters:

array - the list you want to sort

sortBy - what you want to sort the array by

sortDescNullsFirst

public static <T> Iterable<T> sortDescNullsFirst(Class<T> componentType,
                                 Iterable<T> iterable,
                                 String sortBy)

Sorts iterable ascending Nulls first.

Parameters:

iterable - the list you want to sort

sortBy - what you want to sort the array by

sortDescNullsFirst

public static <T> Collection<T> sortDescNullsFirst(Class<T> componentType,
                                   Collection<T> collection,
                                   String sortBy)

Sorts collection ascending Nulls first.

Parameters:

collection - the list you want to sort

sortBy - what you want to sort the array by

universalComparator

public static Comparator universalComparator(FieldAccess field,
                             boolean ascending,
                             boolean nullsFirst)

This creates the universal comparator object which is used by the sort work horse.

Parameters:

field - The field we are sorting on.

ascending - if this should be ascending or descending.

Returns:

thisUniversalComparator

public static Comparator thisUniversalComparator(boolean ascending,
                                 boolean nullsFirst)

This creates the universal comparator object used for "this".

Parameters:

ascending - if this should be ascending or descending.

Returns:

compare

public static int compare(Object value1,
          Object value2)

This compares two values.

Parameters:

value1 - value1

value2 - value2

Returns:

compare

public static int compare(Object value1,
          Object value2,
          boolean nullsLast)

This compares two values. If the objects are strings (CharSequence) they are always compared lexicographically. If the objects are comparable they are always compared using a natural order.

Parameters:

value1 - value1

value2 - value2

nullsLast - put nulls last

Returns: