com.phloc.commons.convert.collections

Class ContainerConversionHelper

java.lang.Object

com.phloc.commons.convert.collections.ContainerConversionHelper

@Immutable
public final class ContainerConversionHelper
extends Object

This utility class helps applying conversions onto collections.

Author:

Philip Helger

Method Summary

Methods

Modifier and Type	Method and Description
static <SRCTYPE,DSTTYPE> Iterator<DSTTYPE>	getIterator(Iterable<SRCTYPE> aCont, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE extends Comparable<? super DSTTYPE>> List<DSTTYPE>	getSorted(Iterable<? extends SRCTYPE> aCont, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter) Convert the given iterator to a sorted list.
static <SRCTYPE,DSTTYPE> List<DSTTYPE>	getSorted(Iterable<? extends SRCTYPE> aCont, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter, Comparator<? super DSTTYPE> aComparator) Convert the given iterator to a sorted list.
static <SRCTYPE,DSTTYPE extends Comparable<? super DSTTYPE>> List<DSTTYPE>	getSorted(Iterator<? extends SRCTYPE> it, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter) Convert the given iterator to a sorted list.
static <SRCTYPE,DSTTYPE> List<DSTTYPE>	getSorted(Iterator<? extends SRCTYPE> it, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter, Comparator<? super DSTTYPE> aComparator) Convert the given iterator to a sorted list.
static <SRCTYPE,DSTTYPE> List<DSTTYPE>	newList(Iterable<? extends SRCTYPE> aCont, IFilter<? super SRCTYPE> aFilter, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> List<DSTTYPE>	newList(Iterable<? extends SRCTYPE> aCont, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> List<DSTTYPE>	newList(SRCTYPE[] aCont, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> Set<DSTTYPE>	newOrderedSet(Iterable<? extends SRCTYPE> aCont, IFilter<? super SRCTYPE> aFilter, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> Set<DSTTYPE>	newOrderedSet(Iterable<? extends SRCTYPE> aCont, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> Set<DSTTYPE>	newOrderedSet(Iterator<? extends SRCTYPE> it, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> Set<DSTTYPE>	newSet(Iterable<? extends SRCTYPE> aCont, IFilter<? super SRCTYPE> aFilter, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> Set<DSTTYPE>	newSet(Iterable<? extends SRCTYPE> aCont, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> Set<DSTTYPE>	newSet(Iterator<? extends SRCTYPE> it, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> List<DSTTYPE>	newUnmodifiableList(Iterable<? extends SRCTYPE> aCont, IFilter<? super SRCTYPE> aFilter, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> List<DSTTYPE>	newUnmodifiableList(Iterable<? extends SRCTYPE> aCont, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> List<DSTTYPE>	newUnmodifiableList(SRCTYPE[] aCont, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> Set<DSTTYPE>	newUnmodifiableOrderedSet(Iterable<? extends SRCTYPE> aCont, IFilter<? super SRCTYPE> aFilter, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> Set<DSTTYPE>	newUnmodifiableOrderedSet(Iterable<? extends SRCTYPE> aCont, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> Set<DSTTYPE>	newUnmodifiableOrderedSet(Iterator<? extends SRCTYPE> it, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> Set<DSTTYPE>	newUnmodifiableSet(Iterable<? extends SRCTYPE> aCont, IFilter<? super SRCTYPE> aFilter, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> Set<DSTTYPE>	newUnmodifiableSet(Iterable<? extends SRCTYPE> aCont, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)
static <SRCTYPE,DSTTYPE> Set<DSTTYPE>	newUnmodifiableSet(Iterator<? extends SRCTYPE> it, IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

Methods inherited from class java.lang.Object

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

Method Detail

newSet

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE> Set<DSTTYPE> newSet(@Nonnull
                                                               Iterator<? extends SRCTYPE> it,
                                                               @Nonnull
                                                               IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newSet

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE> Set<DSTTYPE> newSet(@Nonnull
                                                               Iterable<? extends SRCTYPE> aCont,
                                                               @Nonnull
                                                               IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newSet

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE> Set<DSTTYPE> newSet(@Nonnull
                                                               Iterable<? extends SRCTYPE> aCont,
                                                               @Nonnull
                                                               IFilter<? super SRCTYPE> aFilter,
                                                               @Nonnull
                                                               IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newUnmodifiableSet

@Nonnull
@ReturnsImmutableObject
public static <SRCTYPE,DSTTYPE> Set<DSTTYPE> newUnmodifiableSet(@Nonnull
                                                                               Iterator<? extends SRCTYPE> it,
                                                                               @Nonnull
                                                                               IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newUnmodifiableSet

@Nonnull
@ReturnsImmutableObject
public static <SRCTYPE,DSTTYPE> Set<DSTTYPE> newUnmodifiableSet(@Nonnull
                                                                               Iterable<? extends SRCTYPE> aCont,
                                                                               @Nonnull
                                                                               IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newUnmodifiableSet

@Nonnull
@ReturnsImmutableObject
public static <SRCTYPE,DSTTYPE> Set<DSTTYPE> newUnmodifiableSet(@Nonnull
                                                                               Iterable<? extends SRCTYPE> aCont,
                                                                               @Nonnull
                                                                               IFilter<? super SRCTYPE> aFilter,
                                                                               @Nonnull
                                                                               IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newOrderedSet

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE> Set<DSTTYPE> newOrderedSet(@Nonnull
                                                                      Iterator<? extends SRCTYPE> it,
                                                                      @Nonnull
                                                                      IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newOrderedSet

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE> Set<DSTTYPE> newOrderedSet(@Nonnull
                                                                      Iterable<? extends SRCTYPE> aCont,
                                                                      @Nonnull
                                                                      IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newOrderedSet

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE> Set<DSTTYPE> newOrderedSet(@Nonnull
                                                                      Iterable<? extends SRCTYPE> aCont,
                                                                      @Nonnull
                                                                      IFilter<? super SRCTYPE> aFilter,
                                                                      @Nonnull
                                                                      IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newUnmodifiableOrderedSet

@Nonnull
@ReturnsImmutableObject
public static <SRCTYPE,DSTTYPE> Set<DSTTYPE> newUnmodifiableOrderedSet(@Nonnull
                                                                                      Iterator<? extends SRCTYPE> it,
                                                                                      @Nonnull
                                                                                      IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newUnmodifiableOrderedSet

@Nonnull
@ReturnsImmutableObject
public static <SRCTYPE,DSTTYPE> Set<DSTTYPE> newUnmodifiableOrderedSet(@Nonnull
                                                                                      Iterable<? extends SRCTYPE> aCont,
                                                                                      @Nonnull
                                                                                      IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newUnmodifiableOrderedSet

@Nonnull
@ReturnsImmutableObject
public static <SRCTYPE,DSTTYPE> Set<DSTTYPE> newUnmodifiableOrderedSet(@Nonnull
                                                                                      Iterable<? extends SRCTYPE> aCont,
                                                                                      @Nonnull
                                                                                      IFilter<? super SRCTYPE> aFilter,
                                                                                      @Nonnull
                                                                                      IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newList

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE> List<DSTTYPE> newList(@Nullable
                                                                 Iterable<? extends SRCTYPE> aCont,
                                                                 @Nonnull
                                                                 IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newList

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE> List<DSTTYPE> newList(@Nullable
                                                                 SRCTYPE[] aCont,
                                                                 @Nonnull
                                                                 IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newList

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE> List<DSTTYPE> newList(@Nullable
                                                                 Iterable<? extends SRCTYPE> aCont,
                                                                 @Nonnull
                                                                 IFilter<? super SRCTYPE> aFilter,
                                                                 @Nonnull
                                                                 IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newUnmodifiableList

@Nonnull
@ReturnsImmutableObject
public static <SRCTYPE,DSTTYPE> List<DSTTYPE> newUnmodifiableList(@Nullable
                                                                                 Iterable<? extends SRCTYPE> aCont,
                                                                                 @Nonnull
                                                                                 IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newUnmodifiableList

@Nonnull
@ReturnsImmutableObject
public static <SRCTYPE,DSTTYPE> List<DSTTYPE> newUnmodifiableList(@Nullable
                                                                                 SRCTYPE[] aCont,
                                                                                 @Nonnull
                                                                                 IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

newUnmodifiableList

@Nonnull
@ReturnsImmutableObject
public static <SRCTYPE,DSTTYPE> List<DSTTYPE> newUnmodifiableList(@Nullable
                                                                                 Iterable<? extends SRCTYPE> aCont,
                                                                                 @Nonnull
                                                                                 IFilter<? super SRCTYPE> aFilter,
                                                                                 @Nonnull
                                                                                 IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

getSorted

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE extends Comparable<? super DSTTYPE>> List<DSTTYPE> getSorted(@Nonnull
                                                                                                       Iterator<? extends SRCTYPE> it,
                                                                                                       @Nonnull
                                                                                                       IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

Convert the given iterator to a sorted list.

Type Parameters:

SRCTYPE - The type of elements to iterate (source).

DSTTYPE - The type of elements to return (destination).

Parameters:

it - Input iterator. May not be null.

aConverter - The converter to be used. May not be null.

Returns:

a non-null ArrayList based on the results of ContainerHelper.getSortedInline(List).

getSorted

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE> List<DSTTYPE> getSorted(@Nonnull
                                                                   Iterator<? extends SRCTYPE> it,
                                                                   @Nonnull
                                                                   IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter,
                                                                   @Nonnull
                                                                   Comparator<? super DSTTYPE> aComparator)

Convert the given iterator to a sorted list.

Type Parameters:

SRCTYPE - The type of elements to iterate (source).

DSTTYPE - The type of elements to return (destination).

Parameters:

it - Input iterator. May not be null.

aConverter - The converter to be used. May not be null.

aComparator - The comparator to use. May not be null.

Returns:

a non-null ArrayList based on the results of ContainerHelper.getSortedInline(List, Comparator).

getSorted

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE extends Comparable<? super DSTTYPE>> List<DSTTYPE> getSorted(@Nonnull
                                                                                                       Iterable<? extends SRCTYPE> aCont,
                                                                                                       @Nonnull
                                                                                                       IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)

Convert the given iterator to a sorted list.

Type Parameters:

SRCTYPE - The type of elements to iterate (source).

DSTTYPE - The type of elements to return (destination).

Parameters:

aCont - Input container. May not be null.

aConverter - The converter to be used. May not be null.

Returns:

a non-null ArrayList based on the results of ContainerHelper.getSortedInline(List).

getSorted

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,DSTTYPE> List<DSTTYPE> getSorted(@Nonnull
                                                                   Iterable<? extends SRCTYPE> aCont,
                                                                   @Nonnull
                                                                   IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter,
                                                                   @Nonnull
                                                                   Comparator<? super DSTTYPE> aComparator)

Convert the given iterator to a sorted list.

Type Parameters:

SRCTYPE - The type of elements to iterate (source).

DSTTYPE - The type of elements to return (destination).

Parameters:

aCont - Input iterator. May not be null.

aConverter - The converter to be used. May not be null.

aComparator - The comparator to use. May not be null.

Returns:

a non-null ArrayList based on the results of ContainerHelper.getSortedInline(List, Comparator).

getIterator

@Nonnull
public static <SRCTYPE,DSTTYPE> Iterator<DSTTYPE> getIterator(@Nonnull
                                                      Iterable<SRCTYPE> aCont,
                                                      @Nonnull
                                                      IUnidirectionalConverter<? super SRCTYPE,? extends DSTTYPE> aConverter)