2008-02-07 1.1.0

org.eclipse.soda.dk.agent.factory
Class AgentFactory

java.lang.Object
  extended by org.eclipse.soda.sat.core.framework.BaseBundleActivator
      extended by org.eclipse.soda.sat.core.framework.ManagedServiceFactoryBundleActivator
          extended by org.eclipse.soda.dk.core.factory.CoreFactory
              extended by org.eclipse.soda.dk.agent.factory.AgentFactory
All Implemented Interfaces:
org.eclipse.soda.sat.core.framework.interfaces.IManagedServiceFactoryAdvisor, org.osgi.framework.BundleActivator, org.osgi.service.cm.ManagedServiceFactory

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

Version:
1.1.0

Field Summary
static java.lang.String[] OPTIONAL_SERVICE
          Define the optional service (String[]) constant.
static java.lang.String[] OPTIONAL_SERVICES
          Define the optional services (String[]) constant.
 
Fields inherited from class org.eclipse.soda.dk.core.factory.CoreFactory
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
AgentFactory()
           
 
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.
 AgentService createService(DeviceService device)
           
 AgentService createService(org.eclipse.soda.sat.core.framework.interfaces.IBundleActivationManager manager)
          Create service with the specified manager parameter and return the AgentService result.
 void destroy(java.lang.String pid, java.lang.Object object, java.util.Dictionary properties, org.eclipse.soda.sat.core.framework.interfaces.IBundleActivationManager manager)
           
 java.lang.String getDeviceServiceName()
          Method getDeviceServiceName.
 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 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.
 java.lang.String getServiceName()
          Return the service name.
 java.lang.String[] getServiceNames()
          Gets the service names (String[]) value.
 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.
 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
createAdvisor, createImportedServiceFilters, createProperties, getExportedServiceNames, getIds, getImportedServiceNames, getImportedServiceNames, handleAcquiredOptionalImportedService, handleReleasedOptionalImportedService, setIds, updateProperties, validateConfiguration
 
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, 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 services (String[]) constant.


OPTIONAL_SERVICE

public static final java.lang.String[] OPTIONAL_SERVICE
Define the optional service (String[]) constant.

Constructor Detail

AgentFactory

public AgentFactory()
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.

createService

public AgentService createService(org.eclipse.soda.sat.core.framework.interfaces.IBundleActivationManager manager)
Create service with the specified manager parameter and return the AgentService result.

Parameters:
manager - The manager (IBundleActivationManager) parameter.
Returns:
Results of the create service (AgentService) value.
See Also:
createService(DeviceService), handleAcquiredOptionalImportedService(String,Object,String,Object,IBundleActivationManager), handleReleasedOptionalImportedService(String,Object,String,Object,IBundleActivationManager)

createService

public AgentService createService(DeviceService device)
Parameters:
device - The device (DeviceService) parameter.
Returns:
Results of the create service (Object) value.
See Also:
createService(IBundleActivationManager), 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)
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.

getDeviceServiceName

public java.lang.String getDeviceServiceName()
Method getDeviceServiceName.

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

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.
See Also:
getOptionalImportedServiceNames()

getOptionalImportedServiceNames

protected java.lang.String[] getOptionalImportedServiceNames()
Gets the optional imported service names (String[]) value.

Overrides:
getOptionalImportedServiceNames in class org.eclipse.soda.dk.core.factory.CoreFactory
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.
See Also:
getDeviceServiceName(), getInterestServiceName()

getServiceNames

public java.lang.String[] getServiceNames()
Gets the service names (String[]) value.

Returns:
The service names (String[]) value.
See Also:
getOptionalImportedServiceNames(String,Dictionary,Dictionary,IBundleActivationManager), getOptionalImportedServiceNames()

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.

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.

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.

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.

2008-02-07 1.1.0

Copyright (c) 1999, 2008 IBM and others. See license in Legal section. OSGi Framework Version 3.3.1.R33x_v20070828