org.apache.felix.scr.impl

Class Activator

java.lang.Object

org.apache.felix.scr.impl.AbstractExtender

org.apache.felix.scr.impl.Activator

All Implemented Interfaces:

java.util.EventListener, SimpleLogger, org.osgi.framework.BundleActivator, org.osgi.framework.BundleListener, org.osgi.framework.SynchronousBundleListener, org.osgi.util.tracker.BundleTrackerCustomizer<org.osgi.framework.Bundle>

public class Activator
extends AbstractExtender
implements SimpleLogger

This activator is used to cover requirement described in section 112.8.1 @@ -27,14 37,202 @@ in active bundles.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Activator.ScrExtension

Field Summary

Fields

Modifier and Type	Field and Description
(package private) static java.lang.String	LOGSERVICE_CLASS
private org.osgi.framework.Bundle	m_bundle
private ComponentActorThread	m_componentActor
private java.util.Map<java.lang.Long,BundleComponentActivator>	m_componentBundles
private ComponentRegistry	m_componentRegistry
private ScrConfigurationImpl	m_configuration
private org.osgi.framework.BundleContext	m_context
private org.osgi.framework.BundleContext	m_globalContext
private org.osgi.util.tracker.ServiceTracker<org.osgi.service.log.LogService,org.osgi.service.log.LogService>	m_logService
private org.osgi.framework.ServiceRegistration<?>	m_runtime_reg
private ScrCommand	m_scrCommand

Constructor Summary

Constructors

Constructor and Description
Activator()

Method Summary

Modifier and Type	Method and Description
protected void	debug(org.osgi.framework.Bundle bundle, java.lang.String msg)
private void	disposeComponents(org.osgi.framework.Bundle bundle) Unloads components of the given bundle.
protected Activator.ScrExtension	doCreateExtension(org.osgi.framework.Bundle bundle) Create the extension for the given bundle, or null if the bundle is not to be extended.
protected void	doStart()
void	doStop() Unregisters this instance as a bundle listener and unloads all components which have been registered during the active life time of the SCR implementation bundle.
boolean	isLogEnabled(int level) Returns true if logging for the given level is enabled.
private void	loadComponents(org.osgi.framework.Bundle bundle) Loads the components of the given bundle.
void	log(int level, org.osgi.framework.Bundle bundle, java.lang.String pattern, java.lang.Object[] arguments, java.lang.Throwable ex)
void	log(int level, org.osgi.framework.Bundle bundle, java.lang.String message, java.lang.Throwable ex) Method to actually emit the log message.
void	log(int level, java.lang.String pattern, java.lang.Object[] arguments, java.lang.Throwable ex)
void	log(int level, java.lang.String message, java.lang.Throwable ex)
void	restart(boolean globalExtender)
void	start(org.osgi.framework.BundleContext context) Registers this instance as a (synchronous) bundle listener and loads the components of already registered bundles.
void	stop(org.osgi.framework.BundleContext context)
protected void	warn(org.osgi.framework.Bundle bundle, java.lang.String msg, java.lang.Throwable t)

Methods inherited from class org.apache.felix.scr.impl.AbstractExtender

addingBundle, bundleChanged, chooseBundlesToDestroy, createExecutor, getBundleContext, isStopping, modifiedBundle, removedBundle, startTracking, stopTracking

Methods inherited from class java.lang.Object

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

Field Detail

LOGSERVICE_CLASS

static final java.lang.String LOGSERVICE_CLASS

See Also:

Constant Field Values

m_configuration

private ScrConfigurationImpl m_configuration

m_context

private org.osgi.framework.BundleContext m_context

m_globalContext

private org.osgi.framework.BundleContext m_globalContext

m_bundle

private org.osgi.framework.Bundle m_bundle

m_logService

private volatile org.osgi.util.tracker.ServiceTracker<org.osgi.service.log.LogService,org.osgi.service.log.LogService> m_logService

m_componentBundles

private java.util.Map<java.lang.Long,BundleComponentActivator> m_componentBundles

m_componentRegistry

private ComponentRegistry m_componentRegistry

m_componentActor

private ComponentActorThread m_componentActor

m_runtime_reg

private org.osgi.framework.ServiceRegistration<?> m_runtime_reg

m_scrCommand

private ScrCommand m_scrCommand

Constructor Detail

Activator

public Activator()

Method Detail

start

public void start(org.osgi.framework.BundleContext context)
           throws java.lang.Exception

Registers this instance as a (synchronous) bundle listener and loads the components of already registered bundles.

Specified by:

start in interface org.osgi.framework.BundleActivator

Overrides:

start in class AbstractExtender

Parameters:

context - The BundleContext of the SCR implementation bundle.

Throws:

java.lang.Exception

restart

public void restart(boolean globalExtender)

doStart

protected void doStart()
                throws java.lang.Exception

Overrides:

doStart in class AbstractExtender

Throws:

java.lang.Exception

stop

public void stop(org.osgi.framework.BundleContext context)
          throws java.lang.Exception

Specified by:

stop in interface org.osgi.framework.BundleActivator

Overrides:

stop in class AbstractExtender

Throws:

java.lang.Exception

doStop

public void doStop()
            throws java.lang.Exception

Unregisters this instance as a bundle listener and unloads all components which have been registered during the active life time of the SCR implementation bundle.

Overrides:

doStop in class AbstractExtender

Throws:

java.lang.Exception

doCreateExtension

protected Activator.ScrExtension doCreateExtension(org.osgi.framework.Bundle bundle)
                                            throws java.lang.Exception

Description copied from class: AbstractExtender

Create the extension for the given bundle, or null if the bundle is not to be extended.

Specified by:

doCreateExtension in class AbstractExtender

Parameters:

bundle - the bundle to extend

Returns:

The extension

Throws:

java.lang.Exception - If something goes wrong

loadComponents

private void loadComponents(org.osgi.framework.Bundle bundle)

Loads the components of the given bundle. If the bundle has no Service-Component header, this method has no effect. The fragments of a bundle are not checked for the header (112.4.1).

This method calls the Bundle.getBundleContext() method to find the BundleContext of the bundle. If the context cannot be found, this method does not load components for the bundle.

disposeComponents

private void disposeComponents(org.osgi.framework.Bundle bundle)

Unloads components of the given bundle. If no components have been loaded for the bundle, this method has no effect.

debug

protected void debug(org.osgi.framework.Bundle bundle,
                     java.lang.String msg)

Specified by:

debug in class AbstractExtender

warn

protected void warn(org.osgi.framework.Bundle bundle,
                    java.lang.String msg,
                    java.lang.Throwable t)

Specified by:

warn in class AbstractExtender

log

public void log(int level,
                java.lang.String message,
                java.lang.Throwable ex)

Specified by:

log in interface SimpleLogger

log

public void log(int level,
                java.lang.String pattern,
                java.lang.Object[] arguments,
                java.lang.Throwable ex)

Specified by:

log in interface SimpleLogger

log

public void log(int level,
                org.osgi.framework.Bundle bundle,
                java.lang.String pattern,
                java.lang.Object[] arguments,
                java.lang.Throwable ex)

isLogEnabled

public boolean isLogEnabled(int level)

Returns true if logging for the given level is enabled.

Specified by:

isLogEnabled in interface SimpleLogger

log

public void log(int level,
                org.osgi.framework.Bundle bundle,
                java.lang.String message,
                java.lang.Throwable ex)

Method to actually emit the log message. If the LogService is available, the message will be logged through the LogService. Otherwise the message is logged to stdout (or stderr in case of LOG_ERROR level messages),

Parameters:

level - The log level to log the message at

message - The message to log

ex - An optional Throwable whose stack trace is written, or null to not log a stack trace.