com.communote.server.core.osgi

Class OSGiManagement

java.lang.Object

com.communote.server.core.osgi.OSGiManagement

All Implemented Interfaces:

InitializationCompleteListener, EventListener, org.osgi.framework.BundleListener

@Service(value="oSGiManagement")
public class OSGiManagement
extends Object
implements org.osgi.framework.BundleListener, InitializationCompleteListener

Service for managing the OSGi Framework.

Author:

Communote GmbH - http://www.communote.com/

Field Summary

Fields

Modifier and Type	Field and Description
static String	PROPERTY_KEY_SYMBOLIC_NAME A property key for symbolic name, which could be used accross the whole application.

Constructor Summary

Constructors

Constructor and Description
OSGiManagement()

Method Summary

Modifier and Type	Method and Description
void	addFrameworkPropertiesLocation(String location) Add a location to look for an properties file which defines additional settings that should be passed to OSGi framework when it is created.
void	addListener(CommunoteBundleListener listener)
void	addListeners(Collection<CommunoteBundleListener> listeners)
void	bundleChanged(org.osgi.framework.BundleEvent event) Listens to bundle changes.
org.osgi.framework.launch.Framework	getFramework()
Collection<CommunoteBundleListener>	getListeners()
void	initializationComplete()
boolean	isBundleStarted(String symbolicName)
void	start() Starts the framework.
void	stop() Stops the Framework

Methods inherited from class java.lang.Object

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

Field Detail

PROPERTY_KEY_SYMBOLIC_NAME

public static final String PROPERTY_KEY_SYMBOLIC_NAME

A property key for symbolic name, which could be used accross the whole application.

See Also:

Constant Field Values

Constructor Detail

OSGiManagement

public OSGiManagement()

Method Detail

addFrameworkPropertiesLocation

public void addFrameworkPropertiesLocation(String location)

Add a location to look for an properties file which defines additional settings that should be passed to OSGi framework when it is created. The settings will override the default settings of the core. An exception is the property org.osgi.framework.system.packages.extra. This property will be merged by appending the value after a comma. Adding locations after the framework was started has no effect.

Parameters:

location - a location of a properties file on the classpath or filesystem. The former has to start with classpath: and the latter with file:

addListener

public void addListener(CommunoteBundleListener listener)

Parameters:

listener - Listener.

addListeners

@Autowired(required=false)
public void addListeners(Collection<CommunoteBundleListener> listeners)

Parameters:

listeners - List of listeners.

bundleChanged

public void bundleChanged(org.osgi.framework.BundleEvent event)

Listens to bundle changes.

Specified by:

bundleChanged in interface org.osgi.framework.BundleListener

Parameters:

event - The event.

getFramework

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

Returns:

the framework or null if not yet started

getListeners

public Collection<CommunoteBundleListener> getListeners()

Returns:

The listeners.

initializationComplete

public void initializationComplete()

Specified by:

initializationComplete in interface InitializationCompleteListener

isBundleStarted

public boolean isBundleStarted(String symbolicName)

Parameters:

symbolicName - The symbolic name of the bundle.

Returns:

true, when the bundle is started, else false.

start

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

Starts the framework. There is usually no reason to call this method manually because it will be invoked automatically by the initializationComplete() callback.

Throws:

org.osgi.framework.BundleException - Exception.

stop

public void stop()

Stops the Framework