|
Service Activator Toolkit
Version 1.1.0 (20081206) |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IManagedServiceAdvisor
The IManagedServiceAdvisor
interface defines the API for an
object that knows how to create, destroy and update an object for a
ManagedService
.
Method Summary | |
---|---|
Object |
create(String pid,
Dictionary properties,
IBundleActivationManager manager)
Create and return an object for the configuration with the specified persistent ID using the specified properties. |
void |
createImportedServiceFilters(String pid,
Dictionary oldProperties,
Dictionary properties,
IBundleActivationManager manager)
Create the imported service filters for the configuration with the specified persistent ID and properties. |
void |
destroy(String pid,
Object object,
Dictionary properties,
IBundleActivationManager manager)
Destroy the specified object with the specified persistent ID. |
String[] |
getImportedServiceNames(String pid,
Dictionary oldProperties,
Dictionary properties,
IBundleActivationManager manager)
Get the imported service names for the configuration with the specified persistent ID. |
String[] |
getOptionalImportedServiceNames(String pid,
Dictionary oldProperties,
Dictionary properties,
IBundleActivationManager manager)
Get the optional imported service names for the configuration with the specified persistent ID. |
void |
handleAcquiredOptionalImportedService(String pid,
Object object,
String importedServiceName,
Object importedService,
IBundleActivationManager manager)
This method is called when an optional imported service has been acquired. |
void |
handleReleasedOptionalImportedService(String pid,
Object object,
String importedServiceName,
Object importedService,
IBundleActivationManager manager)
When all imported services are not required, this method is called when an imported service has been released. |
Object |
update(String pid,
Object object,
Dictionary oldProperties,
Dictionary properties,
IBundleActivationManager manager)
Update and return an object for the configuration with the specified persistent ID using the specified properties. |
void |
validateConfiguration(String pid,
Dictionary properties)
Validate the configuration, throwing a ConfigurationException if the configuration is deemed to be invalid. |
Method Detail |
---|
Object create(String pid, Dictionary properties, IBundleActivationManager manager)
pid
- The persistent id for the configuration.properties
- The properties for the configuration.manager
- The configurations's IBundleActivationManager
.
null
.void createImportedServiceFilters(String pid, Dictionary oldProperties, Dictionary properties, IBundleActivationManager manager)
pid
- The persistent id for the configuration.oldProperties
- The old properties for the configuration.properties
- The properties for the configuration.manager
- The configurations's IBundleActivationManager
.void destroy(String pid, Object object, Dictionary properties, IBundleActivationManager manager)
pid
- The persistent id for the configuration.object
- The object to destroy.properties
- The properties for the configuration.manager
- The configurations's IBundleActivationManager
.String[] getImportedServiceNames(String pid, Dictionary oldProperties, Dictionary properties, IBundleActivationManager manager)
pid
- The persistent id for the configuration.oldProperties
- The old configuration properties.properties
- The new configuration propertiesmanager
- The configuration's
IBundleActivationManager
.
String[] getOptionalImportedServiceNames(String pid, Dictionary oldProperties, Dictionary properties, IBundleActivationManager manager)
pid
- The persistent id for the configuration.oldProperties
- The old configuration properties.properties
- The new configuration propertiesmanager
- The configuration's
IBundleActivationManager
.
void handleAcquiredOptionalImportedService(String pid, Object object, String importedServiceName, Object importedService, IBundleActivationManager manager)
pid
- The persistent id for the configuration.object
- The configured object for the specified
persistent ID.importedServiceName
- The fully-qualified name of the optional
imported service.importedService
- The acquired optional imported service.manager
- The configuration's
IBundleActivationManager
.void handleReleasedOptionalImportedService(String pid, Object object, String importedServiceName, Object importedService, IBundleActivationManager manager)
pid
- The persistent id for the configuration.object
- The object for the specified persistent ID.importedServiceName
- The fully-qualified name of the optional
imported service.importedService
- The released optional imported service.manager
- The configurations's
IBundleActivationManager
.Object update(String pid, Object object, Dictionary oldProperties, Dictionary properties, IBundleActivationManager manager)
pid
- The persistent id for the configuration.object
- The object for the specified persistent ID.oldProperties
- The old properties for the object.properties
- The properties for the object.manager
- The configurations's IBundleActivationManager
.
null
.void validateConfiguration(String pid, Dictionary properties) throws ConfigurationException
pid
- The persistent id for the configuration.properties
- The properties for the configuration.
ConfigurationException
|
Service Activator Toolkit
Version 1.1.0 (20081206) |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 2001, 2008 IBM Corporation and others. All Rights Reserved.