org.codehaus.cargo.container.spi

Class AbstractInstalledLocalContainer

java.lang.Object

org.codehaus.cargo.util.log.LoggedObject

org.codehaus.cargo.container.spi.AbstractContainer

org.codehaus.cargo.container.spi.AbstractLocalContainer

org.codehaus.cargo.container.spi.AbstractInstalledLocalContainer

All Implemented Interfaces:

Container, InstalledLocalContainer, RunnableContainer, SpawnedContainer, LocalContainer, Loggable

public abstract class AbstractInstalledLocalContainer
extends AbstractLocalContainer
implements InstalledLocalContainer

Default container implementation that all local installed container implementations must extend.

Version:

$Id: AbstractInstalledLocalContainer.java 3707 2013-08-08 18:45:19Z alitokmen $

Constructor Summary

Constructors

Constructor and Description
AbstractInstalledLocalContainer(LocalConfiguration configuration) Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addExtraClasspath(JvmLauncher java) Add extra container classpath entries specified by the user.
void	addExtraClasspath(String location)
protected void	addMemoryArguments(JvmLauncher java) Adds the JVM memory arguments.
protected void	addRuntimeArgs(JvmLauncher java) Add command line arguments to the java command.
void	addSharedClasspath(String location)
protected void	addToolsJarToClasspath(JvmLauncher java) Adds the tools.jar to the classpath, except for Mac OSX as it is not needed.
protected JvmLauncher	createJvmLauncher(boolean server) Creates a preinitialized instance of a JVM launcher to be used for starting, stopping and controlling the container.
protected abstract void	doStart(JvmLauncher java) Implementation of RunnableContainer.start() that all containers extending this class must implement.
protected abstract void	doStop(JvmLauncher java) Implementation of RunnableContainer.stop() that all containers extending this class must implement.
protected void	forceStopInternal() Some containers may not fully stop and need to be forcibly stopped.
protected AntUtils	getAntUtils()
String[]	getExtraClasspath()
String	getHome()
protected HttpUtils	getHttpUtils()
protected String	getJavaHome() Gets the Java home directory to use for this container.
protected JdkUtils	getJdkUtils()
JvmLauncherFactory	getJvmLauncherFactory() Gets the factory used to spawn the container JVM.
protected ResourceUtils	getResourceUtils()
String[]	getSharedClasspath()
Map<String,String>	getSystemProperties()
ContainerType	getType()
void	ifPresentAddPathToList(String location, List<String> list) adds the location to the list, if the file exists.
void	setExtraClasspath(String[] classpath)
void	setHome(String home)
void	setJvmLauncherFactory(JvmLauncherFactory jvmLauncherFactory) Sets the factory used to spawn the container JVM.
protected void	setJvmToLaunchContainerIn(JvmLauncher java) Determines which java virtual machine will run the container.
void	setLogger(Logger logger) Overriden in order to set the logger on ancillary components.
void	setSharedClasspath(String[] classpath)
void	setSystemProperties(Map<String,String> properties)
protected void	startInternal() Installed and Embedded containers do not have the same signature for their doStart method.
protected void	stopInternal() Installed and Embedded containers do not have the same signature for their doStop method.
protected void	verify() Verify required properties have been set before executing any action.

Methods inherited from class org.codehaus.cargo.container.spi.AbstractLocalContainer

executePostStartTasks, getConfiguration, getFileHandler, getOutput, getState, getTimeout, isAppend, restart, setAppend, setConfiguration, setFileHandler, setOutput, setState, setTimeout, start, stop, waitForCompletion

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.LocalContainer

getConfiguration, getFileHandler, setConfiguration, setFileHandler

Methods inherited from interface org.codehaus.cargo.container.Container

getCapability, getId, getName, getState

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

getLogger

Methods inherited from interface org.codehaus.cargo.container.internal.RunnableContainer

getOutput, getTimeout, isAppend, restart, setAppend, setOutput, setTimeout, start, stop

Constructor Detail

AbstractInstalledLocalContainer

public AbstractInstalledLocalContainer(LocalConfiguration configuration)

Default constructor.

Parameters:

configuration - the configuration to associate to this container. It can be changed later on by calling AbstractLocalContainer.setConfiguration(LocalConfiguration)

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)

getHttpUtils

protected final HttpUtils getHttpUtils()

Returns:

the HTTP utility class

getJdkUtils

protected final JdkUtils getJdkUtils()

Returns:

the JDK utility class

getAntUtils

protected final AntUtils getAntUtils()

Returns:

the Ant utility class

getResourceUtils

protected final ResourceUtils getResourceUtils()

Returns:

the Resource utility class

setHome

public void setHome(String home)

Specified by:

setHome in interface InstalledLocalContainer

Parameters:

home - the directory where the container is installed. Note that we're passing a String instead of a File because we want to leave the possibility of using URIs for specifying the home location. 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.

See Also:

InstalledLocalContainer.setHome(String)

setSystemProperties

public void setSystemProperties(Map<String,String> properties)

Specified by:

setSystemProperties in interface SpawnedContainer

Parameters:

properties - the System properties to set in the container executing VM.

See Also:

SpawnedContainer.setSystemProperties(java.util.Map<java.lang.String, java.lang.String>)

getSystemProperties

public Map<String,String> getSystemProperties()

Specified by:

getSystemProperties in interface SpawnedContainer

Returns:

the System properties to set in the container executing VM.

See Also:

SpawnedContainer.getSystemProperties()

setExtraClasspath

public void setExtraClasspath(String[] classpath)

Specified by:

setExtraClasspath in interface SpawnedContainer

Parameters:

classpath - the extra classpath that is added to the container's classpath when it is started.

See Also:

SpawnedContainer.setExtraClasspath(String[])

getExtraClasspath

public String[] getExtraClasspath()

Specified by:

getExtraClasspath in interface SpawnedContainer

Returns:

the extra classpath that is added to the container's classpath when it is started.

See Also:

SpawnedContainer.getExtraClasspath()

setSharedClasspath

public void setSharedClasspath(String[] classpath)

Specified by:

setSharedClasspath in interface SpawnedContainer

Parameters:

classpath - the shared classpath that is shared by the container applications.

See Also:

InstalledLocalContainer.getHome()

getSharedClasspath

public String[] getSharedClasspath()

Specified by:

getSharedClasspath in interface SpawnedContainer

Returns:

the extra classpath that is shared by the container applications.

See Also:

SpawnedContainer.getSharedClasspath()

getHome

public String getHome()

Specified by:

getHome in interface InstalledLocalContainer

Returns:

the directory where the container is installed. 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:

InstalledLocalContainer.getHome()

getJvmLauncherFactory

public JvmLauncherFactory getJvmLauncherFactory()

Gets the factory used to spawn the container JVM.

Specified by:

getJvmLauncherFactory in interface SpawnedContainer

Returns:

The factory used to spawn the container JVM, never null.

setJvmLauncherFactory

public void setJvmLauncherFactory(JvmLauncherFactory jvmLauncherFactory)

Sets the factory used to spawn the container JVM.

Specified by:

setJvmLauncherFactory in interface SpawnedContainer

Parameters:

jvmLauncherFactory - The factory used to spawn the container JVM, must not be null.

doStart

protected abstract void doStart(JvmLauncher java)
                         throws Exception

Implementation of RunnableContainer.start() that all containers extending this class must implement.

Parameters:

java - the predefined JVM launcher to use to start the container

Throws:

Exception - if any error is raised during the container start

doStop

protected abstract void doStop(JvmLauncher java)
                        throws Exception

Implementation of RunnableContainer.stop() that all containers extending this class must implement.

Parameters:

java - the predefined JVM launcher to use to stop the container

Throws:

Exception - if any error is raised during the container stop

startInternal

protected final void startInternal()
                            throws Exception

Installed and Embedded containers do not have the same signature for their doStart method. Thus we need to abstract it.

Specified by:

startInternal in class AbstractLocalContainer

Throws:

Exception - if any error is raised during the container start

See Also:

AbstractLocalContainer.startInternal()

stopInternal

protected final void stopInternal()
                           throws Exception

Installed and Embedded containers do not have the same signature for their doStop method. Thus we need to abstract it.

Specified by:

stopInternal in class AbstractLocalContainer

Throws:

Exception - if any error is raised during the container stop

See Also:

AbstractLocalContainer.stopInternal()

forceStopInternal

protected final void forceStopInternal()

Some containers may not fully stop and need to be forcibly stopped. This method should be overridden for containers that support forcibly stopping the container.

Overrides:

forceStopInternal in class AbstractLocalContainer

See Also:

AbstractLocalContainer.forceStopInternal()

createJvmLauncher

protected JvmLauncher createJvmLauncher(boolean server)

Creates a preinitialized instance of a JVM launcher to be used for starting, stopping and controlling the container.

Parameters:

server - true to launch a server process, false to launch a client/utility process.

Returns:

The created JVM launcher, never null.

getJavaHome

protected String getJavaHome()

Gets the Java home directory to use for this container.

Returns:

The Java home directory to use, never null.

setJvmToLaunchContainerIn

protected void setJvmToLaunchContainerIn(JvmLauncher java)

Determines which java virtual machine will run the container.

Parameters:

java - the java command that will start the container

addToolsJarToClasspath

protected final void addToolsJarToClasspath(JvmLauncher java)
                                     throws FileNotFoundException

Adds the tools.jar to the classpath, except for Mac OSX as it is not needed.

Parameters:

java - the JVM launcher to which to add the tools.jar

Throws:

FileNotFoundException - in case the tools.jar file cannot be found

addExtraClasspath

protected void addExtraClasspath(JvmLauncher java)

Add extra container classpath entries specified by the user.

Parameters:

java - the java command used to start/stop the container

addRuntimeArgs

protected void addRuntimeArgs(JvmLauncher java)

Add command line arguments to the java command.

Parameters:

java - The java command

addMemoryArguments

protected void addMemoryArguments(JvmLauncher java)

Adds the JVM memory arguments.

Parameters:

java - the predefined JVM launcher on which to add memory-related arguments

verify

protected void verify()

Verify required properties have been set before executing any action.

Overrides:

verify in class AbstractLocalContainer

See Also:

AbstractLocalContainer.verify()

getType

public ContainerType getType()

Specified by:

getType in interface Container

Returns:

the container's type (local , remote, etc)

See Also:

Container.getType()

addExtraClasspath

public void addExtraClasspath(String location)

Specified by:

addExtraClasspath in interface SpawnedContainer

Parameters:

location - the extra classpath that is added to the container's classpath when it is started.

See Also:

org.codehaus.cargo.container.SpawnedContainer#addExtraClasspath()

addSharedClasspath

public void addSharedClasspath(String location)

Specified by:

addSharedClasspath in interface SpawnedContainer

Parameters:

location - the shared classpath that is added to the container's classpath when it is started.

See Also:

org.codehaus.cargo.container.SpawnedContainer#addSharedClasspath()

ifPresentAddPathToList

public void ifPresentAddPathToList(String location,
                          List<String> list)

adds the location to the list, if the file exists.

Parameters:

location - path to add to the list

list - where to append this path