net.sf.mmm.util.collection.impl

Class CollectionFactoryManagerImpl

java.lang.Object

net.sf.mmm.util.component.base.AbstractComponent

net.sf.mmm.util.collection.impl.CollectionFactoryManagerImpl

All Implemented Interfaces:

CollectionFactoryManager

public class CollectionFactoryManagerImpl
extends AbstractComponent
implements CollectionFactoryManager

This is the default implementation of the CollectionFactoryManager interface.

Since:

1.0.1

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Field Summary

Fields

Modifier and Type	Field and Description
private static Class<?>[]	CAPACITY_CONSTRUCTOR_ARGS
private Map<Class<? extends Collection>,CollectionFactory>	collectionFactoryMap
private static CollectionFactoryManager	instance
private static org.slf4j.Logger	LOG
private Map<Class<? extends Map>,MapFactory>	mapFactoryMap

Constructor Summary

Constructors

Constructor and Description
CollectionFactoryManagerImpl() The constructor.

Method Summary

Modifier and Type	Method and Description
<C extends Collection> C	create(Class<C> type) This method creates a Collection implementing the given type.
<C extends Collection> C	create(Class<C> type, int capacity) This method creates a Collection implementing the given type.
protected <C extends Collection<?>> C	create(Class<C> type, Integer capacity)
<C extends Map> C	createMap(Class<C> type) This method creates a Map implementing the given type.
<C extends Map> C	createMap(Class<C> type, int capacity) This method creates a Map implementing the given type.
protected <C extends Map<?,?>> C	createMap(Class<C> type, Integer capacity)
protected void	doInitialize()
protected Class<? extends Collection>	findCollectionInterface(Class<? extends Collection> type)
protected Class<? extends Map>	findMapInterface(Class<? extends Map> type)
<C extends Collection> CollectionFactory<C>	getCollectionFactory(Class<C> collectionType) This method gets the CollectionFactory for the given collectionType.
static CollectionFactoryManager	getInstance() This method gets the singleton instance of this CollectionFactoryManager implementation.
<MAP extends Map> MapFactory	getMapFactory(Class<MAP> mapType) This method gets the MapFactory for the given mapType.
protected CollectionFactory	registerCollectionFactory(CollectionFactory factory) This method registers the given factory using its collection-interface.
protected <COLLECTION extends Collection> CollectionFactory	registerCollectionFactory(CollectionFactory<? extends COLLECTION> factory, Class<COLLECTION> collectionInterface) This method registers the given factory for the given collectionInterface.
protected MapFactory	registerMapFactory(MapFactory factory) This method registers the given factory using its map-interface.
protected <MAP extends Map> MapFactory	registerMapFactory(MapFactory<? extends MAP> factory, Class<MAP> mapInterface) This method registers the given factory for the given mapInterface.

Methods inherited from class net.sf.mmm.util.component.base.AbstractComponent

doInitialized, getInitializationState, initialize

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final org.slf4j.Logger LOG

CAPACITY_CONSTRUCTOR_ARGS

private static final Class<?>[] CAPACITY_CONSTRUCTOR_ARGS

instance

private static CollectionFactoryManager instance

collectionFactoryMap

private final Map<Class<? extends Collection>,CollectionFactory> collectionFactoryMap

mapFactoryMap

private final Map<Class<? extends Map>,MapFactory> mapFactoryMap

Constructor Detail

CollectionFactoryManagerImpl

public CollectionFactoryManagerImpl()

The constructor.

Method Detail

doInitialize

protected void doInitialize()

Overrides:

doInitialize in class AbstractComponent

getInstance

public static CollectionFactoryManager getInstance()

This method gets the singleton instance of this CollectionFactoryManager implementation.
ATTENTION:
Please prefer dependency-injection instead of using this method.

Returns:

the singleton instance.

getCollectionFactory

public <C extends Collection> CollectionFactory<C> getCollectionFactory(Class<C> collectionType)

Description copied from interface: CollectionFactoryManager

This method gets the CollectionFactory for the given collectionType.

Specified by:

getCollectionFactory in interface CollectionFactoryManager

Type Parameters:

C - is the generic type of the Collection.

Parameters:

collectionType - is the type of the Collection. This should be the Collection interface such as List.class.

Returns:

the CollectionFactory for the given collectionType. The collectionType has to be assignable from CollectionFactory.getCollectionInterface() of the returned instance. Typically it will be equal.

getMapFactory

public <MAP extends Map> MapFactory getMapFactory(Class<MAP> mapType)

Description copied from interface: CollectionFactoryManager

This method gets the MapFactory for the given mapType.

Specified by:

getMapFactory in interface CollectionFactoryManager

Type Parameters:

MAP - is the generic type of the Map.

Parameters:

mapType - is the type of the Map. This should be the interface such as Map.class or SortedMap.class.

Returns:

the MapFactory for the given mapType. The mapType has to be assignable from MapFactory.getMapInterface() of the returned instance. Typically it will be equal.

registerMapFactory

protected MapFactory registerMapFactory(MapFactory factory)

This method registers the given factory using its map-interface.

Parameters:

factory - is the MapFactory to register.

Returns:

the MapFactory that has been replaced with factory or null if none was replaced.

See Also:

registerMapFactory(MapFactory, Class)

registerMapFactory

protected <MAP extends Map> MapFactory registerMapFactory(MapFactory<? extends MAP> factory,
                                                          Class<MAP> mapInterface)

This method registers the given factory for the given mapInterface.

Type Parameters:

MAP - is the generic type of the mapInterface.

Parameters:

factory - is the MapFactory to register.

mapInterface - is the interface of the associated Map. It has to be assignable from the map-interface of the given factory.

Returns:

the MapFactory that was registered for the given mapInterface before and has now been replaced with factory or null if none was replaced.

registerCollectionFactory

protected CollectionFactory registerCollectionFactory(CollectionFactory factory)

This method registers the given factory using its collection-interface.

Parameters:

factory - is the CollectionFactory to register.

Returns:

the CollectionFactory that has been replaced with factory or null if none was replaced.

See Also:

registerCollectionFactory(CollectionFactory, Class)

registerCollectionFactory

protected <COLLECTION extends Collection> CollectionFactory registerCollectionFactory(CollectionFactory<? extends COLLECTION> factory,
                                                                                      Class<COLLECTION> collectionInterface)

This method registers the given factory for the given collectionInterface.

Type Parameters:

COLLECTION - is the generic type of the collectionInterface.

Parameters:

factory - is the CollectionFactory to register.

collectionInterface - is the interface of the associated Collection. It has to be assignable from the collection-interface of the given factory.

Returns:

the CollectionFactory that was registered for the given collectionInterface before and has now been replaced with factory or null if none was replaced.

create

public <C extends Collection> C create(Class<C> type)

Description copied from interface: CollectionFactoryManager

This method creates a Collection implementing the given type.

Specified by:

create in interface CollectionFactoryManager

Type Parameters:

C - is the generic type of the Collection.

Parameters:

type - is the type of Collection to create. This is either an interface (List, Set, Queue, etc.) or a non-abstract implementation of a Collection.

Returns:

the new instance of the given type.

create

public <C extends Collection> C create(Class<C> type,
                                       int capacity)

Description copied from interface: CollectionFactoryManager

This method creates a Collection implementing the given type.

Specified by:

create in interface CollectionFactoryManager

Type Parameters:

C - is the generic type of the Collection.

Parameters:

type - is the type of Collection to create. This is either an interface (List, Set, Queue, etc.) or a non-abstract implementation of a Collection.

capacity - is the initial capacity of the Collection.

Returns:

the new instance of the given type.

create

protected <C extends Collection<?>> C create(Class<C> type,
                                             Integer capacity)

Type Parameters:

C - is the generic type of the collection.

Parameters:

type - is the type of collection to create. This is either an interface (List, Set, Queue, etc.) or a non-abstract implementation of a Collection.

capacity - is the initial capacity of the collection or null if unspecified.

Returns:

the new instance of the given type.

See Also:

create(Class, int)

findCollectionInterface

protected Class<? extends Collection> findCollectionInterface(Class<? extends Collection> type)

Parameters:

type - Class reflecting the Collection.

Returns:

to most specific Collection interface assignable from the given type.

createMap

public <C extends Map> C createMap(Class<C> type)

Description copied from interface: CollectionFactoryManager

This method creates a Map implementing the given type.

Specified by:

createMap in interface CollectionFactoryManager

Type Parameters:

C - is the generic type of the Map.

Parameters:

type - is the type of Map to create. This is either an interface (Map, ConcurrentMap, NavigableMap, etc.) or a non-abstract implementation of a Map.

Returns:

the new instance of the given type.

createMap

public <C extends Map> C createMap(Class<C> type,
                                   int capacity)

Description copied from interface: CollectionFactoryManager

This method creates a Map implementing the given type.

Specified by:

createMap in interface CollectionFactoryManager

Type Parameters:

C - is the generic type of the Map.

Parameters:

type - is the type of Map to create. This is either an interface (Map, ConcurrentMap, NavigableMap, etc.) or a non-abstract implementation of a Map.

capacity - is the initial capacity of the Map.

Returns:

the new instance of the given type.

createMap

protected <C extends Map<?,?>> C createMap(Class<C> type,
                                           Integer capacity)

Type Parameters:

C - is the generic type of the collection.

Parameters:

type - is the type of collection to create. This is either an interface (List, Set, Queue, etc.) or a non-abstract implementation of a Collection.

capacity - is the initial capacity of the collection or null if unspecified.

Returns:

the new instance of the given type.

See Also:

create(Class, int)

findMapInterface

protected Class<? extends Map> findMapInterface(Class<? extends Map> type)

Parameters:

type - Class reflecting the Map.

Returns:

to most specific Map interface assignable from the given type.