Package org.eclipse.equinox.p2.engine
Interface IEngine
public interface IEngine
The engine is a service that naively performs a set of requested changes to a provisioned
system. No attempt is made to determine whether the requested changes or the
resulting system are valid or consistent. It is assumed that the engine client has
crafted a valid provisioning plan for the engine to perform, typically by using a planner
service.
The engine operates by executing a series of installation phases. The client can customize the set of phases that are executed, or else the engine will execute a default set of phases. During each phase the changes described by the provisioning plan are performed against the profile being provisioned.
- Since:
- 2.0
- Restriction:
- This interface is not intended to be implemented by clients.
- Restriction:
- This interface is not intended to be extended by clients.
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
Service name constant for the engine service. -
Method Summary
Modifier and TypeMethodDescriptioncreatePlan
(IProfile profile, ProvisioningContext context) Creates a provisioning plan whose methods can be use to provide pre-validated changes.perform
(IProvisioningPlan plan, IProgressMonitor monitor) Executes a provisioning plan with a default phase set and context.perform
(IProvisioningPlan plan, IPhaseSet phaseSet, IProgressMonitor monitor) Executes a provisioning plan.
-
Field Details
-
SERVICE_NAME
Service name constant for the engine service.
-
-
Method Details
-
createPlan
Creates a provisioning plan whose methods can be use to provide pre-validated changes. This is an advanced method for clients that know they are creating changes that do not require validation by a planner. Most clients should instead obtain a validated plan from a planner.- Parameters:
profile
- The profile to operate againstcontext
- The provisioning context for the plan- Returns:
- A provisioning plan
-
perform
Executes a provisioning plan.- Parameters:
plan
- The plan describing the changes to be madephaseSet
- The phases to run, ornull
to run default phasesmonitor
- A progress monitor, ornull
if progress reporting is not required- Returns:
- The result of executing the plan
-
perform
Executes a provisioning plan with a default phase set and context.- Parameters:
plan
- The plan describing the changes to be mademonitor
- A progress monitor, ornull
if progress reporting is not required- Returns:
- The result of executing the plan
-