DependencyActivatorBase

java.lang.Object
- org.apache.felix.dm.DependencyActivatorBase

All Implemented Interfaces:

org.osgi.framework.BundleActivator
```
public abstract class DependencyActivatorBase
extends java.lang.Object
implements org.osgi.framework.BundleActivator
```
Base bundle activator class. Subclass this activator if you want to use dependency management in your bundle. There are two methods you should implement: init() and destroy(). Both methods take two arguments, the bundle context and the dependency manager. The dependency manager can be used to define all the dependencies.

Constructor Summary

Constructors
Constructor and Description

DependencyActivatorBase()

Constructors
Constructor and Description
`DependencyActivatorBase()`

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`Component`	`createAdapterService(java.lang.Class<?> serviceInterface, java.lang.String serviceFilter)` Creates a new adapter service.
`Component`	`createAdapterService(java.lang.Class<?> serviceInterface, java.lang.String serviceFilter, java.lang.String autoConfig)` Creates a new adapter service.
`Component`	`createAdapterService(java.lang.Class<?> serviceInterface, java.lang.String serviceFilter, java.lang.String autoConfig, java.lang.Object callbackInstance, java.lang.String add, java.lang.String change, java.lang.String remove, java.lang.String swap)` Creates a new adapter service.
`Component`	`createAdapterService(java.lang.Class<?> serviceInterface, java.lang.String serviceFilter, java.lang.String autoConfig, java.lang.Object callbackInstance, java.lang.String add, java.lang.String change, java.lang.String remove, java.lang.String swap, boolean propagate)` Creates a new adapter service.
`Component`	`createAdapterService(java.lang.Class<?> serviceInterface, java.lang.String serviceFilter, java.lang.String add, java.lang.String change, java.lang.String remove)` Creates a new adapter service.
`Component`	`createAdapterService(java.lang.Class<?> serviceInterface, java.lang.String serviceFilter, java.lang.String add, java.lang.String change, java.lang.String remove, java.lang.String swap)` Creates a new adapter service.
`Component`	`createAspectService(java.lang.Class<?> serviceInterface, java.lang.String serviceFilter, int ranking)` Creates a new aspect service.
`Component`	`createAspectService(java.lang.Class<?> serviceInterface, java.lang.String serviceFilter, int ranking, java.lang.Object callbackInstance, java.lang.String add, java.lang.String change, java.lang.String remove, java.lang.String swap)` Creates a new aspect service.
`Component`	`createAspectService(java.lang.Class<?> serviceInterface, java.lang.String serviceFilter, int ranking, java.lang.String attributeName)` Creates a new aspect service.
`Component`	`createAspectService(java.lang.Class<?> serviceInterface, java.lang.String serviceFilter, int ranking, java.lang.String add, java.lang.String change, java.lang.String remove)` Creates a new aspect service.
`Component`	`createAspectService(java.lang.Class<?> serviceInterface, java.lang.String serviceFilter, int ranking, java.lang.String add, java.lang.String change, java.lang.String remove, java.lang.String swap)` Creates a new aspect service.
`Component`	`createBundleAdapterService(int bundleStateMask, java.lang.String bundleFilter, boolean propagate)` Creates a new bundle adapter service.
`Component`	`createBundleAdapterService(int bundleStateMask, java.lang.String bundleFilter, boolean propagate, java.lang.Object callbackInstance, java.lang.String add, java.lang.String change, java.lang.String remove)` Creates a new bundle adapter service, using a specific callback instance
`BundleDependency`	`createBundleDependency()` Creates a new bundle dependency.
`Component`	`createComponent()` Creates a new component.
`ConfigurationDependency`	`createConfigurationDependency()` Creates a new configuration dependency.
`Component`	`createFactoryConfigurationAdapterService(java.lang.String factoryPid, java.lang.String update, boolean propagate)` Creates a new factory configuration adapter service.
`Component`	`createFactoryConfigurationAdapterService(java.lang.String factoryPid, java.lang.String update, boolean propagate, java.lang.Class<?> configType)` Creates a new factory configuration adapter service, using a specific callback instance
`Component`	`createFactoryConfigurationAdapterService(java.lang.String factoryPid, java.lang.String update, boolean propagate, java.lang.Object callbackInstance)` Creates a new factory configuration adapter service, using a specific callback instance
`Component`	`createFactoryConfigurationAdapterService(java.lang.String factoryPid, java.lang.String update, boolean propagate, java.lang.Object callbackInstance, java.lang.Class<?> configType)` Creates a new factory configuration adapter service, using a specific callback instance
`Component`	`createFactoryConfigurationAdapterService(java.lang.String factoryPid, java.lang.String update, boolean propagate, java.lang.String heading, java.lang.String desc, java.lang.String localization, PropertyMetaData[] propertiesMetaData)` Creates a new factory configuration adapter service.
`PropertyMetaData`	`createPropertyMetaData()` Creates a new configuration property metadata.
`Component`	`createResourceAdapter(java.lang.String resourceFilter, boolean propagate, java.lang.Object callbackInstance, java.lang.String callbackChanged)` Creates a new resource adapter service.
`Component`	`createResourceAdapter(java.lang.String resourceFilter, boolean propagate, java.lang.Object callbackInstance, java.lang.String callbackSet, java.lang.String callbackChanged)` Creates a new resource adapter service.
`Component`	`createResourceAdapter(java.lang.String resourceFilter, java.lang.Object propagateCallbackInstance, java.lang.String propagateCallbackMethod, java.lang.Object callbackInstance, java.lang.String callbackChanged)` Creates a new resource adapter service.
`Component`	`createResourceAdapter(java.lang.String resourceFilter, java.lang.Object propagateCallbackInstance, java.lang.String propagateCallbackMethod, java.lang.Object callbackInstance, java.lang.String callbackSet, java.lang.String callbackChanged)` Creates a new resource adapter service.
`ResourceDependency`	`createResourceDependency()` Creates a new resource dependency.
`ServiceDependency`	`createServiceDependency()` Creates a new service dependency.
`ServiceDependency`	`createTemporalServiceDependency(long timeout)` Creates a new temporal service dependency.
`void`	`destroy(org.osgi.framework.BundleContext context, DependencyManager manager)` Destroy the dependency manager.
`org.osgi.framework.BundleContext`	`getBundleContext()` Returns the bundle context that is associated with this bundle.
`DependencyManager`	`getDependencyManager()` Returns the dependency manager that is associated with this bundle.
`Logger`	`getLogger()` Returns the logger that is associated with this bundle.
`abstract void`	`init(org.osgi.framework.BundleContext context, DependencyManager manager)` Initialize the dependency manager.
`void`	`start(org.osgi.framework.BundleContext context)` Start method of the bundle activator.
`void`	`stop(org.osgi.framework.BundleContext context)` Stop method of the bundle activator.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail
- DependencyActivatorBase
```
public DependencyActivatorBase()
```

Method Detail

init
```
public abstract void init(org.osgi.framework.BundleContext context,
                          DependencyManager manager)
                   throws java.lang.Exception
```
Initialize the dependency manager. Here you can add all components and their dependencies. If something goes wrong and you do not want your bundle to be started, you can throw an exception. This exception will be passed on to the start() method of the bundle activator, causing the bundle not to start.

Parameters:

context - the bundle context

manager - the dependency manager

Throws:

java.lang.Exception - if the initialization fails

destroy
```
public void destroy(org.osgi.framework.BundleContext context,
                    DependencyManager manager)
             throws java.lang.Exception
```
Destroy the dependency manager. Here you can remove all components and their dependencies. Actually, the base class will clean up your dependencies anyway, so most of the time you don't need to do anything here.
If something goes wrong and you do not want your bundle to be stopped, you can throw an exception. This exception will be passed on to the stop() method of the bundle activator, causing the bundle not to stop.

Parameters:

context - the bundle context

manager - the dependency manager

Throws:

java.lang.Exception - if the destruction fails

start
```
public void start(org.osgi.framework.BundleContext context)
           throws java.lang.Exception
```
Start method of the bundle activator. Initializes the dependency manager and calls init().

Specified by:

start in interface org.osgi.framework.BundleActivator

Parameters:

context - the bundle context

Throws:

java.lang.Exception

stop
```
public void stop(org.osgi.framework.BundleContext context)
          throws java.lang.Exception
```
Stop method of the bundle activator. Calls the destroy() method and cleans up all left over dependencies.

Specified by:

stop in interface org.osgi.framework.BundleActivator

Parameters:

context - the bundle context

Throws:

java.lang.Exception

getBundleContext
```
public org.osgi.framework.BundleContext getBundleContext()
```
Returns the bundle context that is associated with this bundle.

Returns:

the bundle context

getDependencyManager
```
public DependencyManager getDependencyManager()
```
Returns the dependency manager that is associated with this bundle.

Returns:

the dependency manager

getLogger
```
public Logger getLogger()
```
Returns the logger that is associated with this bundle. A logger instance is a proxy that will log to a real OSGi logservice if available and standard out if not.

Returns:

the logger

createComponent
```
public Component createComponent()
```
Creates a new component.

Returns:

the new component

createServiceDependency
```
public ServiceDependency createServiceDependency()
```
Creates a new service dependency.

Returns:

the service dependency

createTemporalServiceDependency
```
public ServiceDependency createTemporalServiceDependency(long timeout)
```
Creates a new temporal service dependency.

Parameters:

timeout - the max number of milliseconds to wait for a service availability.

Returns:

the service dependency

createConfigurationDependency
```
public ConfigurationDependency createConfigurationDependency()
```
Creates a new configuration dependency.

Returns:

the configuration dependency

createPropertyMetaData
```
public PropertyMetaData createPropertyMetaData()
```
Creates a new configuration property metadata.

Returns:

the configuration property metadata

createBundleDependency
```
public BundleDependency createBundleDependency()
```
Creates a new bundle dependency.

Returns:

the bundle dependency

createResourceDependency
```
public ResourceDependency createResourceDependency()
```
Creates a new resource dependency.

Returns:

the resource dependency

createAspectService

public Component createAspectService(java.lang.Class<?> serviceInterface,
                                     java.lang.String serviceFilter,
                                     int ranking,
                                     java.lang.String attributeName)

Creates a new aspect service.

Returns:: the aspect service
See Also:: DependencyManager.createAspectService(Class, String, int, String)

createAspectService

public Component createAspectService(java.lang.Class<?> serviceInterface,
                                     java.lang.String serviceFilter,
                                     int ranking)

Creates a new aspect service.

Returns:: the aspect service
See Also:: DependencyManager.createAspectService(Class, String, int)

createAspectService

public Component createAspectService(java.lang.Class<?> serviceInterface,
                                     java.lang.String serviceFilter,
                                     int ranking,
                                     java.lang.String add,
                                     java.lang.String change,
                                     java.lang.String remove)

Creates a new aspect service.

Returns:: the aspect service
See Also:: DependencyManager.createAspectService(Class, String, int, String, String, String)

createAspectService

public Component createAspectService(java.lang.Class<?> serviceInterface,
                                     java.lang.String serviceFilter,
                                     int ranking,
                                     java.lang.String add,
                                     java.lang.String change,
                                     java.lang.String remove,
                                     java.lang.String swap)

Creates a new aspect service.

Returns:: the aspect service
See Also:: DependencyManager.createAspectService(Class, String, int, String, String, String, String)

createAspectService

public Component createAspectService(java.lang.Class<?> serviceInterface,
                                     java.lang.String serviceFilter,
                                     int ranking,
                                     java.lang.Object callbackInstance,
                                     java.lang.String add,
                                     java.lang.String change,
                                     java.lang.String remove,
                                     java.lang.String swap)

Creates a new aspect service.

Returns:: the aspect service
See Also:: DependencyManager.createAspectService(Class, String, int, Object, String, String, String, String)