org.eclipse.soda.dk.connection.factory
Class ConnectionFactory

java.lang.Object
  ManagedServiceFactoryBundleActivator
      org.eclipse.soda.dk.connection.factory.ConnectionFactory

All Implemented Interfaces:

org.osgi.service.cm.ManagedServiceFactory

Direct Known Subclasses:

FileConnectionFactory, RandomAccessFileConnectionFactory, SerialConnectionFactory, TcpipConnectionFactory, UrlConnectionFactory

public abstract class ConnectionFactory
extends ManagedServiceFactoryBundleActivator
implements org.osgi.service.cm.ManagedServiceFactory

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

Version:

1.0.0

Field Summary

static java.lang.String	METATYPE_SERVICE Define the metatype service (String) constant.
static java.lang.String[]	OPTIONAL_SERVICE Define the optional service (String[]) constant.

Constructor Summary

ConnectionFactory()

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.
protected IManagedServiceFactoryAdvisor	createAdvisor()
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 ConnectionService	createService(java.util.Dictionary properties) Create service with the specified properties 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.
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.
java.lang.String[]	getImportedServiceNames(java.lang.String arg0, java.util.Dictionary arg1, java.util.Dictionary arg2, IBundleActivationManager manager) Get imported service names with the specified arg0, arg1, arg2 and manager parameters and return the String[] result.
protected java.lang.String[]	getOptionalImportedServiceNames() Gets the optional imported service names (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.
protected void	handleAcquiredOptionalImportedService(java.lang.String serviceName, java.lang.Object service) Handle acquired optional imported service with the specified service name and service parameters.
void	handleAcquiredOptionalImportedService(java.lang.String arg0, java.lang.Object arg1, java.lang.String arg2, java.lang.Object arg3, IBundleActivationManager arg4) Handle acquired optional imported service with the specified arg0, arg1, arg2, arg3 and arg4 parameters.
protected void	handleReleasedOptionalImportedService(java.lang.String serviceName, java.lang.Object service) Handle released optional imported service with the specified service name and service parameters.
void	handleReleasedOptionalImportedService(java.lang.String arg0, java.lang.Object arg1, java.lang.String arg2, java.lang.Object arg3, IBundleActivationManager arg4) Handle released optional imported service with the specified arg0, arg1, arg2, arg3 and arg4 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.
void	updateProperties(java.util.Dictionary table, java.util.Dictionary 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.ManagedServiceFactory

deleted, getName, updated

Field Detail

METATYPE_SERVICE

public static final java.lang.String METATYPE_SERVICE

Define the metatype service (String) constant.

OPTIONAL_SERVICE

public static final java.lang.String[] OPTIONAL_SERVICE

Define the optional service (String[]) constant.

Constructor Detail

ConnectionFactory

public ConnectionFactory()

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. The pid (String) parameter. The properties (Dictionary) parameter. The manager (IBundleActivationManager) parameter.

Parameters:

pid - The pid (String) parameter.

properties - The properties (Dictionary) parameter.

manager - The manager (IBundleActivationManager) parameter.

Returns:

Results of the create (Object) value.

createAdvisor

protected IManagedServiceFactoryAdvisor createAdvisor()

Returns:

Results of the create advisor (IManagedServiceFactoryAdvisor) value.

See Also:

org.eclipse.soda.sat.core.framework.ManagedServiceFactoryBundleActivator#createAdvisor()

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. The pid (String) parameter. The old properties (Dictionary) parameter. The properties (Dictionary) parameter. The manager (IBundleActivationManager) parameter.

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) value.

See Also:

updateProperties(Dictionary,Dictionary)

createService

public abstract ConnectionService createService(java.util.Dictionary properties)

Create service with the specified properties parameter and return the Object result. The properties (Dictionary) parameter.

Parameters:

properties - The properties (Dictionary) parameter.

Returns:

Results of the create service (Object) value.

See Also:

#handleAcquiredImportedService(String,Object,Object,IBundleActivationManager), handleAcquiredOptionalImportedService(String,Object,String,Object,IBundleActivationManager), handleAcquiredOptionalImportedService(String,Object), #handleReleasedImportedService(String,Object,Object,IBundleActivationManager), handleReleasedOptionalImportedService(String,Object,String,Object,IBundleActivationManager), handleReleasedOptionalImportedService(String,Object)

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. The pid (String) parameter. The object(Object) parameter. The properties (Dictionary) parameter. The manager (IBundleActivationManager) parameter.

Parameters:

pid - The pid (String) parameter.

object - The object (Object) parameter.

properties - The properties (Dictionary) parameter.

manager - The manager (IBundleActivationManager) parameter.

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

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

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

Get imported service names with the specified arg0, arg1, arg2 and manager parameters and return the String[] result. The arg0 (String) parameter. The arg1 (Dictionary) parameter. The arg2 (Dictionary) parameter. The manager (IBundleActivationManager) parameter.

Parameters:

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

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

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. The arg0 (String) parameter. The arg1 (Dictionary) parameter. The arg2 (Dictionary) parameter. The arg3 (IBundleActivationManager) parameter.

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:

getOptionalImportedServiceNames()

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)

getServiceName

public java.lang.String getServiceName()

Return the service name.

Returns:

Results of the get service name (String) value.

handleAcquiredOptionalImportedService

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

Handle acquired optional imported service with the specified arg0, arg1, arg2, arg3 and arg4 parameters. The arg0 (String) parameter. The arg1 (Object) parameter. The arg2 (String) parameter. The arg3 (Object) parameter. The arg4 (IBundleActivationManager) parameter.

Parameters:

arg0 - The arg0 (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,Object)

handleAcquiredOptionalImportedService

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

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

Parameters:

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 arg0,
                                                  java.lang.Object arg1,
                                                  java.lang.String arg2,
                                                  java.lang.Object arg3,
                                                  IBundleActivationManager arg4)

Handle released optional imported service with the specified arg0, arg1, arg2, arg3 and arg4 parameters. The arg0 (String) parameter. The arg1 (Object) parameter. The arg2 (String) parameter. The arg3 (Object) parameter. The arg4 (IBundleActivationManager) parameter.

Parameters:

arg0 - The arg0 (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,Object)

handleReleasedOptionalImportedService

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

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

Parameters:

serviceName - The service name (String) parameter.

service - The service (Object) parameter.

See Also:

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

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. The pid (String) parameter. The object(Object) parameter. The old properties (Dictionary) parameter. The properties (Dictionary) parameter. The manager (IBundleActivationManager) parameter.

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.

updateProperties

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

Update properties with the specified table and from parameters. The table (Dictionary) parameter. The from (Dictionary) parameter.

Parameters:

table - The table (Dictionary) parameter.

from - The from (Dictionary) parameter.

See Also:

createProperties()

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.