org.codehaus.cargo.container.spi.configuration

Class AbstractLocalConfiguration

java.lang.Object

org.codehaus.cargo.util.log.LoggedObject

org.codehaus.cargo.container.spi.configuration.AbstractConfiguration

org.codehaus.cargo.container.spi.configuration.AbstractLocalConfiguration

All Implemented Interfaces:

Configuration, LocalConfiguration, ContainerConfiguration, Loggable

Direct Known Subclasses:

AbstractExistingLocalConfiguration, AbstractStandaloneLocalConfiguration

public abstract class AbstractLocalConfiguration
extends AbstractConfiguration
implements LocalConfiguration

Base implementation of ContainerConfiguration that can be specialized for standalone configuration, existing configuration or other local configurations.

Version:

$Id: AbstractLocalConfiguration.java 3656 2013-05-25 05:54:25Z alitokmen $

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	RESOURCE_PATH The path under which the container resources are stored in the JAR.

Constructor Summary

Constructors

Constructor and Description
AbstractLocalConfiguration(String home)

Method Summary

Methods

Modifier and Type	Method and Description
void	addDataSource(DataSource dataSource) Add data source the container can take advantage of.
protected void	addDataSourcesFromProperties() Parse properties and add any DataSources to pending configuration.
void	addDeployable(Deployable newDeployable) Deploy a Deployable in the container.
void	addResource(Resource resource) Add resources the container can take advantage of.
protected void	addResourcesFromProperties() Parse properties and add any Resources to pending configuration.
void	applyPortOffset() Apply the port offset to the configuration port properties.
protected void	applyPortOffset(String name) Apply the port offset on the specified property
void	collectUnsupportedDataSourcesAndThrowException() Warn user and throw an Exception if any unsupported DataSources are setup for this configuration.
void	collectUnsupportedResourcesAndThrowException() Warn user and throw an Exception if any unsupported Resources are setup for this configuration.
void	configure(LocalContainer container) Setup the container which means setting up a valid directory structure, setting up configuration files and deploying static deployables.
protected void	configureFiles(org.apache.tools.ant.types.FilterChain filterChain, LocalContainer container) Copy the customized configuration files into the cargo home directory.
protected org.apache.tools.ant.types.FilterChain	createFilterChain() Creates the default filter chain that should be applied while copying container configuration files to the working directory from which the container is started.
protected abstract void	doConfigure(LocalContainer container) Implementation of LocalConfiguration.configure(LocalContainer) that all local configuration using this class must implement.
protected AntUtils	getAntUtils()
List<DataSource>	getDataSources()
List<Deployable>	getDeployables()
protected String	getDestDirectoryLocation(String file, String toDir) Determines the correct path for the destination directory.
protected String	getDestFileLocation(String file, String toDir, String toFile) Determines the correct path for the destination file.
FileHandler	getFileHandler()
List<FileConfig>	getFileProperties() Returns the file configurations.
protected org.apache.tools.ant.types.FilterChain	getFilterChain()
String	getHome()
List<Resource>	getResources()
protected ResourceUtils	getResourceUtils()
void	parsePropertiesForPendingConfiguration() Some configuration can be specified as encoded properties.
void	revertPortOffset() Revert the port offset on the configuration port properties.
protected void	revertPortOffset(String name) Revert the port offset on the specified property
void	setConfigFileProperty(FileConfig fileConfig) set the config file property for a configuration.
void	setFileHandler(FileHandler fileHandler)
void	setFileProperty(FileConfig fileConfig) set the file property for a configuration.
void	setLogger(Logger logger) Overriden in order to set the logger on ancillary components.
void	verify() Verify that the configuration is valid.

Methods inherited from class org.codehaus.cargo.container.spi.configuration.AbstractConfiguration

getProperties, getPropertyValue, setProperty

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

getLogger

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.codehaus.cargo.container.configuration.Configuration

getCapability, getProperties, getPropertyValue, getType, setProperty

Methods inherited from interface org.codehaus.cargo.util.log.Loggable

getLogger

Field Detail

RESOURCE_PATH

protected static final String RESOURCE_PATH

The path under which the container resources are stored in the JAR.

See Also:

Constant Field Values

Constructor Detail

AbstractLocalConfiguration

public AbstractLocalConfiguration(String home)

Parameters:

home - the home directory where the container will be set up to start and where it will deploy its deployables. IMPORTANT: While some containers can deal with this parameter being set as a relative path, some others require this path to be set to an absolute directory. Please refer to the documentation of the server to ensure you give the path in the appropriate way. If in doubt, you can use absolute paths -that is known to work with all containers.

Method Detail

setLogger

public void setLogger(Logger logger)

Overriden in order to set the logger on ancillary components.

Specified by:

setLogger in interface Loggable

Overrides:

setLogger in class LoggedObject

Parameters:

logger - the logger to set and set in the ancillary objects

See Also:

Loggable.setLogger(org.codehaus.cargo.util.log.Logger)

getFileHandler

public FileHandler getFileHandler()

Specified by:

getFileHandler in interface LocalConfiguration

Returns:

the file utility class to use for performing all file I/O.

setFileHandler

public void setFileHandler(FileHandler fileHandler)

Specified by:

setFileHandler in interface LocalConfiguration

Parameters:

fileHandler - the file utility class to use for performing all file I/O.

getAntUtils

protected final AntUtils getAntUtils()

Returns:

the Ant utility class

getResourceUtils

protected final ResourceUtils getResourceUtils()

Returns:

the Resource utility class

setFileProperty

public void setFileProperty(FileConfig fileConfig)

set the file property for a configuration.

Specified by:

setFileProperty in interface LocalConfiguration

Parameters:

fileConfig - The FileConfig to use

See Also:

org.codehaus.cargo.container.configuration.LocalConfiguration#addConfigfile(org.codehaus.cargo.container.configuration.FileConfig)

setConfigFileProperty

public void setConfigFileProperty(FileConfig fileConfig)

set the config file property for a configuration.

Specified by:

setConfigFileProperty in interface LocalConfiguration

Parameters:

fileConfig - The FileConfig to use

See Also:

org.codehaus.cargo.container.configuration.LocalConfiguration#addConfigfile(org.codehaus.cargo.container.configuration.FileConfig)

getFileProperties

public List<FileConfig> getFileProperties()

Returns the file configurations.

Specified by:

getFileProperties in interface LocalConfiguration

Returns:

The configuration file properies

See Also:

org.codehaus.cargo.container.configuration.StandaloneLocalConfiguration#getConfigfiles()

addDeployable

public void addDeployable(Deployable newDeployable)

Deploy a Deployable in the container. It installs the Deployable in the container's configuration directory.

Specified by:

addDeployable in interface LocalConfiguration

Parameters:

newDeployable - the Deployable to deploy

See Also:

LocalConfiguration.addDeployable(org.codehaus.cargo.container.deployable.Deployable)

getDeployables

public List<Deployable> getDeployables()

Specified by:

getDeployables in interface LocalConfiguration

Returns:

the list of Deployables that are going to be deployed in the container when it is started

See Also:

LocalConfiguration.getDeployables()

getHome

public String getHome()

Specified by:

getHome in interface LocalConfiguration

Returns:

the configuration home directory. Note that we're returning a String instead of a File because we want to leave the possibility of using URIs for specifying the home location.

See Also:

LocalConfiguration.getHome()

configure

public void configure(LocalContainer container)

Setup the container which means setting up a valid directory structure, setting up configuration files and deploying static deployables.

Specified by:

configure in interface LocalConfiguration

Parameters:

container - the container to configure

See Also:

LocalConfiguration.configure(LocalContainer)

createFilterChain

protected final org.apache.tools.ant.types.FilterChain createFilterChain()

Creates the default filter chain that should be applied while copying container configuration files to the working directory from which the container is started.

Returns:

The default filter chain

getFilterChain

protected org.apache.tools.ant.types.FilterChain getFilterChain()

configureFiles

protected void configureFiles(org.apache.tools.ant.types.FilterChain filterChain,
                  LocalContainer container)

Copy the customized configuration files into the cargo home directory.

Parameters:

filterChain - the filter chain to use during the copy

container - local container

getDestFileLocation

protected String getDestFileLocation(String file,
                         String toDir,
                         String toFile)

Determines the correct path for the destination file.

Parameters:

file - The path of the original file

toDir - The directory for the copied file

toFile - The file name for the copied file

Returns:

The path for the destination file

getDestDirectoryLocation

protected String getDestDirectoryLocation(String file,
                              String toDir)

Determines the correct path for the destination directory.

Parameters:

file - The path of the original file

toDir - The directory for the copied file

Returns:

The path for the destination file

verify

public void verify()

Verify that the configuration is valid. The checks to be performed may vay whether this is standalone or existing configuration. This method should also be used to verify that the configuration properties specified by the user are valid and that the required ones are set.

Specified by:

verify in interface ContainerConfiguration

Overrides:

verify in class AbstractConfiguration

See Also:

ContainerConfiguration.verify()

collectUnsupportedResourcesAndThrowException

public void collectUnsupportedResourcesAndThrowException()

Warn user and throw an Exception if any unsupported Resources are setup for this configuration.

collectUnsupportedDataSourcesAndThrowException

public void collectUnsupportedDataSourcesAndThrowException()

Warn user and throw an Exception if any unsupported DataSources are setup for this configuration.

parsePropertiesForPendingConfiguration

public void parsePropertiesForPendingConfiguration()

Some configuration can be specified as encoded properties. Parse properties and apply what is found to the appropriate pending configuration list.

addResourcesFromProperties

protected void addResourcesFromProperties()

Parse properties and add any Resources to pending configuration. Resources will be found if their property name starts with: ResourcePropertySet.RESOURCE

addDataSourcesFromProperties

protected void addDataSourcesFromProperties()

Parse properties and add any DataSources to pending configuration. DataSources will be found if their property name starts with: DatasourcePropertySet.DATASOURCE

doConfigure

protected abstract void doConfigure(LocalContainer container)
                             throws Exception

Implementation of LocalConfiguration.configure(LocalContainer) that all local configuration using this class must implement. This provides the ability to perform generic actions before and after the container-specific implementation. Another way would be to use AOP...

Parameters:

container - the container to configure

Throws:

Exception - if any error is raised during the configuration

addResource

public void addResource(Resource resource)

Add resources the container can take advantage of. I.e. datasources.

Specified by:

addResource in interface LocalConfiguration

Parameters:

resource - the Resource to add.

See Also:

LocalConfiguration.addResource(Resource)

getResources

public List<Resource> getResources()

Specified by:

getResources in interface LocalConfiguration

Returns:

the configured resources for this container.

addDataSource

public void addDataSource(DataSource dataSource)

Add data source the container can take advantage of.

Specified by:

addDataSource in interface LocalConfiguration

Parameters:

dataSource - the DataSource to add.

See Also:

LocalConfiguration.addDataSource(DataSource)

getDataSources

public List<DataSource> getDataSources()

Specified by:

getDataSources in interface LocalConfiguration

Returns:

the configured DataSources for this container.

See Also:

LocalConfiguration.getDataSources()

applyPortOffset

public void applyPortOffset()

Apply the port offset to the configuration port properties.

Specified by:

applyPortOffset in interface LocalConfiguration

See Also:

This method should only be called once all the properties has been set.

revertPortOffset

public void revertPortOffset()

Revert the port offset on the configuration port properties.

Specified by:

revertPortOffset in interface LocalConfiguration

See Also:

This method should only be called once all the properties has been set.

applyPortOffset

protected void applyPortOffset(String name)

Apply the port offset on the specified property

Parameters:

name - the property name

revertPortOffset

protected void revertPortOffset(String name)

Revert the port offset on the specified property

Parameters:

name - the property name