org.eclipse.soda.dk.device.factory
Class DeviceFactory

java.lang.Object
  ManagedServiceFactoryBundleActivator
      org.eclipse.soda.dk.core.factory.CoreFactory
          org.eclipse.soda.dk.device.factory.DeviceFactory

All Implemented Interfaces:

org.osgi.service.cm.ManagedServiceFactory

public abstract class DeviceFactory
extends CoreFactory
implements org.osgi.service.cm.ManagedServiceFactory

The TransportBundle 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[]

OPTIONAL_SERVICES Define the optional services (String[]) constant.

Fields inherited from class org.eclipse.soda.dk.core.factory.CoreFactory

CHANGES_MAJOR, CHANGES_MINOR, CHANGES_NONE, CONFIGURATION_ADMIN_SERVICE, ID_KEY, ID_KEY_FILTER, ids, IMPORTED_SERVICES, METATYPE_SERVICE

Constructor Summary

DeviceFactory()

Method Summary

java.lang.Object	create(java.lang.String pid, java.util.Dictionary properties, IBundleActivationManager manager) Create with the specified pid, properties and manager parameters and return the Object result.
abstract DeviceService	createService(TransportService transport) Create service with the specified transport parameter and return the Object result.
void	destroy(java.lang.String pid, java.lang.Object object, java.util.Dictionary properties, IBundleActivationManager manager) Destroy with the specified pid, object, properties and manager parameters.
java.lang.String	getInterestServiceName() Gets the interest service name (String) value.
java.lang.String[]	getOptionalImportedServiceNames(java.lang.String arg0, java.util.Dictionary arg1, java.util.Dictionary arg2, IBundleActivationManager arg3) Get optional imported service names with the specified arg0, arg1, arg2 and arg3 parameters and return the String[] result.
java.lang.String	getServiceName() Return the service name.
java.lang.String	getTransportServiceName() Method getTransportServiceName.
void	handleAcquiredOptionalImportedService(java.lang.String pid, java.lang.Object object, java.lang.String importedServiceName, java.lang.Object importedService, IBundleActivationManager manager) Handle acquired optional imported service with the specified pid, object, imported service name, imported service and manager parameters.
void	handleReleasedOptionalImportedService(java.lang.String pid, java.lang.Object object, java.lang.String importedServiceName, java.lang.Object importedService, IBundleActivationManager manager) Handle released optional imported service with the specified pid, object, imported service name, imported service and manager parameters.
java.lang.Object	update(java.lang.String pid, java.lang.Object object, java.util.Dictionary oldProperties, java.util.Dictionary properties, IBundleActivationManager manager) Update with the specified pid, object, old properties, properties and manager parameters and return the Object result.

Methods inherited from class org.eclipse.soda.dk.core.factory.CoreFactory

compare, createAdvisor, createImportedServiceFilters, createProperties, getExportedServiceNames, getIds, getImportedServiceNames, getImportedServiceNames, getMinorProperties, getOptionalImportedServiceNames, handleAcquiredOptionalImportedService, handleReleasedOptionalImportedService, setIds, updateProperties, updateProperties, validateConfiguration, validateConfigurationIds

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.ManagedServiceFactory

deleted, getName, updated

Field Detail

OPTIONAL_SERVICES

public static final java.lang.String[] OPTIONAL_SERVICES

Define the optional services (String[]) constant.

Constructor Detail

DeviceFactory

public DeviceFactory()

Method Detail

create

public java.lang.Object create(java.lang.String pid,
                               java.util.Dictionary properties,
                               IBundleActivationManager manager)

Create with the specified pid, properties and manager parameters and return the Object result.

Parameters:

pid - The PID (String) parameter.

properties - The properties (Dictionary) parameter.

manager - The manager (IBundleActivationManager) parameter.

Returns:

Results of the create (Object) value.

createService

public abstract DeviceService createService(TransportService transport)

Create service with the specified transport parameter and return the Object result.

Parameters:

transport - The transport (TransportService) parameter.

Returns:

Results of the create service (Object) value.

See Also:

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

destroy

public void destroy(java.lang.String pid,
                    java.lang.Object object,
                    java.util.Dictionary properties,
                    IBundleActivationManager manager)

Destroy with the specified pid, object, properties and manager parameters.

Overrides:

destroy in class CoreFactory

Parameters:

pid - The PID (String) parameter.

object - The object (Object) parameter.

properties - The properties (Dictionary) parameter.

manager - The manager (IBundleActivationManager) parameter.

getInterestServiceName

public java.lang.String getInterestServiceName()

Gets the interest service name (String) value.

Overrides:

getInterestServiceName in class CoreFactory

Returns:

The interest service name (String) value.

getOptionalImportedServiceNames

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

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

Overrides:

getOptionalImportedServiceNames in class CoreFactory

Parameters:

arg0 - The arg0 (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:

CoreFactory.getOptionalImportedServiceNames()

getServiceName

public java.lang.String getServiceName()

Return the service name.

Returns:

Results of the get service name (String) value.

See Also:

getInterestServiceName(), getTransportServiceName()

getTransportServiceName

public java.lang.String getTransportServiceName()

Method getTransportServiceName.

Returns:

Results of the get transport service name (String) value.

handleAcquiredOptionalImportedService

public void handleAcquiredOptionalImportedService(java.lang.String pid,
                                                  java.lang.Object object,
                                                  java.lang.String importedServiceName,
                                                  java.lang.Object importedService,
                                                  IBundleActivationManager manager)

Handle acquired optional imported service with the specified pid, object, imported service name, imported service and manager parameters.

Overrides:

handleAcquiredOptionalImportedService in class CoreFactory

Parameters:

pid - The PID (String) parameter.

object - The object (Object) parameter.

importedServiceName - The imported service name (String) parameter.

importedService - The imported service (Object) parameter.

manager - The manager (IBundleActivationManager) parameter.

See Also:

CoreFactory.handleAcquiredOptionalImportedService(String,Object)

handleReleasedOptionalImportedService

public void handleReleasedOptionalImportedService(java.lang.String pid,
                                                  java.lang.Object object,
                                                  java.lang.String importedServiceName,
                                                  java.lang.Object importedService,
                                                  IBundleActivationManager manager)

Handle released optional imported service with the specified pid, object, imported service name, imported service and manager parameters.

Overrides:

handleReleasedOptionalImportedService in class CoreFactory

Parameters:

pid - The PID (String) parameter.

object - The object (Object) parameter.

importedServiceName - The imported service name (String) parameter.

importedService - The imported service (Object) parameter.

manager - The manager (IBundleActivationManager) parameter.

See Also:

CoreFactory.handleReleasedOptionalImportedService(String,Object)

update

public java.lang.Object update(java.lang.String pid,
                               java.lang.Object object,
                               java.util.Dictionary oldProperties,
                               java.util.Dictionary properties,
                               IBundleActivationManager manager)

Update with the specified pid, object, old properties, properties and manager parameters and return the Object result.

Parameters:

pid - The PID (String) parameter.

object - The object (Object) parameter.

oldProperties - The old properties (Dictionary) parameter.

properties - The properties (Dictionary) parameter.

manager - The manager (IBundleActivationManager) parameter.

Returns:

Results of the update (Object) value.