org.wisdom.test.internals

Class ChameleonExecutor

java.lang.Object

org.wisdom.test.internals.ChameleonExecutor

public final class ChameleonExecutor
extends Object

Handles a Chameleon and manages the singleton instance.

Field Summary

Fields

Modifier and Type	Field and Description
private static String	APPLICATION_BUNDLE
private static ChameleonExecutor	INSTANCE
private File	root

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ChameleonExecutor()

Method Summary

Modifier and Type	Method and Description
org.osgi.framework.BundleContext	context()
static void	deployApplication() Builds and deploy the application bundle.
static org.osgi.framework.Bundle	deployProbe() Deploys the `probe` bundle, i.e.
private int	getFactorAsAnInteger(String factor)
InVivoRunner	getInVivoRunnerInstance(Class<?> clazz) Retrieves the InVivoRunner Factory and creates an instance.
static ChameleonExecutor	instance(File root) Gets the instance of Chameleon, i.e.
private static void	setTimeFactory(int factor)
private void	start(File root) Starts the underlying Chameleon instance.
private void	stop() Stops the underlying chameleon instance.
static void	stopRunningInstance() Stops the running Chameleon.
ChameleonExecutor	waitForStability() Waits for stability of the underlying frameworks.

Methods inherited from class java.lang.Object

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

Field Detail

APPLICATION_BUNDLE

private static final String APPLICATION_BUNDLE

See Also:

Constant Field Values

INSTANCE

private static ChameleonExecutor INSTANCE

root

private File root

Constructor Detail

ChameleonExecutor

private ChameleonExecutor()

Method Detail

instance

public static ChameleonExecutor instance(File root)
                                  throws org.osgi.framework.BundleException,
                                         IOException

Gets the instance of Chameleon, i.e. the OSGi Framework where the test are executed.

Parameters:

root - the base directory of the Chameleon.

Returns:

the Chameleon Executor instance, newly created if none, or reuses if any.

Throws:

IOException - if the chameleon configuration cannot be read.

org.osgi.framework.BundleException - if the chameleon cannot be started.

stopRunningInstance

public static void stopRunningInstance()
                                throws Exception

Stops the running Chameleon.

Throws:

Exception - if the Chameleon instance cannot be stopped.

start

private void start(File root)
            throws org.osgi.framework.BundleException,
                   IOException

Starts the underlying Chameleon instance.

Parameters:

root - the base directory of the Chameleon.

Throws:

IOException - if the chameleon configuration cannot be read.

org.osgi.framework.BundleException - if the chameleon cannot be started.

setTimeFactory

private static void setTimeFactory(int factor)

getFactorAsAnInteger

private int getFactorAsAnInteger(String factor)

context

public org.osgi.framework.BundleContext context()

Returns:

the bundle context of the underlying Chameleon, null if not started.

waitForStability

public ChameleonExecutor waitForStability()

Waits for stability of the underlying frameworks.

Returns:

the current instance

stop

private void stop()
           throws Exception

Stops the underlying chameleon instance. If we have an application artifact, restore it in the 'application' directory. It may have been deleted from the 'application' directory before running the integration tests.

Throws:

Exception - if it cannot be stopped.

deployProbe

public static org.osgi.framework.Bundle deployProbe()
                                             throws org.osgi.framework.BundleException

Deploys the `probe` bundle, i.e. the bundle containing the test classes and the Wisdom Test Utilities (such as the InVivo Runner). If such a bundle is already deployed, nothing is done, else, the probe bundle is built, installed and started.

Initially, this method was returning null. In the 0.7 version, it changes to Bundle. The returned object is the installed bundle.

Returns:

the probe bundle.

Throws:

org.osgi.framework.BundleException - if the probe bundle cannot be started.

deployApplication

public static void deployApplication()
                              throws org.osgi.framework.BundleException

Builds and deploy the application bundle. This method is called the application bundle is not in the runtime or application directories.

Throws:

org.osgi.framework.BundleException

getInVivoRunnerInstance

public InVivoRunner getInVivoRunnerInstance(Class<?> clazz)
                                     throws org.junit.runners.model.InitializationError,
                                            ClassNotFoundException,
                                            IOException

Retrieves the InVivoRunner Factory and creates an instance.

Parameters:

clazz - the test class

Returns:

the runner

Throws:

org.junit.runners.model.InitializationError

ClassNotFoundException

IOException