org.codehaus.cargo.generic

Class DefaultContainerFactory

java.lang.Object

org.codehaus.cargo.util.log.LoggedObject

org.codehaus.cargo.generic.spi.AbstractGenericHintFactory<T>

org.codehaus.cargo.generic.spi.AbstractIntrospectionGenericHintFactory<Container>

org.codehaus.cargo.generic.DefaultContainerFactory

All Implemented Interfaces:

ContainerFactory, org.codehaus.cargo.util.log.Loggable

public class DefaultContainerFactory
extends AbstractIntrospectionGenericHintFactory<Container>
implements ContainerFactory

Default implementation of ContainerFactory. Registers all known containers.

Nested Class Summary

Nested classes/interfaces inherited from class org.codehaus.cargo.generic.spi.AbstractGenericHintFactory

AbstractGenericHintFactory.GenericParameters

Constructor Summary

Constructors

Constructor and Description
DefaultContainerFactory() Initialize container name mappings with container ids.
DefaultContainerFactory(ClassLoader classLoader) Register packager name mappings.

Method Summary

Modifier and Type	Method and Description
Container	createContainer(String containerId, ContainerType containerType, Configuration configuration) Create a container instance instantiated using the specified configuration.
protected Container	createInstance(Constructor<? extends Container> constructor, String containerType, AbstractGenericHintFactory.GenericParameters parameters) Create an implementation class instance.
protected Constructor<? extends Container>	getConstructor(Class<? extends Container> containerClass, String containerType, AbstractGenericHintFactory.GenericParameters parameters) Create a constructor.
Class<? extends Container>	getContainerClass(String containerId, ContainerType containerType)
Map<String,Set<ContainerType>>	getContainerIds()
boolean	isContainerRegistered(String containerId, ContainerType containerType)
void	registerContainer(String containerId, ContainerType containerType, Class<? extends Container> containerClass)
void	registerContainer(String containerId, ContainerType containerType, String containerClassName) Registers a container using a class specified as a String.

Methods inherited from class org.codehaus.cargo.generic.spi.AbstractIntrospectionGenericHintFactory

createImplementation, registerImplementation

Methods inherited from class org.codehaus.cargo.generic.spi.AbstractGenericHintFactory

getMapping, getMappings, hasMapping, registerImplementation

Methods inherited from class org.codehaus.cargo.util.log.LoggedObject

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultContainerFactory

public DefaultContainerFactory()

Initialize container name mappings with container ids.

DefaultContainerFactory

public DefaultContainerFactory(ClassLoader classLoader)

Register packager name mappings.

Parameters:

classLoader - ClassLoader to discover implementations from. See AbstractFactoryRegistry.register(ClassLoader, ContainerFactory) for the details of what this value means.

Method Detail

isContainerRegistered

public boolean isContainerRegistered(String containerId,
                                     ContainerType containerType)

Specified by:

isContainerRegistered in interface ContainerFactory

Parameters:

containerId - the id of the container to check

containerType - the container type

Returns:

true if the specified container and type is already registered or false otherwise

See Also:

ContainerFactory.isContainerRegistered(String, ContainerType)

registerContainer

public void registerContainer(String containerId,
                              ContainerType containerType,
                              Class<? extends Container> containerClass)

Specified by:

registerContainer in interface ContainerFactory

Parameters:

containerId - the id of the container to register

containerType - the container type to register (ContainerType.INSTALLED, ContainerType.EMBEDDED or ContainerType.REMOTE)

containerClass - the container implementation class to register

See Also:

ContainerFactory.registerContainer(String, org.codehaus.cargo.container.ContainerType, Class)

registerContainer

public void registerContainer(String containerId,
                              ContainerType containerType,
                              String containerClassName)

Registers a container using a class specified as a String.

Parameters:

containerId -

containerType -

containerClassName - the container implementation class to register as a String

See Also:

registerContainer(String, ContainerType, Class)

getContainerClass

public Class<? extends Container> getContainerClass(String containerId,
                                                    ContainerType containerType)

Specified by:

getContainerClass in interface ContainerFactory

Parameters:

containerId - the id of the container for which to retrieve the implementation class

containerType - the container's type (ContainerType.INSTALLED, ContainerType.EMBEDDED or ContainerType.REMOTE)

Returns:

the container implementation class

See Also:

ContainerFactory.getContainerClass(java.lang.String, org.codehaus.cargo.container.ContainerType)

createContainer

public Container createContainer(String containerId,
                                 ContainerType containerType,
                                 Configuration configuration)

Create a container instance instantiated using the specified configuration.

Specified by:

createContainer in interface ContainerFactory

Parameters:

containerId - the name under which the container will be looked up

containerType - the container's type (local installed, local embedded, remote, etc)

configuration - the configuration to pass to the container's constructor

Returns:

the container whose class name matches the parameter passed

See Also:

ContainerFactory.createContainer(String, ContainerType, Configuration)

getConstructor

protected Constructor<? extends Container> getConstructor(Class<? extends Container> containerClass,
                                                          String containerType,
                                                          AbstractGenericHintFactory.GenericParameters parameters)
                                                   throws NoSuchMethodException

Create a constructor.

Specified by:

getConstructor in class AbstractGenericHintFactory<Container>

Parameters:

containerClass - implementation class for which to create the constructor

containerType - the hint to differentiate this implementation class from others

parameters - additional parameters necessary to create the constructor object

Returns:

the constructor to use for creating an instance

Throws:

NoSuchMethodException - in case of error

See Also:

AbstractGenericHintFactory.getConstructor(java.lang.Class<? extends T>, java.lang.String, org.codehaus.cargo.generic.spi.AbstractGenericHintFactory.GenericParameters)

createInstance

protected Container createInstance(Constructor<? extends Container> constructor,
                                   String containerType,
                                   AbstractGenericHintFactory.GenericParameters parameters)
                            throws Exception

Create an implementation class instance.

Specified by:

createInstance in class AbstractGenericHintFactory<Container>

Parameters:

constructor - the constructor to use for creating the instance

containerType - the hint to differentiate this implementation class from others

parameters - additional parameters necessary to create the instance

Returns:

the created instance

Throws:

Exception - in case of error

See Also:

AbstractGenericHintFactory.createInstance(java.lang.reflect.Constructor<? extends T>, java.lang.String, org.codehaus.cargo.generic.spi.AbstractGenericHintFactory.GenericParameters)

getContainerIds

public Map<String,Set<ContainerType>> getContainerIds()

Specified by:

getContainerIds in interface ContainerFactory

Returns:

the list of container ids that have been registered as Map.

See Also:

ContainerFactory.getContainerIds()