ListExtensions (silly-collections 4.22.0 API)

java.lang.Object
- de.alpharogroup.collections.list.ListExtensions

```
public class ListExtensions
extends Object
```
Extensions class for use with List objects.

Version:

1.0

Author:

Asterios Raptis

Constructor Summary

Constructors
Constructor and Description

ListExtensions()

Constructors
Constructor and Description
`ListExtensions()`

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static <T> boolean`	`containAtleastOneObject(List<T> toSearch, List<T> search)` This Method look in the List toSearch if at least one Object exists in the List search.
`static <T> T`	`getFirst(List<T> list)` Gets the first object from the given List.
`static <T> T`	`getLast(List<T> list)` Gets the last object from the given List.
`static <T> ModifiedCollections<T>`	`getModifiedCollections(Collection<T> previous, Collection<T> next)` Gets the modified lists. finding from an old list which elements have been removed and which have been added.
`static <T> List<T>`	`getSameElementsFromLists(List<T> toSearch, List<T> search)` The Method looks at both List and if they have same objects they are added to one List and will returns the result.
`static <T> boolean`	`isEmpty(List<T> list)` Checks if a List is null or empty.
`static <T> boolean`	`isFirst(List<T> list, T element)` Checks if the given element is the first in the given list.
`static <T> boolean`	`isLast(List<T> list, T element)` Checks if the given element is the last in the given list.
`static <T> boolean`	`isNotEmpty(List<T> list)` Checks if the given List is not null or empty.
`static <T> List<T>`	`newArrayList(Collection<T> collection, T... elements)` Factory method for create new `ArrayList` from the given optional collection and the given optional elements.
`static <T> List<T>`	`newArrayList(int initialCapacity)` Factory method for create new `ArrayList` and returns as `List`.
`static <T> List<T>`	`newArrayList(T... elements)` Factory method for create new `ArrayList` from the given optional elements.
`static Integer[]`	`newRangeArray(int start, int end)` Creates a new `Integer` array with the given range that is defined through start and end.
`static List<Integer>`	`newRangeList(int start, int end)` Creates a new `Integer` `List` with the given range that is defined through start and end.
`static <T> void`	`printCollection(Collection<T> collection)` Helper-Method for printing a Collection in the console.
`static <T> T`	`removeFirst(List<T> list)` Removes the first object from the given List.
`static <T> T`	`removeLast(List<T> list)` Removes the last object from the given List.
`static <T> List<T>`	`removeLastValues(ArrayList<T> v, int remove)` The Method removeLastValues(ArrayList, int) remove the last Values.
`static <T> List<T>`	`revertOrder(List<T> listToRevert)` Reverts the order from the given List.
`static <T> void`	`shuffle(List<T> source, List<T> destination, int[] selectedElements)` Shuffle selected elements in the source list to the destination list from the given indexes in the array selectedElements.
`static <T> void`	`sortByProperty(List<T> list, String property, boolean ascending)` Sort over the given property.
`static <T> List<List<T>>`	`splitListToParts(List<T> list, int times)` Splits the List to Parts to the specified times.
`static <T> List<List<T>>`	`splitSetToParts(Set<T> set, int times)` Splits the Set to Parts to the specified times.
`static <T> List<T>`	`toList(Enumeration<T> enumaration)` Converts the given enumaration to a Vector.
`static <T> List<T>`	`toList(Set<T> set)` Converts the given `Set` to a list.
`static <T> Object[]`	`toObjectArray(T... t)` Converts the given parameters to an object array.
`static <T> Vector<T>`	`toVector(Enumeration<T> enumaration)` Deprecated. use instead VectorExtensions.toVector

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ListExtensions
```
public ListExtensions()
```
- Method Detail
  - containAtleastOneObject
```
public static <T> boolean containAtleastOneObject(List<T> toSearch,
                                                  List<T> search)
```
    This Method look in the List toSearch if at least one Object exists in the List search.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    toSearch - The List to search.
    
    search - The List to inspect.
    
    Returns:
    
    Returns true if there is at least one Object equal from the two List otherwise false.
  - getFirst
```
public static <T> T getFirst(List<T> list)
```
    Gets the first object from the given List.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    list - the List.
    
    Returns:
    
    Returns the first object from the given List or null if the List is empty or null.
  - getLast
```
public static <T> T getLast(List<T> list)
```
    Gets the last object from the given List.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    list - the List.
    
    Returns:
    
    Returns the last object from the given List or null if the List is empty or null.
  - getModifiedCollections
```
public static <T> ModifiedCollections<T> getModifiedCollections(Collection<T> previous,
                                                                Collection<T> next)
```
    Gets the modified lists. finding from an old list which elements have been removed and which have been added.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    previous - the previous collection i.e. the collection from database.
    
    next - the next collection i.e. the current collection in the view.
    
    Returns:
    
    's the ModifiedLists in which the lists are keeped.
  - getSameElementsFromLists
```
public static <T> List<T> getSameElementsFromLists(List<T> toSearch,
                                                   List<T> search)
```
    The Method looks at both List and if they have same objects they are added to one List and will returns the result.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    toSearch - The List to search.
    
    search - The List to inspect.
    
    Returns:
    
    The List with the same objects.
  - isEmpty
```
public static <T> boolean isEmpty(List<T> list)
```
    Checks if a List is null or empty.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    list - The List to check.
    
    Returns:
    
    true if the list is null or empty otherwise false.
  - isFirst
```
public static <T> boolean isFirst(List<T> list,
                                  T element)
```
    Checks if the given element is the first in the given list.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    list - the list
    
    element - the element
    
    Returns:
    
    true if the given element is the first otherwise false
  - isLast
```
public static <T> boolean isLast(List<T> list,
                                 T element)
```
    Checks if the given element is the last in the given list.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    list - the list
    
    element - the element
    
    Returns:
    
    true if the given element is the last otherwise false
  - isNotEmpty
```
public static <T> boolean isNotEmpty(List<T> list)
```
    Checks if the given List is not null or empty.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    list - The List to check.
    
    Returns:
    
    true if the list is null or empty otherwise false.
  - newArrayList
```
@SafeVarargs
public static <T> List<T> newArrayList(Collection<T> collection,
                                                    T... elements)
```
    Factory method for create new ArrayList from the given optional collection and the given optional elements.
    
    Type Parameters:
    
    T - the generic type of the elements
    
    Parameters:
    
    collection - the optional collection that will be added to the new list
    
    elements - the optional elements to be added in the new ArrayList.
    
    Returns:
    
    the new ArrayList as List.
  - newArrayList
```
public static <T> List<T> newArrayList(int initialCapacity)
```
    Factory method for create new ArrayList and returns as List.
    
    Type Parameters:
    
    T - the generic type of the elements
    
    Parameters:
    
    initialCapacity - the initial capacity
    
    Returns:
    
    the new ArrayList as List.
  - newArrayList
```
@SafeVarargs
public static <T> List<T> newArrayList(T... elements)
```
    Factory method for create new ArrayList from the given optional elements.
    
    Type Parameters:
    
    T - the generic type of the elements
    
    Parameters:
    
    elements - the elements to add in the new ArrayList.
    
    Returns:
    
    the new ArrayList as List.
  - newRangeArray
```
public static Integer[] newRangeArray(int start,
                                      int end)
```
    Creates a new Integer array with the given range that is defined through start and end. For instance if the start is 5 and the end is 9 the resulted array will be [5,6,7,8,9]
    
    Parameters:
    
    start - The number to start
    
    end - The number to end minus one
    
    Returns:
    
    the generated Integer array
  - newRangeList
```
public static List<Integer> newRangeList(int start,
                                         int end)
```
    Creates a new Integer List with the given range that is defined through start and end. For instance if the start is 5 and the end is 9 the resulted List will be [5,6,7,8,9]
    
    Parameters:
    
    start - The number to start
    
    end - The number to end minus one
    
    Returns:
    
    the generated Integer List
  - printCollection
```
public static <T> void printCollection(Collection<T> collection)
```
    Helper-Method for printing a Collection in the console.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    collection - The Collection to print.
  - removeFirst
```
public static <T> T removeFirst(List<T> list)
```
    Removes the first object from the given List.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    list - the List.
    
    Returns:
    
    Removes and returns the first object from the given List or null if the List is empty or null.
  - removeLast
```
public static <T> T removeLast(List<T> list)
```
    Removes the last object from the given List.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    list - the List.
    
    Returns:
    
    Removes and returns the last object from the given List or null if the List is empty or null.
  - removeLastValues
```
public static <T> List<T> removeLastValues(ArrayList<T> v,
                                           int remove)
```
    The Method removeLastValues(ArrayList, int) remove the last Values.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    v - The Vector with the received Messages.
    
    remove - How much to remove.
    
    Returns:
    
    the list
  - revertOrder
```
public static <T> List<T> revertOrder(List<T> listToRevert)
```
    Reverts the order from the given List.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    listToRevert - The List to revert.
    
    Returns:
    
    The reverted List.
  - shuffle
```
public static <T> void shuffle(List<T> source,
                               List<T> destination,
                               int[] selectedElements)
```
    Shuffle selected elements in the source list to the destination list from the given indexes in the array selectedElements.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    source - the source
    
    destination - the destination
    
    selectedElements - the selected elements
  - sortByProperty
```
public static <T> void sortByProperty(List<T> list,
                                      String property,
                                      boolean ascending)
```
    Sort over the given property. Note: the property should be implement the Comparable interface.
    
    Type Parameters:
    
    T - the generic type of the list
    
    Parameters:
    
    list - the list to sort.
    
    property - the property to sort.
    
    ascending - if true the sort will be ascending ohterwise descending.
  - splitListToParts
```
public static <T> List<List<T>> splitListToParts(List<T> list,
                                                 int times)
```
    Splits the List to Parts to the specified times.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    list - The List to Split
    
    times - How to split.
    
    Returns:
    
    An List with the Splitted Parts
  - splitSetToParts
```
public static <T> List<List<T>> splitSetToParts(Set<T> set,
                                                int times)
```
    Splits the Set to Parts to the specified times.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    set - The Set to Split
    
    times - How to split.
    
    Returns:
    
    An ArrayList with the Splitted Parts
  - toList
```
public static <T> List<T> toList(Enumeration<T> enumaration)
```
    Converts the given enumaration to a Vector.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    enumaration - The Enumeration to convert.
    
    Returns:
    
    A new Vector with the content of the given Enumeration.
  - toList
```
public static <T> List<T> toList(Set<T> set)
```
    Converts the given Set to a list.
    
    Type Parameters:
    
    T - the generic type of the elements
    
    Parameters:
    
    set - the set
    
    Returns:
    
    A new list
  - toObjectArray
```
@SafeVarargs
public static <T> Object[] toObjectArray(T... t)
```
    Converts the given parameters to an object array.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    t - The objects that will be in the returned object array
    
    Returns:
    
    An Object array.
  - toVector
```
@Deprecated
public static <T> Vector<T> toVector(Enumeration<T> enumaration)
```
    Deprecated. use instead VectorExtensions.toVector
    
    Converts the given enumaration to a Vector.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    enumaration - The Enumeration to convert.
    
    Returns:
    
    A new Vector with the content of the given Enumeration.

Class ListExtensions

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ListExtensions

Method Detail

containAtleastOneObject

getFirst

getLast

getModifiedCollections

getSameElementsFromLists

isEmpty

isFirst

isLast

isNotEmpty

newArrayList

newArrayList

newArrayList

newRangeArray

newRangeList

printCollection

removeFirst

removeLast

removeLastValues

revertOrder

shuffle

sortByProperty

splitListToParts

splitSetToParts

toList

toList

toObjectArray

toVector