public interface IProvisioningAgent
Services are registered with an agent either directly, via the registerService(String, Object)
method, or indirectly by registering an IAgentServiceFactory
in the OSGi
service registry.
Modifier and Type | Field and Description |
---|---|
static String |
INSTALLER_AGENT |
static String |
INSTALLER_PROFILEID |
static String |
SERVICE_CURRENT
Service property identifying whether an agent is the default agent.
|
static String |
SERVICE_NAME
Service name constant for the agent service.
|
static String |
SHARED_BASE_AGENT
When running in "shared mode", this allows to retrieve from the IProvisioningAgent the agent representing what is in the shared location aka the base
|
static String |
SHARED_CURRENT_AGENT
When running in "shared mode", this allows to retrieve from the IProvisioningAgent identified by
SHARED_BASE_AGENT the current agent |
Modifier and Type | Method and Description |
---|---|
Object |
getService(String serviceName)
Returns the service with the given service name, or
null
if no such service is available in this agent. |
void |
registerService(String serviceName,
Object service)
Registers a service with this provisioning agent.
|
void |
stop()
Stops the provisioning agent.
|
void |
unregisterService(String serviceName,
Object service)
Unregisters a service that has previously been registered with this
agent via
registerService(String, Object) . |
static final String SERVICE_NAME
IProvisioningAgentProvider
service must be used.static final String INSTALLER_AGENT
static final String INSTALLER_PROFILEID
static final String SHARED_BASE_AGENT
static final String SHARED_CURRENT_AGENT
SHARED_BASE_AGENT
the current agentstatic final String SERVICE_CURRENT
This property may be used by clients wishing to obtain or track the
provisioning agent for the currently running system. When the value of
this property is "true"
then the corresponding service is
the agent for the currently running system. If the property is undefined or
has any other value, then the service is not the agent for the currently running system.
Object getService(String serviceName)
null
if no such service is available in this agent.IllegalStateException
- if this agent has been stoppedvoid registerService(String serviceName, Object service)
serviceName
- The name of the service to registerservice
- The service implementationIllegalStateException
- if this agent has been stoppedvoid stop()
An agent should only be stopped by the client who first created the agent
by invoking IProvisioningAgentProvider.createAgent(java.net.URI)
.
void unregisterService(String serviceName, Object service)
registerService(String, Object)
. This method has
no effect if no such service is registered with this agent.serviceName
- The name of the service to unregisterservice
- The service implementation to unregister.
Copyright (c) 2000, 2014 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.