org.eclipse.gemini.blueprint.extender.internal.activator

Class LifecycleManager

java.lang.Object

org.eclipse.gemini.blueprint.extender.internal.activator.LifecycleManager

All Implemented Interfaces:

org.springframework.beans.factory.DisposableBean

class LifecycleManager
extends java.lang.Object
implements org.springframework.beans.factory.DisposableBean

Manager handling the startup/shutdown threading issues regarding OSGi contexts. Used by ContextLoaderListener .

Field Summary

Fields

Modifier and Type	Field and Description
private org.osgi.framework.BundleContext	bundleContext
private ApplicationContextConfigurationFactory	contextConfigurationFactory
private OsgiApplicationContextCreator	contextCreator ApplicationContext Creator
private Counter	contextsStarted listener counter - used to properly synchronize shutdown
private ExtenderConfiguration	extenderConfiguration
private static org.apache.commons.logging.Log	log logger
private java.util.Map<java.lang.Long,ConfigurableOsgiBundleApplicationContext>	managedContexts The contexts we are currently managing.
private OsgiBundleApplicationContextEventMulticaster	multicaster
private java.util.List<OsgiBeanFactoryPostProcessor>	postProcessors BFPP list
private OsgiContextProcessor	processor
private org.springframework.core.task.TaskExecutor	sameThreadTaskExecutor Task executor which uses the same thread for running tasks.
private org.springframework.core.task.TaskExecutor	shutdownTaskExecutor shutdown task executor
private org.springframework.core.task.TaskExecutor	taskExecutor Task executor used for bootstraping the Spring contexts in async mode
private java.util.Timer	timer
private TypeCompatibilityChecker	typeChecker
private VersionMatcher	versionMatcher

Constructor Summary

Constructors

Constructor and Description
LifecycleManager(ExtenderConfiguration extenderConfiguration, VersionMatcher versionMatcher, ApplicationContextConfigurationFactory appCtxCfgFactory, OsgiContextProcessor processor, TypeCompatibilityChecker checker, org.osgi.framework.BundleContext context)

Method Summary

Modifier and Type	Method and Description
private void	closeApplicationContext(ConfigurableOsgiBundleApplicationContext ctx) Closes an application context.
void	destroy()
ConfigurableOsgiBundleApplicationContext	getManagedContext(org.osgi.framework.Bundle bundle)
protected void	maybeCloseApplicationContextFor(org.osgi.framework.Bundle bundle) Closing an application context is a potentially long-running activity, however, we *have* to do it synchronously during the event process as the BundleContext object is not valid once we return from this method.
protected void	maybeCreateApplicationContextFor(org.osgi.framework.Bundle bundle) Context creation is a potentially long-running activity (certainly more than we want to do on the synchronous event callback).
private void	stopTaskExecutor() Do some additional waiting so the service dependency listeners detect the shutdown.
private void	stopTimer() Cancel any tasks scheduled for the timer.

Methods inherited from class java.lang.Object

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

Field Detail

log

private static final org.apache.commons.logging.Log log

logger

managedContexts

private final java.util.Map<java.lang.Long,ConfigurableOsgiBundleApplicationContext> managedContexts

The contexts we are currently managing. Keys are bundle ids, values are ServiceDependentOsgiApplicationContexts for the application context

contextsStarted

private Counter contextsStarted

listener counter - used to properly synchronize shutdown

timer

private final java.util.Timer timer

taskExecutor

private final org.springframework.core.task.TaskExecutor taskExecutor

Task executor used for bootstraping the Spring contexts in async mode

contextCreator

private final OsgiApplicationContextCreator contextCreator

ApplicationContext Creator

postProcessors

private final java.util.List<OsgiBeanFactoryPostProcessor> postProcessors

BFPP list

shutdownTaskExecutor

private final org.springframework.core.task.TaskExecutor shutdownTaskExecutor

shutdown task executor

sameThreadTaskExecutor

private final org.springframework.core.task.TaskExecutor sameThreadTaskExecutor

Task executor which uses the same thread for running tasks. Used when doing a synchronous wait-for-dependencies.

multicaster

private final OsgiBundleApplicationContextEventMulticaster multicaster

extenderConfiguration

private final ExtenderConfiguration extenderConfiguration

bundleContext

private final org.osgi.framework.BundleContext bundleContext

processor

private final OsgiContextProcessor processor

contextConfigurationFactory

private final ApplicationContextConfigurationFactory contextConfigurationFactory

versionMatcher

private final VersionMatcher versionMatcher

typeChecker

private final TypeCompatibilityChecker typeChecker

Constructor Detail

LifecycleManager

LifecycleManager(ExtenderConfiguration extenderConfiguration,
                 VersionMatcher versionMatcher,
                 ApplicationContextConfigurationFactory appCtxCfgFactory,
                 OsgiContextProcessor processor,
                 TypeCompatibilityChecker checker,
                 org.osgi.framework.BundleContext context)

Method Detail

maybeCreateApplicationContextFor

protected void maybeCreateApplicationContextFor(org.osgi.framework.Bundle bundle)

Context creation is a potentially long-running activity (certainly more than we want to do on the synchronous event callback).

Based on our configuration, the context can be started on the same thread or on a different one.

Kick off a background activity to create an application context for the given bundle if needed. Note: Make sure to do the fastest filtering first to avoid slow-downs on platforms with a big number of plugins and wiring (i.e. Eclipse platform).

Parameters:

bundle -

maybeCloseApplicationContextFor

protected void maybeCloseApplicationContextFor(org.osgi.framework.Bundle bundle)

Closing an application context is a potentially long-running activity, however, we *have* to do it synchronously during the event process as the BundleContext object is not valid once we return from this method.

Parameters:

bundle -

closeApplicationContext

private void closeApplicationContext(ConfigurableOsgiBundleApplicationContext ctx)

Closes an application context. This is a convenience methods that invokes the event notification as well.

Parameters:

ctx -

destroy

public void destroy()

Specified by:

destroy in interface org.springframework.beans.factory.DisposableBean

getManagedContext

public ConfigurableOsgiBundleApplicationContext getManagedContext(org.osgi.framework.Bundle bundle)

stopTaskExecutor

private void stopTaskExecutor()

Do some additional waiting so the service dependency listeners detect the shutdown.

stopTimer

private void stopTimer()

Cancel any tasks scheduled for the timer.