Package org.eclipse.equinox.p2.core
Interface IProvisioningAgentProvider
-
public interface IProvisioningAgentProviderAn OSGi service that is used to create or obtain instances of anIProvisioningAgent.- Since:
- 2.0
-
-
Field Summary
Fields Modifier and Type Field Description static StringSERVICE_NAMEService name constant for the agent provider service.
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description IProvisioningAgentcreateAgent(URI location)Creates a provisioning agent who metadata is stored at the given location.
-
-
-
Field Detail
-
SERVICE_NAME
static final String SERVICE_NAME
Service name constant for the agent provider service.
-
-
Method Detail
-
createAgent
IProvisioningAgent createAgent(URI location) throws ProvisionException
Creates a provisioning agent who metadata is stored at the given location. If anulllocation is provided, the provisioning agent for the currently running system is returned, if available. If anulllocation is provided and the currently running system has not been provisioned by any known agent,nullis returned.Callers of this method are responsible for stopping the agent when they are finished using it by invoking
IProvisioningAgent.stop().- Parameters:
location- The location where the agent metadata is stored- Returns:
- A provisioning agent, or
nullif anullparameter is provided and there is no currently running agent. - Throws:
ProvisionException- If agent creation failed. Reasons include:- The location is not writeable.
- See Also:
IProvisioningAgent.stop()
-
-