org.eclipse.soda.dk.transport.factory
Class TransportFactory

java.lang.Object
  org.eclipse.soda.sat.core.framework.BaseBundleActivator
      org.eclipse.soda.sat.core.framework.ManagedServiceFactoryBundleActivator
          org.eclipse.soda.dk.core.factory.CoreFactory
              org.eclipse.soda.dk.transport.factory.TransportFactory

All Implemented Interfaces:

org.eclipse.soda.sat.core.framework.interfaces.IManagedServiceFactoryAdvisor, org.osgi.framework.BundleActivator, org.osgi.service.cm.ManagedServiceFactory

Direct Known Subclasses:

MulticastTransportFactory, UdpTransportFactory

public abstract class TransportFactory
extends org.eclipse.soda.dk.core.factory.CoreFactory
implements org.osgi.service.cm.ManagedServiceFactory, org.eclipse.soda.sat.core.framework.interfaces.IManagedServiceFactoryAdvisor

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

Version:

1.1.0

Field Summary

static java.lang.String[]

OPTIONAL_SERVICES Define the optional service (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

Fields inherited from class org.eclipse.soda.sat.core.framework.ManagedServiceFactoryBundleActivator

CONFIGURATION_ADMIN_SERVICE_NAME, MANAGED_SERVICE_FACTORY_SERVICE_NAME, NUMBER_OF_CONFIGURATIONS_HINT

Fields inherited from class org.eclipse.soda.sat.core.framework.BaseBundleActivator

NO_SERVICES

Constructor Summary

TransportFactory()

Method Summary

java.lang.Object	create(java.lang.String pid, java.util.Dictionary properties, org.eclipse.soda.sat.core.framework.interfaces.IBundleActivationManager manager) Create with the specified pid, properties and manager parameters and return the Object result.
abstract TransportService	createService(ConnectionService connection) 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, org.eclipse.soda.sat.core.framework.interfaces.IBundleActivationManager manager) Destroy with the specified pid, object, properties and manager parameters.
java.lang.String[]	getExportedServiceNames(java.lang.String pid, java.util.Dictionary oldProperties, java.util.Dictionary properties, org.eclipse.soda.sat.core.framework.interfaces.IBundleActivationManager manager) Gets the service names (String[]) value.
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, org.eclipse.soda.sat.core.framework.interfaces.IBundleActivationManager arg3) Get optional imported service names with the specified arg0, arg1, arg2 and arg3 parameters and return the String[] result.
void	handleAcquiredOptionalImportedService(java.lang.String pid, java.lang.Object object, java.lang.String importedServiceName, java.lang.Object importedService, org.eclipse.soda.sat.core.framework.interfaces.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, org.eclipse.soda.sat.core.framework.interfaces.IBundleActivationManager manager) Handle released optional imported service with the specified pid, object, imported service name, imported service and manager parameters.
boolean	isFactoryConnection(java.util.Dictionary properties) Is factory connection with the specified properties parameter and return the boolean result.
java.lang.Object	update(java.lang.String pid, java.lang.Object object, java.util.Dictionary oldProperties, java.util.Dictionary properties, org.eclipse.soda.sat.core.framework.interfaces.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, getIds, getImportedServiceNames, getImportedServiceNames, getMinorProperties, getOptionalImportedServiceNames, handleAcquiredOptionalImportedService, handleReleasedOptionalImportedService, setIds, updateProperties, updateProperties, validateConfiguration, validateConfigurationIds

Methods inherited from class org.eclipse.soda.sat.core.framework.ManagedServiceFactoryBundleActivator

activate, collectImportedServiceNames, createDefaultPid, createPid, deactivate, deleted, getName, getNumberOfConfigurationsHint, getPid, isProxyService, updated

Methods inherited from class org.eclipse.soda.sat.core.framework.BaseBundleActivator

acquireImportedService, acquireImportedServices, acquireOptionalImportedServices, addExportedProxyService, addExportedProxyServices, addExportedService, addExportedServices, addImportedServiceFilter, addOptionalImportedServiceFilter, basicGetImportedServiceNames, basicGetOptionalImportedServiceNames, collectOptionalImportedServiceNames, getAsyncStartPriority, getBundle, getBundleActivationManager, getBundleContext, getBundleSymbolicName, getDataDirectory, getDataFile, getExportedService, getExportedServiceNamesFromManifest, getExportedServiceProperties, getExportedServiceProperties, getExportedServices, getExportedServices, getFilePropertiesInputStream, getFilePropertiesInputStream, getImportedService, getImportedServiceFilter, getImportedServiceNamesFromManifest, getImportedServiceProperty, getImportedServicePropertyKeys, getImportedServices, getOptionalImportedService, getOptionalImportedServiceFilter, getOptionalImportedServiceProperty, getOptionalImportedServicePropertyKeys, getOptionalImportedServices, getProperties, getPropertiesInputStream, getProperty, getResourcePropertiesInputStream, getResourcePropertiesInputStream, handleException, handleFailedToFindProperties, isStartAsync, isTransient, isUninstallable, releaseImportedService, releaseImportedServices, releaseOptionalImportedServices, removeExportedService, removeExportedService, removeExportedServices, removeImportedServiceFilter, removeOptionalImportedServiceFilter, restartFramework, setExportedServiceProperties, setExportedServiceProperties, shutdownFramework, start, start, stop, stop

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

Methods inherited from interface org.eclipse.soda.sat.core.framework.interfaces.IManagedServiceFactoryAdvisor

createImportedServiceFilters, getImportedServiceNames, validateConfiguration

Field Detail

OPTIONAL_SERVICES

public static final java.lang.String[] OPTIONAL_SERVICES

Define the optional service (String[]) constant.

Constructor Detail

TransportFactory

public TransportFactory()

Method Detail

create

public java.lang.Object create(java.lang.String pid,
                               java.util.Dictionary properties,
                               org.eclipse.soda.sat.core.framework.interfaces.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.

Specified by:

create in interface org.eclipse.soda.sat.core.framework.interfaces.IManagedServiceFactoryAdvisor

Parameters:

pid - The pid (String) parameter.

properties - The properties (Dictionary) parameter.

manager - The manager (IBundleActivationManager) parameter.

Returns:

Results of the create (Object) value. The pid (String) parameter. The properties (Dictionary) parameter. The manager (IBundleActivationManager) parameter.

createService

public abstract TransportService createService(ConnectionService connection)

Create service with the specified transport parameter and return the Object result. The transport (TransportService) parameter.

Parameters:

connection - The connection (ConnectionService) parameter.

Returns:

Results of the create service (Object) value. The connection (ConnectionService) parameter. The connection (ConnectionService) parameter.

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,
                    org.eclipse.soda.sat.core.framework.interfaces.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. The pid (String) parameter. The object (Object) parameter. The properties (Dictionary) parameter. The manager (IBundleActivationManager) parameter.

Specified by:

destroy in interface org.eclipse.soda.sat.core.framework.interfaces.IManagedServiceFactoryAdvisor

Overrides:

destroy in class org.eclipse.soda.dk.core.factory.CoreFactory

Parameters:

pid - The pid (String) parameter.

object - The object (Object) parameter.

properties - The properties (Dictionary) parameter.

manager - The manager (IBundleActivationManager) parameter.

getExportedServiceNames

public java.lang.String[] getExportedServiceNames(java.lang.String pid,
                                                  java.util.Dictionary oldProperties,
                                                  java.util.Dictionary properties,
                                                  org.eclipse.soda.sat.core.framework.interfaces.IBundleActivationManager manager)

Gets the service names (String[]) value.

Specified by:

getExportedServiceNames in class org.eclipse.soda.dk.core.factory.CoreFactory

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

getInterestServiceName

public java.lang.String getInterestServiceName()

Gets the interest service name (String) value.

Overrides:

getInterestServiceName in class org.eclipse.soda.dk.core.factory.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,
                                                          org.eclipse.soda.sat.core.framework.interfaces.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.

Specified by:

getOptionalImportedServiceNames in interface org.eclipse.soda.sat.core.framework.interfaces.IManagedServiceFactoryAdvisor

Overrides:

getOptionalImportedServiceNames in class org.eclipse.soda.dk.core.factory.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. The arg0 (String) parameter. The arg1 (Dictionary) parameter. The arg2 (Dictionary) parameter. The arg3 (IBundleActivationManager) parameter.

handleAcquiredOptionalImportedService

public void handleAcquiredOptionalImportedService(java.lang.String pid,
                                                  java.lang.Object object,
                                                  java.lang.String importedServiceName,
                                                  java.lang.Object importedService,
                                                  org.eclipse.soda.sat.core.framework.interfaces.IBundleActivationManager manager)

Handle acquired optional imported service with the specified pid, object, imported service name, imported service and manager parameters. The pid (String) parameter. The object (Object) parameter. The imported service name (String) parameter. The imported service (Object) parameter. The manager (IBundleActivationManager) parameter. The pid (String) parameter. The object (Object) parameter. The imported service name (String) parameter. The imported service (Object) parameter. The manager (IBundleActivationManager) parameter.

Specified by:

handleAcquiredOptionalImportedService in interface org.eclipse.soda.sat.core.framework.interfaces.IManagedServiceFactoryAdvisor

Overrides:

handleAcquiredOptionalImportedService in class org.eclipse.soda.dk.core.factory.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.

handleReleasedOptionalImportedService

public void handleReleasedOptionalImportedService(java.lang.String pid,
                                                  java.lang.Object object,
                                                  java.lang.String importedServiceName,
                                                  java.lang.Object importedService,
                                                  org.eclipse.soda.sat.core.framework.interfaces.IBundleActivationManager manager)

Handle released optional imported service with the specified pid, object, imported service name, imported service and manager parameters. The pid (String) parameter. The object (Object) parameter. The imported service name (String) parameter. The imported service (Object) parameter. The manager (IBundleActivationManager) parameter. The pid (String) parameter. The object (Object) parameter. The imported service name (String) parameter. The imported service (Object) parameter. The manager (IBundleActivationManager) parameter.

Specified by:

handleReleasedOptionalImportedService in interface org.eclipse.soda.sat.core.framework.interfaces.IManagedServiceFactoryAdvisor

Overrides:

handleReleasedOptionalImportedService in class org.eclipse.soda.dk.core.factory.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.

isFactoryConnection

public boolean isFactoryConnection(java.util.Dictionary properties)

Is factory connection with the specified properties parameter and return the boolean result. The properties (Dictionary) parameter.

Parameters:

properties - The properties (Dictionary) parameter.

Returns:

Results of the is factory connection (boolean) value. The properties (Dictionary) parameter.

update

public java.lang.Object update(java.lang.String pid,
                               java.lang.Object object,
                               java.util.Dictionary oldProperties,
                               java.util.Dictionary properties,
                               org.eclipse.soda.sat.core.framework.interfaces.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.

Specified by:

update in interface org.eclipse.soda.sat.core.framework.interfaces.IManagedServiceFactoryAdvisor

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