org.eclipse.soda.dk.core.managed
Class CoreManaged

java.lang.Object
  ManagedServiceBundleActivator
      org.eclipse.soda.dk.core.managed.CoreManaged

All Implemented Interfaces:

org.osgi.service.cm.ManagedService

Direct Known Subclasses:

AdapterManaged, AgentManaged, ConnectionManaged, DeviceManaged, ProfileManaged, TransportManaged

public abstract class CoreManaged
extends ManagedServiceBundleActivator
implements org.osgi.service.cm.ManagedService

The ConnectionBundle is the standard Bundle Activator for all other transport bundle activators to subclass.

Since:

1.0

Version:

1.2.0

Field Summary

static java.lang.String	CONFIGURATION_ADMIN_SERVICE Define the configuration admin service (String) constant.
static java.lang.String	ID_KEY Define the id key (String) constant.
static java.lang.String	ID_KEY_FILTER Define the id key filter (String) constant.
static java.lang.String[]	IMPORTED_SERVICES Define the imported services (String[]) constant.
static java.lang.String	METATYPE_SERVICE Define the metatype service (String) constant.
static java.lang.String[]	OPTIONAL_SERVICES Define the optional service (String[]) constant.

Constructor Summary

CoreManaged()

Method Summary

protected IManagedServiceAdvisor	createAdvisor() Create advisor and return the IManagedServiceAdvisor result.
void	createImportedServiceFilters(java.lang.String pid, java.util.Dictionary oldProperties, java.util.Dictionary properties, IBundleActivationManager manager) Create imported service filters with the specified pid, old properties, properties and manager parameters.
java.util.Hashtable	createProperties() Create the properties.
abstract java.lang.String[]	getExportedServiceNames(java.lang.String pid, java.util.Dictionary oldProperties, java.util.Dictionary properties, IBundleActivationManager manager) Gets the service names (String[]) value.
protected java.lang.String[]	getImportedServiceNames() Gets the imported service names (String[]) value.
java.lang.String[]	getImportedServiceNames(java.lang.String pid, java.util.Dictionary arg1, java.util.Dictionary arg2, IBundleActivationManager manager) Get imported service names with the specified pid, arg1, arg2 and manager parameters and return the String[] result.
java.lang.String	getInterestServiceName() Gets the interest service name (String) value.
protected java.lang.String[]	getOptionalImportedServiceNames() Gets the optional imported service names (String[]) value.
java.lang.String[]	getOptionalImportedServiceNames(java.lang.String pid, java.util.Dictionary arg1, java.util.Dictionary arg2, IBundleActivationManager arg3) Get optional imported service names with the specified pid, arg1, arg2 and arg3 parameters and return the String[] result.
void	handleAcquiredOptionalImportedService(java.lang.String pid, java.lang.Object arg1, java.lang.String arg2, java.lang.Object arg3, IBundleActivationManager arg4) Handle acquired optional imported service with the specified pid, arg1, arg2, arg3 and arg4 parameters.
protected void	handleAcquiredOptionalImportedService(java.lang.String pid, java.lang.String serviceName, java.lang.Object service) Handle acquired optional imported service with the specified service name and service parameters.
void	handleReleasedOptionalImportedService(java.lang.String pid, java.lang.Object arg1, java.lang.String arg2, java.lang.Object arg3, IBundleActivationManager arg4) Handle released optional imported service with the specified pid, arg1, arg2, arg3 and arg4 parameters.
protected void	handleReleasedOptionalImportedService(java.lang.String pid, java.lang.String serviceName, java.lang.Object service) Handle released optional imported service with the specified service name and service parameters.
void	updateProperties(java.util.Dictionary table, java.util.Dictionary from) Update properties with the specified table and from parameters.
void	updateProperties(java.util.Dictionary table, java.util.Map from) Update properties with the specified table and from parameters.
void	validateConfiguration(java.lang.String pid, java.util.Dictionary properties) Validate configuration with the specified pid and properties parameters.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.osgi.service.cm.ManagedService

updated

Field Detail

METATYPE_SERVICE

public static final java.lang.String METATYPE_SERVICE

Define the metatype service (String) constant.

CONFIGURATION_ADMIN_SERVICE

public static final java.lang.String CONFIGURATION_ADMIN_SERVICE

Define the configuration admin service (String) constant.

IMPORTED_SERVICES

public static final java.lang.String[] IMPORTED_SERVICES

Define the imported services (String[]) constant.

OPTIONAL_SERVICES

public static final java.lang.String[] OPTIONAL_SERVICES

Define the optional service (String[]) constant.

ID_KEY_FILTER

public static final java.lang.String ID_KEY_FILTER

Define the id key filter (String) constant.

See Also:

Constant Field Values

ID_KEY

public static final java.lang.String ID_KEY

Define the id key (String) constant.

See Also:

Constant Field Values

Constructor Detail

CoreManaged

public CoreManaged()

Method Detail

createAdvisor

protected IManagedServiceAdvisor createAdvisor()

Create advisor and return the IManagedServiceAdvisor result.

Returns:

Results of the create advisor (IManagedServiceFactoryAdvisor) value.

createImportedServiceFilters

public void createImportedServiceFilters(java.lang.String pid,
                                         java.util.Dictionary oldProperties,
                                         java.util.Dictionary properties,
                                         IBundleActivationManager manager)

Create imported service filters with the specified pid, old properties, properties and manager parameters.

Parameters:

pid - The PID (String) parameter.

oldProperties - The old properties (Dictionary) parameter.

properties - The properties (Dictionary) parameter.

manager - The manager (IBundleActivationManager) parameter.

createProperties

public java.util.Hashtable createProperties()

Create the properties.

Returns:

Results of the create properties (Hashtable).

See Also:

updateProperties(Dictionary,Dictionary), updateProperties(Dictionary,Map)

getExportedServiceNames

public abstract java.lang.String[] getExportedServiceNames(java.lang.String pid,
                                                           java.util.Dictionary oldProperties,
                                                           java.util.Dictionary properties,
                                                           IBundleActivationManager manager)

Gets the service names (String[]) value.

Parameters:

pid - The PID (String) parameter.

oldProperties - The old properties (Dictionary) parameter.

properties - The properties (Dictionary) parameter.

manager - The manager (IBundleActivationManager) parameter.

Returns:

The service names (String[]) value. The manager (IBundleActivationManager) parameter.

getImportedServiceNames

protected java.lang.String[] getImportedServiceNames()

Gets the imported service names (String[]) value.

Returns:

The imported service names (String[]) value.

See Also:

getImportedServiceNames(String,Dictionary,Dictionary,IBundleActivationManager), getOptionalImportedServiceNames(), getOptionalImportedServiceNames(String,Dictionary,Dictionary,IBundleActivationManager)

getImportedServiceNames

public java.lang.String[] getImportedServiceNames(java.lang.String pid,
                                                  java.util.Dictionary arg1,
                                                  java.util.Dictionary arg2,
                                                  IBundleActivationManager manager)

Get imported service names with the specified pid, arg1, arg2 and manager parameters and return the String[] result.

Parameters:

pid - The PID (String) parameter.

arg1 - The arg1 (Dictionary) parameter.

arg2 - The arg2 (Dictionary) parameter.

manager - The manager (IBundleActivationManager) parameter.

Returns:

Results of the get imported service names (String[]) value.

See Also:

getImportedServiceNames(), getOptionalImportedServiceNames(), getOptionalImportedServiceNames(String,Dictionary,Dictionary,IBundleActivationManager)

getInterestServiceName

public java.lang.String getInterestServiceName()

Gets the interest service name (String) value.

Returns:

The interest service name (String) value.

getOptionalImportedServiceNames

protected java.lang.String[] getOptionalImportedServiceNames()

Gets the optional imported service names (String[]) value.

Returns:

The optional imported service names (String[]) value.

See Also:

getOptionalImportedServiceNames(String,Dictionary,Dictionary,IBundleActivationManager)

getOptionalImportedServiceNames

public java.lang.String[] getOptionalImportedServiceNames(java.lang.String pid,
                                                          java.util.Dictionary arg1,
                                                          java.util.Dictionary arg2,
                                                          IBundleActivationManager arg3)

Get optional imported service names with the specified pid, arg1, arg2 and arg3 parameters and return the String[] result.

Parameters:

pid - The PID (String) parameter.

arg1 - The arg1 (Dictionary) parameter.

arg2 - The arg2 (Dictionary) parameter.

arg3 - The arg3 (IBundleActivationManager) parameter.

Returns:

Results of the get optional imported service names (String[]) value.

See Also:

getOptionalImportedServiceNames()

handleAcquiredOptionalImportedService

public void handleAcquiredOptionalImportedService(java.lang.String pid,
                                                  java.lang.Object arg1,
                                                  java.lang.String arg2,
                                                  java.lang.Object arg3,
                                                  IBundleActivationManager arg4)

Handle acquired optional imported service with the specified pid, arg1, arg2, arg3 and arg4 parameters.

Parameters:

pid - The PID (String) parameter.

arg1 - The arg1 (Object) parameter.

arg2 - The arg2 (String) parameter.

arg3 - The arg3 (Object) parameter.

arg4 - The arg4 (IBundleActivationManager) parameter.

See Also:

handleAcquiredOptionalImportedService(String,String,Object)

handleAcquiredOptionalImportedService

protected void handleAcquiredOptionalImportedService(java.lang.String pid,
                                                     java.lang.String serviceName,
                                                     java.lang.Object service)

Handle acquired optional imported service with the specified service name and service parameters.

Parameters:

pid - The PID (String) parameter.

serviceName - The service name (String) parameter.

service - The service (Object) parameter.

See Also:

handleAcquiredOptionalImportedService(String,Object,String,Object,IBundleActivationManager)

handleReleasedOptionalImportedService

public void handleReleasedOptionalImportedService(java.lang.String pid,
                                                  java.lang.Object arg1,
                                                  java.lang.String arg2,
                                                  java.lang.Object arg3,
                                                  IBundleActivationManager arg4)

Handle released optional imported service with the specified pid, arg1, arg2, arg3 and arg4 parameters.

Parameters:

pid - The PID (String) parameter.

arg1 - The arg1 (Object) parameter.

arg2 - The arg2 (String) parameter.

arg3 - The arg3 (Object) parameter.

arg4 - The arg4 (IBundleActivationManager) parameter.

See Also:

handleReleasedOptionalImportedService(String,String,Object)

handleReleasedOptionalImportedService

protected void handleReleasedOptionalImportedService(java.lang.String pid,
                                                     java.lang.String serviceName,
                                                     java.lang.Object service)

Handle released optional imported service with the specified service name and service parameters.

Parameters:

pid - The PID (String) parameter.

serviceName - The service name (String) parameter.

service - The service (Object) parameter.

See Also:

handleReleasedOptionalImportedService(String,Object,String,Object,IBundleActivationManager)

updateProperties

public void updateProperties(java.util.Dictionary table,
                             java.util.Dictionary from)

Update properties with the specified table and from parameters.

Parameters:

table - The table (Dictionary) parameter.

from - The from (Dictionary) parameter.

See Also:

createProperties(), updateProperties(Dictionary,Map)

updateProperties

public void updateProperties(java.util.Dictionary table,
                             java.util.Map from)

Update properties with the specified table and from parameters.

Parameters:

table - The table (Dictionary) parameter.

from - The from (Map) parameter.

See Also:

createProperties(), updateProperties(Dictionary,Dictionary)

validateConfiguration

public void validateConfiguration(java.lang.String pid,
                                  java.util.Dictionary properties)
                           throws org.osgi.service.cm.ConfigurationException

Validate configuration with the specified pid and properties parameters.

Parameters:

pid - The PID (String) parameter.

properties - The properties (Dictionary) parameter.

Throws:

org.osgi.service.cm.ConfigurationException - Configuration Exception.