org.pfsw.tools.cda.base.util

Class CollectionUtil

java.lang.Object

org.pfsw.util.CollectionUtil

org.pfsw.tools.cda.base.util.CollectionUtil

public class CollectionUtil
extends org.pfsw.util.CollectionUtil

Additional utilities for collections and arrays. Probably should be moved to superclass!

Nested Class Summary

Nested classes/interfaces inherited from class org.pfsw.util.CollectionUtil

org.pfsw.util.CollectionUtil.LocalStringPair

Field Summary

Fields inherited from class org.pfsw.util.CollectionUtil

EMPTY_INT_ARRAY, EMPTY_LIST, EMPTY_LONG_ARRAY, EMPTY_MAP, EMPTY_OBJECT_ARRAY, EMPTY_SET

Method Summary

Modifier and Type	Method and Description
<T> T[]	asArray(java.util.Collection<T> coll, java.lang.Class<T> elementType) Returns an array which has elements of the specified element type.
<T> java.util.Set<T>	asSet(T... objects) Returns a new HashSet initialized with the given objects.
<T> java.util.stream.Stream<T>	asStream(T[] array) Returns the given array of objects as stream.
static CollectionUtil	instance() Returns the only instance this class supports (design pattern "Singleton")
boolean	notAllAreNull(java.lang.Object... objects) Returns true if at least one object in the given array is not null.
<T> boolean	processAll(java.util.Collection<T> collection, InterruptableProcessor<T> processor) Calls the given processor for each element contained in the given collection, until either the processor returns false or the collection elements are all processed.
<T> boolean	processAll(T[] array, InterruptableProcessor<T> processor) Calls the given processor for each element contained in the given array, until either the processor returns false or the array elements are all processed.

Methods inherited from class org.pfsw.util.CollectionUtil

addAll, addAll, addAll, addAll, addAllNew, append, append, append, asEnumeration, asEnumeration, asIterator, asList, asList, asListType, asMap, asMap, contains, contains, contains, containsIdentical, convertCollectionElements, convertToList, convertToSet, copy, copy, copy, copy, copy, copyCollection, copyMap, copyPropertiesStartingWith, copyWithout, copyWithout, copyWithout, copyWithout, copyWithoutIdentical, createCollection, current, getFirstNonNull, indexOf, indexOf, indexOf, indexOfIdentical, indexOfObject, isAnyNull, isNoneNull, isNullOrEmpty, isNullOrEmpty, isNullOrEmpty, isNullOrEmpty, iterator, lastIndexOf, lastIndexOf, propertiesStartingWith, propertiesStartingWith, removeFromArray, removeNull, reverse, reverseCopy, splitToStringPair, toArray, toArray, toList

Methods inherited from class java.lang.Object

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

Method Detail

instance

public static CollectionUtil instance()

Returns the only instance this class supports (design pattern "Singleton")

asArray

public <T> T[] asArray(java.util.Collection<T> coll,
                       java.lang.Class<T> elementType)

Returns an array which has elements of the specified element type. If the collection is null then this method returns an empty array.
This method is better than java.util.Collection.toArray() because it returns an array of the desired type (elementType[]) rather than Object[]. It also just creates one new array instance with the correct size.

Parameters:

coll - The collection of objects to be put into the result array

elementType - The type of the array elements

Throws:

java.lang.ArrayStoreException - if any element in the collection is not of the same type as the element type

asStream

public <T> java.util.stream.Stream<T> asStream(T[] array)

Returns the given array of objects as stream.

asSet

public <T> java.util.Set<T> asSet(T... objects)

Returns a new HashSet initialized with the given objects.

notAllAreNull

public boolean notAllAreNull(java.lang.Object... objects)

Returns true if at least one object in the given array is not null.

processAll

public <T> boolean processAll(java.util.Collection<T> collection,
                              InterruptableProcessor<T> processor)

Calls the given processor for each element contained in the given collection, until either the processor returns false or the collection elements are all processed.

Parameters:

collection - A (maybe empty) collection of elements to process (must not be null).

processor - The processor to be called for each element of the collection (must not be null).

Returns:

true if processing has not been interrupted and should continue, otherwise false.

processAll

public <T> boolean processAll(T[] array,
                              InterruptableProcessor<T> processor)

Calls the given processor for each element contained in the given array, until either the processor returns false or the array elements are all processed.

Parameters:

array - A (maybe empty) array of elements to process (must not be null).

processor - The processor to be called for each element of the array (must not be null).

Returns:

true if processing has not been interrupted and should continue, otherwise false.