org.ow2.chameleon.core

Class Chameleon

java.lang.Object

org.ow2.chameleon.core.Chameleon

public class Chameleon
extends Object

Chameleon main entry point.

Constructor Summary

Constructors

Constructor and Description
Chameleon(boolean interactive) Creates a Chameleon instance.
Chameleon(ChameleonConfiguration configuration) Creates a chameleon instance.
Chameleon(File basedir, boolean interactive) Creates a chameleon instance.
Chameleon(String basedir, boolean interactive) Creates a Chameleon instance.

Method Summary

Methods

Modifier and Type	Method and Description
org.osgi.framework.BundleContext	context() Retrieves the bundle context of the underlying framework.
org.osgi.framework.launch.Framework	framework() Retrieves the underlying framework.
static org.slf4j.Logger	initializeLoggingSystem(ChameleonConfiguration configuration) Initialized the logging framework (backend).
void	start() Initializes and Starts the Chameleon frameworks.
void	stop() Stops the underlying framework.

Methods inherited from class java.lang.Object

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

Constructor Detail

Chameleon

public Chameleon(File basedir,
         boolean interactive)
          throws Exception

Creates a chameleon instance.

Parameters:

basedir - the base directory

interactive - if the interactive mode enabled.

Throws:

Exception - if the chameleon instance cannot be created.

Chameleon

public Chameleon(ChameleonConfiguration configuration)
          throws Exception

Creates a chameleon instance.

Parameters:

configuration - the configuration to use

Throws:

Exception - if the chameleon instance cannot be created.

Chameleon

public Chameleon(boolean interactive)
          throws Exception

Creates a Chameleon instance. This constructor does not allows to set the core directory (so, uses 'core'), nor the chameleon properties.

Parameters:

interactive - is the debug mode enabled.

Throws:

Exception - something wrong happens.

Chameleon

public Chameleon(String basedir,
         boolean interactive)
          throws Exception

Creates a Chameleon instance. This constructor does not allows to set the core directory (so, uses 'core'), nor the chameleon properties.

Parameters:

basedir - the chameleon's base directory

interactive - is the debug mode enabled.

Throws:

Exception - something wrong happens.

Method Detail

initializeLoggingSystem

public static org.slf4j.Logger initializeLoggingSystem(ChameleonConfiguration configuration)
                                                throws IOException

Initialized the logging framework (backend).

Parameters:

configuration - chameleon's configuration.

Returns:

the chameleon logger

Throws:

IOException

start

public void start()
           throws org.osgi.framework.BundleException

Initializes and Starts the Chameleon frameworks. It configure the embedded OSGi framework and deploys bundles

Throws:

org.osgi.framework.BundleException - if a bundle cannot be installed or started correctly.

stop

public void stop()
          throws org.osgi.framework.BundleException,
                 InterruptedException

Stops the underlying framework.

Throws:

org.osgi.framework.BundleException - should not happen.

InterruptedException - if the method is interrupted during the waiting time.

context

public org.osgi.framework.BundleContext context()

Retrieves the bundle context of the underlying framework. The framework must have been successfully started first.

Returns:

the bundle context

framework

public org.osgi.framework.launch.Framework framework()

Retrieves the underlying framework. The framework must have been successfully started first.

Returns:

the bundle context