nc.ird.module.utils

Class CollectionTools

java.lang.Object

nc.ird.module.utils.CollectionTools

public final class CollectionTools
extends Object

Tools for collections

Author:

Mickael Tricot, Adrien Cheype

Method Summary

Methods

Modifier and Type	Method and Description
static <T> boolean	containsOnlySameValue(Collection<T> collection, T value) Test if all collection's values contain always the same value
static boolean	containsWithValue(Collection<? extends Object> collection, String pathToProperty, BeanTools.AccessType accessType, Object value) Check in a collection of beans if a property has a specific value
static int	countWithValue(Collection<? extends Object> collection, String pathToProperty, BeanTools.AccessType accessType, Object value) Count in a collection of beans the number of beans which have a specific value
static <T> T	findWithValue(List<T> collection, String pathToProperty, BeanTools.AccessType accessType, Object value) Get from a beans collection the first bean which have a property with a specific value.
static <T> Set<T>	intersect(Set<T> s1, Set<T> s2) Intersection of two sets
static boolean	removeAllWithValue(Collection<? extends Object> collection, String pathToProperty, BeanTools.AccessType accessType, Collection<? extends Object> values) Remove in a collection of beans the beans which have a specifics values.
static boolean	removeWithValue(Collection<? extends Object> collection, String pathToProperty, BeanTools.AccessType accessType, Object value) Remove in a collection of beans the beans which have a specific value.
static <T> void	setter(Collection<T> collectionToWrite, Collection<T> collectionToRead) Setter for collections, preserving the instance
static List<Object>	valuesFromList(Collection<? extends Object> collection, String pathToProperty, BeanTools.AccessType accessType) Build a list from values properties of a bean list.

Methods inherited from class java.lang.Object

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

Method Detail

containsOnlySameValue

public static <T> boolean containsOnlySameValue(Collection<T> collection,
                                T value)

Test if all collection's values contain always the same value

Type Parameters:

T - Collection type

Parameters:

collection - Collection to parse

value - Value which is tested for the identity (may be null)

Returns:

The answer

intersect

public static <T> Set<T> intersect(Set<T> s1,
                   Set<T> s2)

Intersection of two sets

Type Parameters:

T - Set type

Parameters:

s1 - Set 1

s2 - Set 2

Returns:

Intersection

setter

public static <T> void setter(Collection<T> collectionToWrite,
              Collection<T> collectionToRead)

Setter for collections, preserving the instance

Type Parameters:

T - Collection type

Parameters:

collectionToWrite - Collection to write

collectionToRead - Collection to read

containsWithValue

public static boolean containsWithValue(Collection<? extends Object> collection,
                        String pathToProperty,
                        BeanTools.AccessType accessType,
                        Object value)

Check in a collection of beans if a property has a specific value

Parameters:

collection - The collection to parse

pathToProperty - The path to the tested bean property (for each bean in the collection), example : beanX.beanY.propZ

accessType - The access type to reach each property value

value - The value to find

Returns:

true if the value is found, otherwise false

countWithValue

public static int countWithValue(Collection<? extends Object> collection,
                 String pathToProperty,
                 BeanTools.AccessType accessType,
                 Object value)

Count in a collection of beans the number of beans which have a specific value

Parameters:

collection - The collection to parse

pathToProperty - The path to the tested bean property, example : beanX.beanY.propZ

accessType - The access type to reach each property value

value - The value to find

Returns:

The count result

findWithValue

public static <T> T findWithValue(List<T> collection,
                  String pathToProperty,
                  BeanTools.AccessType accessType,
                  Object value)

Get from a beans collection the first bean which have a property with a specific value. If the value is not found, return null

Type Parameters:

T - The beans class in the collection

Parameters:

collection - The collection to parse

pathToProperty - The path to the tested bean property, example : beanX.beanY.propZ

accessType - The access type to reach each property value

value - The value to find

Returns:

The bean with the specific value, null if not found

removeWithValue

public static boolean removeWithValue(Collection<? extends Object> collection,
                      String pathToProperty,
                      BeanTools.AccessType accessType,
                      Object value)

Remove in a collection of beans the beans which have a specific value. If the value is found, remove it and return true.

Parameters:

collection - The collection to parse

pathToProperty - The path to the tested bean property, example : beanX.beanY.propZ

accessType - The access type to reach each property value

value - The value to find

Returns:

true if found, false otherwise

removeAllWithValue

public static boolean removeAllWithValue(Collection<? extends Object> collection,
                         String pathToProperty,
                         BeanTools.AccessType accessType,
                         Collection<? extends Object> values)

Remove in a collection of beans the beans which have a specifics values. If on these values are found, remove them and return true.

Parameters:

collection - The collection to parse

pathToProperty - The path to the tested bean property, example : beanX.beanY.propZ

accessType - The access type to reach each property value

values - The values to find

Returns:

true if at least one value is found, false otherwise

valuesFromList

public static List<Object> valuesFromList(Collection<? extends Object> collection,
                          String pathToProperty,
                          BeanTools.AccessType accessType)

Build a list from values properties of a bean list. Ex : From a beans list which contains the property "name", you can build the list of these names.

Parameters:

collection - The beans list to parse

pathToProperty - The path to the bean property, example : beanX.beanY.propZ

accessType - The access type to reach each property value

Returns:

These values