org.apache.felix.bundlerepository
Interface Resolver

All Known Implementing Classes:
ResolverImpl

public interface Resolver


Field Summary
static int DO_NOT_PREFER_LOCAL
           
static int NO_LOCAL_RESOURCES
           
static int NO_OPTIONAL_RESOURCES
           
static int NO_SYSTEM_BUNDLE
           
static int START
           
 
Method Summary
 void add(Requirement requirement)
          Add the following requirement to the resolution The current resolution will be lost after adding a requirement.
 void add(Resource resource)
          Add the following resource to the resolution.
 void addGlobalCapability(Capability capability)
          Add a global capability.
 void deploy(int flags)
           
 Requirement[] getAddedRequirements()
          Returns the list of requirements that have been added to the resolution
 Resource[] getAddedResources()
          Returns the list of resources that have been added to the resolution
 Capability[] getGlobalCapabilities()
          Returns the list of global capabilities
 Resource[] getOptionalResources()
          List of optional resources that may be installed
 Reason[] getReason(Resource resource)
          List of reasons why a resource has been included either as a mandatory or optional resource during the resolution.
 Resource[] getRequiredResources()
          List of mandatory resources that need to be installed
 Reason[] getUnsatisfiedRequirements()
          List of requirements that could not be satisfied during the resolution
 boolean resolve()
          Start the resolution process and return whether the constraints have been successfully met or not.
 boolean resolve(int flags)
          Start the resolution process with the following flags.
 

Field Detail

NO_OPTIONAL_RESOURCES

static final int NO_OPTIONAL_RESOURCES
See Also:
Constant Field Values

NO_LOCAL_RESOURCES

static final int NO_LOCAL_RESOURCES
See Also:
Constant Field Values

NO_SYSTEM_BUNDLE

static final int NO_SYSTEM_BUNDLE
See Also:
Constant Field Values

DO_NOT_PREFER_LOCAL

static final int DO_NOT_PREFER_LOCAL
See Also:
Constant Field Values

START

static final int START
See Also:
Constant Field Values
Method Detail

add

void add(Resource resource)
Add the following resource to the resolution. The resource will be part of the output and all its requirements will be satisfied. It has the same effect has adding a requirement that will match this resource by symbolicname and version. The current resolution will be lost after adding a resource.

Parameters:
resource - the resource to add

getAddedResources

Resource[] getAddedResources()
Returns the list of resources that have been added to the resolution

Returns:

add

void add(Requirement requirement)
Add the following requirement to the resolution The current resolution will be lost after adding a requirement.

Parameters:
requirement - the requirement to add

getAddedRequirements

Requirement[] getAddedRequirements()
Returns the list of requirements that have been added to the resolution

Returns:

addGlobalCapability

void addGlobalCapability(Capability capability)
Add a global capability. A global capability is one capability provided by the environment but not reflected in local resources.

Parameters:
capability - the new global capability

getGlobalCapabilities

Capability[] getGlobalCapabilities()
Returns the list of global capabilities

Returns:

resolve

boolean resolve()
                throws InterruptedResolutionException
Start the resolution process and return whether the constraints have been successfully met or not. The resolution can be interrupted by a call to Thread.interrupt() at any time. The result will be to stop the resolver and throw an InterruptedException.

Returns:
true if the resolution has succeeded else false
Throws:
InterruptedResolutionException - if the resolution has been interrupted

resolve

boolean resolve(int flags)
                throws InterruptedResolutionException
Start the resolution process with the following flags.

Parameters:
flags - resolution flags
Returns:
true if the resolution has succeeded else false
Throws:
InterruptedResolutionException - if the resolution has been interrupted

getRequiredResources

Resource[] getRequiredResources()
List of mandatory resources that need to be installed

Returns:

getOptionalResources

Resource[] getOptionalResources()
List of optional resources that may be installed

Returns:

getReason

Reason[] getReason(Resource resource)
List of reasons why a resource has been included either as a mandatory or optional resource during the resolution.

Parameters:
resource -
Returns:
an array of Reason

getUnsatisfiedRequirements

Reason[] getUnsatisfiedRequirements()
List of requirements that could not be satisfied during the resolution

Returns:

deploy

void deploy(int flags)


Copyright © 2011. All Rights Reserved.