com.cinchapi.concourse.util

Class Transformers

Object

Transformers

public final class Transformers
extends Object

A collection of tools used to transform objects in a collection using a transformation Function.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Transformers.LazyTransformSet<V1,V2> A Set that transform values from an original set of type V1 into values of type V2 on-the-fly using a transformation Function.

Constructor Summary

Constructors

Constructor and Description
Transformers()

Method Summary

Modifier and Type	Method and Description
static <F,V> V[]	transformArray(F[] original, Function<? super F,? extends V> function, Class<V> vClass) Return an array whose content is equal to the content of original after it has been transformed by function.
static <K,K2,V> Map<K2,V>	transformMap(Map<K,V> original, Function<? super K,? extends K2> function) Return a Map whose keys are equal to the those in original after it has been transformed by function.
static <K1,V1,K2,V2> Map<K2,V2>	transformMapEntries(Map<K1,V1> original, Function<K1,K2> keyFunction, Function<V1,V2> valueFunction) Return a new Map where the key and value of each entry is transformed by the keyFunction and valueFunction respectively.
static <K,K2,V,V2> Map<K2,Set<V2>>	transformMapSet(Map<K,Set<V>> original, Function<? super K,? extends K2> keys, Function<? super V,? extends V2> values) Transform the keys in original with the keys function and each of the values with the values function and return the result.
static <K,V,V2> Map<K,V2>	transformMapValues(Map<K,V> original, Function<V,V2> function) Transform each of the values in the original with the function.
static <F,V> Set<V>	transformSet(Set<F> original, Function<? super F,? extends V> function) Populate a Set with the items in original after applying function.
static <V1,V2> Set<V2>	transformSetLazily(Set<V1> original, Function<V1,V2> function) Return a Set that lazily populates a new set with items from the original after applying the transformation function.
static <K,K2,V,V2> Map<K2,Set<V2>>	transformTreeMapSet(Map<K,Set<V>> original, Function<? super K,? extends K2> keys, Function<? super V,? extends V2> values, Comparator<K2> sorter) Transform the keys in original with the keys function and each of the values with the values function and return the map result that is sorted according to the sorter.

Methods inherited from class Object

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

Constructor Detail

Transformers

public Transformers()

Method Detail

transformArray

public static <F,V> V[] transformArray(F[] original,
                                       Function<? super F,? extends V> function,
                                       Class<V> vClass)

Return an array whose content is equal to the content of original after it has been transformed by function.

Parameters:

original -

function -

vClass - - the class object for the type to which the items in original will be transformed

Returns:

the transformed array

transformMap

public static <K,K2,V> Map<K2,V> transformMap(Map<K,V> original,
                                              Function<? super K,? extends K2> function)

Return a Map whose keys are equal to the those in original after it has been transformed by function.

WARNING: There is the potential for data loss in the event that function returns duplicate transformed results for items in original.

Parameters:

original -

function -

Returns:

the transformed Map

transformMapSet

public static <K,K2,V,V2> Map<K2,Set<V2>> transformMapSet(Map<K,Set<V>> original,
                                                          Function<? super K,? extends K2> keys,
                                                          Function<? super V,? extends V2> values)

Transform the keys in original with the keys function and each of the values with the values function and return the result.

WARNING: There is the potential for data loss in the event that function returns duplicate transformed results for items in original.

Parameters:

original -

keys -

values -

Returns:

the transformed Map

transformMapValues

public static <K,V,V2> Map<K,V2> transformMapValues(Map<K,V> original,
                                                    Function<V,V2> function)

Transform each of the values in the original with the function.

Parameters:

original -

function -

Returns:

the transformed Map

transformMapEntries

public static <K1,V1,K2,V2> Map<K2,V2> transformMapEntries(Map<K1,V1> original,
                                                           Function<K1,K2> keyFunction,
                                                           Function<V1,V2> valueFunction)

Return a new Map where the key and value of each entry is transformed by the keyFunction and valueFunction respectively.

Parameters:

original - the original map in which the transformations are performed

keyFunction - the function to transform each entry key

valueFunction - the function to transform each entry value

Returns:

the transformed Map

transformSet

public static <F,V> Set<V> transformSet(Set<F> original,
                                        Function<? super F,? extends V> function)

Populate a Set with the items in original after applying function.

WARNING: There is the potential for data loss in the event that function returns duplicate transformed results for items in original.

Parameters:

original - the Set to transform

function - the transformation Function

Returns:

the transformed Set

transformSetLazily

public static <V1,V2> Set<V2> transformSetLazily(Set<V1> original,
                                                 Function<V1,V2> function)

Return a Set that lazily populates a new set with items from the original after applying the transformation function.

Parameters:

original - the Set to transform

function - the transformation Function

Returns:

the transformed Set

transformTreeMapSet

public static <K,K2,V,V2> Map<K2,Set<V2>> transformTreeMapSet(Map<K,Set<V>> original,
                                                              Function<? super K,? extends K2> keys,
                                                              Function<? super V,? extends V2> values,
                                                              Comparator<K2> sorter)

Transform the keys in original with the keys function and each of the values with the values function and return the map result that is sorted according to the sorter.

WARNING: There is the potential for data loss in the event that function returns duplicate transformed results for items in original.

Parameters:

original -

keys -

values -

sorter -

Returns:

the transformed TreeMap