org.springframework.core

Class CollectionFactory

java.lang.Object

org.springframework.core.CollectionFactory

public abstract class CollectionFactory
extends Object

Factory for collections, being aware of Java 5 and Java 6 collections. Mainly for internal use within the framework.

The goal of this class is to avoid runtime dependencies on a specific Java version, while nevertheless using the best collection implementation that is available at runtime.

Since:

1.1.1

Author:

Juergen Hoeller, Arjen Poutsma

Constructor Summary

Constructors

Constructor and Description
CollectionFactory()

Method Summary

Modifier and Type	Method and Description
static <E> Collection<E>	createApproximateCollection(Object collection, int capacity) Create the most approximate collection for the given collection.
static <K,V> Map<K,V>	createApproximateMap(Object map, int capacity) Create the most approximate map for the given map.
static <E> Collection<E>	createCollection(Class<?> collectionClass, Class<?> elementType, int capacity) Create the most appropriate collection for the given collection type.
static <E> Collection<E>	createCollection(Class<?> collectionClass, int capacity) Create the most appropriate collection for the given collection type.
static <K,V> Map<K,V>	createMap(Class<?> mapClass, Class<?> keyType, int capacity) Create the most approximate map for the given map.
static <K,V> Map<K,V>	createMap(Class<?> mapClass, int capacity) Create the most approximate map for the given map.
static boolean	isApproximableCollectionType(Class<?> collectionType) Determine whether the given collection type is an approximable type, i.e.
static boolean	isApproximableMapType(Class<?> mapType) Determine whether the given map type is an approximable type, i.e.

Methods inherited from class java.lang.Object

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

Constructor Detail

CollectionFactory

public CollectionFactory()

Method Detail

isApproximableCollectionType

public static boolean isApproximableCollectionType(Class<?> collectionType)

Determine whether the given collection type is an approximable type, i.e. a type that createApproximateCollection(java.lang.Object, int) can approximate.

Parameters:

collectionType - the collection type to check

Returns:

true if the type is approximable, false if it is not

createApproximateCollection

public static <E> Collection<E> createApproximateCollection(Object collection,
                                                            int capacity)

Create the most approximate collection for the given collection.

Parameters:

collection - the original Collection object

capacity - the initial capacity

Returns:

the new Collection instance

See Also:

LinkedHashSet, TreeSet, EnumSet, ArrayList, LinkedList

createCollection

public static <E> Collection<E> createCollection(Class<?> collectionClass,
                                                 int capacity)

Create the most appropriate collection for the given collection type.

Delegates to createCollection(Class, Class, int) with a null element type.

Parameters:

collectionClass - the desired type of the target Collection

capacity - the initial capacity

Returns:

the new Collection instance

createCollection

public static <E> Collection<E> createCollection(Class<?> collectionClass,
                                                 Class<?> elementType,
                                                 int capacity)

Create the most appropriate collection for the given collection type.

Parameters:

collectionClass - the desired type of the target Collection

elementType - the collection's element type, or null if not known (note: only relevant for EnumSet creation)

capacity - the initial capacity

Returns:

the new Collection instance

Since:

4.1.3

See Also:

LinkedHashSet, TreeSet, EnumSet, ArrayList

isApproximableMapType

public static boolean isApproximableMapType(Class<?> mapType)

Determine whether the given map type is an approximable type, i.e. a type that createApproximateMap(java.lang.Object, int) can approximate.

Parameters:

mapType - the map type to check

Returns:

true if the type is approximable, false if it is not

createApproximateMap

public static <K,V> Map<K,V> createApproximateMap(Object map,
                                                  int capacity)

Create the most approximate map for the given map.

Parameters:

map - the original Map object

capacity - the initial capacity

Returns:

the new Map instance

See Also:

TreeMap, LinkedHashMap

createMap

public static <K,V> Map<K,V> createMap(Class<?> mapClass,
                                       int capacity)

Create the most approximate map for the given map.

Delegates to createMap(Class, Class, int) with a null key type.

Parameters:

mapClass - the desired type of the target Map

capacity - the initial capacity

Returns:

the new Map instance

createMap

public static <K,V> Map<K,V> createMap(Class<?> mapClass,
                                       Class<?> keyType,
                                       int capacity)

Create the most approximate map for the given map.

Parameters:

mapClass - the desired type of the target Map

keyType - the map's key type, or null if not known (note: only relevant for EnumMap creation)

capacity - the initial capacity

Returns:

the new Map instance

Since:

4.1.3

See Also:

LinkedHashMap, TreeMap, EnumMap, LinkedMultiValueMap