org.apache.felix.bundlerepository.impl

Class ResolverImpl

java.lang.Object

org.apache.felix.bundlerepository.impl.ResolverImpl

All Implemented Interfaces:

Resolver

public class ResolverImpl
extends java.lang.Object
implements Resolver

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Set<Requirement>	m_addedRequirementSet
private java.util.Set<Resource>	m_addedSet
private org.osgi.framework.BundleContext	m_context
private java.util.Set<Resource>	m_failedSet
private java.util.Set<Capability>	m_globalCapabilities
private org.apache.felix.utils.log.Logger	m_logger
private java.util.Set<Resource>	m_optionalSet
private java.util.Map<Resource,java.util.List<Reason>>	m_reasonMap
private Repository[]	m_repositories
private java.util.Set<Resource>	m_requiredSet
private int	m_resolutionFlags
private boolean	m_resolved
private java.util.Set<Resource>	m_resolveSet
private long	m_resolveTimeStamp
private java.util.Set<Reason>	m_unsatisfiedSet

Fields inherited from interface org.apache.felix.bundlerepository.Resolver

DO_NOT_PREFER_LOCAL, NO_LOCAL_RESOURCES, NO_OPTIONAL_RESOURCES, NO_SYSTEM_BUNDLE, START

Constructor Summary

Constructors

Constructor and Description
ResolverImpl(org.osgi.framework.BundleContext context, Repository[] repositories, org.apache.felix.utils.log.Logger logger)

Method Summary

Modifier and Type	Method and Description
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.
private void	checkInterrupt()
void	deploy(int flags)
private LocalResource[]	findLocalResources(java.lang.String symName) Returns all local resources with the given symbolic name.
private LocalResource	findUpdatableLocalResource(Resource resource)
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
private ResourceCapability	getBestCandidate(java.util.List<ResourceCapability> caps) Determines which resource is preferred to deliver the required capability.
static java.lang.String	getBundleName(org.osgi.framework.Bundle bundle)
Capability[]	getGlobalCapabilities() Returns the list of global capabilities
protected LocalResource[]	getLocalResources()
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.
private Resource[]	getRemoteResources()
Resource[]	getRequiredResources() List of mandatory resources that need to be installed
private Requirement[]	getResolvableRequirements(Resource resource, Resource[] resources)
private Resource[]	getResources()
Reason[]	getUnsatisfiedRequirements() List of requirements that could not be satisfied during the resolution
private boolean	isFragmentBundle(org.osgi.framework.Bundle bundle) Determines if the given bundle is a fragement bundle.
private boolean	isResourceUpdatable(Resource oldVersion, Resource newVersion, Resource[] resources)
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.
private boolean	resolve(Resource resource, Resource[] locals, Resource[] remotes, boolean optional)
private java.util.List<ResourceCapability>	searchResources(Requirement req, Resource[] resources) Searches for resources that do meet the given requirement
private Resource	searchResources(Requirement req, java.util.Set<Resource> resourceSet)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

m_context

private final org.osgi.framework.BundleContext m_context

m_logger

private final org.apache.felix.utils.log.Logger m_logger

m_repositories

private final Repository[] m_repositories

m_addedSet

private final java.util.Set<Resource> m_addedSet

m_addedRequirementSet

private final java.util.Set<Requirement> m_addedRequirementSet

m_globalCapabilities

private final java.util.Set<Capability> m_globalCapabilities

m_failedSet

private final java.util.Set<Resource> m_failedSet

m_resolveSet

private final java.util.Set<Resource> m_resolveSet

m_requiredSet

private final java.util.Set<Resource> m_requiredSet

m_optionalSet

private final java.util.Set<Resource> m_optionalSet

m_reasonMap

private final java.util.Map<Resource,java.util.List<Reason>> m_reasonMap

m_unsatisfiedSet

private final java.util.Set<Reason> m_unsatisfiedSet

m_resolved

private boolean m_resolved

m_resolveTimeStamp

private long m_resolveTimeStamp

m_resolutionFlags

private int m_resolutionFlags

Constructor Detail

ResolverImpl

public ResolverImpl(org.osgi.framework.BundleContext context,
                    Repository[] repositories,
                    org.apache.felix.utils.log.Logger logger)

Method Detail

add

public void add(Resource resource)

Description copied from interface: Resolver

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.

Specified by:

add in interface Resolver

Parameters:

resource - the resource to add

getAddedResources

public Resource[] getAddedResources()

Description copied from interface: Resolver

Returns the list of resources that have been added to the resolution

Specified by:

getAddedResources in interface Resolver

Returns:

add

public void add(Requirement requirement)

Description copied from interface: Resolver

Add the following requirement to the resolution The current resolution will be lost after adding a requirement.

Specified by:

add in interface Resolver

Parameters:

requirement - the requirement to add

getAddedRequirements

public Requirement[] getAddedRequirements()

Description copied from interface: Resolver

Returns the list of requirements that have been added to the resolution

Specified by:

getAddedRequirements in interface Resolver

Returns:

addGlobalCapability

public void addGlobalCapability(Capability capability)

Description copied from interface: Resolver

Add a global capability. A global capability is one capability provided by the environment but not reflected in local resources.

Specified by:

addGlobalCapability in interface Resolver

Parameters:

capability - the new global capability

getGlobalCapabilities

public Capability[] getGlobalCapabilities()

Description copied from interface: Resolver

Returns the list of global capabilities

Specified by:

getGlobalCapabilities in interface Resolver

Returns:

getRequiredResources

public Resource[] getRequiredResources()

Description copied from interface: Resolver

List of mandatory resources that need to be installed

Specified by:

getRequiredResources in interface Resolver

Returns:

getOptionalResources

public Resource[] getOptionalResources()

Description copied from interface: Resolver

List of optional resources that may be installed

Specified by:

getOptionalResources in interface Resolver

Returns:

getReason

public Reason[] getReason(Resource resource)

Description copied from interface: Resolver

List of reasons why a resource has been included either as a mandatory or optional resource during the resolution.

Specified by:

getReason in interface Resolver

Returns:

an array of Reason

getUnsatisfiedRequirements

public Reason[] getUnsatisfiedRequirements()

Description copied from interface: Resolver

List of requirements that could not be satisfied during the resolution

Specified by:

getUnsatisfiedRequirements in interface Resolver

Returns:

getLocalResources

protected LocalResource[] getLocalResources()

getRemoteResources

private Resource[] getRemoteResources()

getResources

private Resource[] getResources()

resolve

public boolean resolve()

Description copied from interface: Resolver

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.

Specified by:

resolve in interface Resolver

Returns:

true if the resolution has succeeded else false

resolve

public boolean resolve(int flags)

Description copied from interface: Resolver

Start the resolution process with the following flags.

Specified by:

resolve in interface Resolver

Parameters:

flags - resolution flags

Returns:

true if the resolution has succeeded else false

resolve

private boolean resolve(Resource resource,
                        Resource[] locals,
                        Resource[] remotes,
                        boolean optional)

searchResources

private Resource searchResources(Requirement req,
                                 java.util.Set<Resource> resourceSet)

searchResources

private java.util.List<ResourceCapability> searchResources(Requirement req,
                                                           Resource[] resources)

Searches for resources that do meet the given requirement

Parameters:

req - the the requirement that must be satisfied by resources

resources - list of resources to look at

Returns:

all resources meeting the given requirement

getBestCandidate

private ResourceCapability getBestCandidate(java.util.List<ResourceCapability> caps)

Determines which resource is preferred to deliver the required capability. This method selects the resource providing the highest version of the capability. If two resources provide the same version of the capability, the resource with the largest number of cabailities be preferred

Parameters:

caps -

Returns:

checkInterrupt

private void checkInterrupt()

deploy

public void deploy(int flags)

Specified by:

deploy in interface Resolver

isFragmentBundle

private boolean isFragmentBundle(org.osgi.framework.Bundle bundle)

Determines if the given bundle is a fragement bundle.

Parameters:

bundle - bundle to check

Returns:

flag indicating if the given bundle is a fragement

findUpdatableLocalResource

private LocalResource findUpdatableLocalResource(Resource resource)

findLocalResources

private LocalResource[] findLocalResources(java.lang.String symName)

Returns all local resources with the given symbolic name.

Parameters:

symName - The symbolic name of the wanted local resources.

Returns:

The local resources with the specified symbolic name.

isResourceUpdatable

private boolean isResourceUpdatable(Resource oldVersion,
                                    Resource newVersion,
                                    Resource[] resources)

getResolvableRequirements

private Requirement[] getResolvableRequirements(Resource resource,
                                                Resource[] resources)

getBundleName

public static java.lang.String getBundleName(org.osgi.framework.Bundle bundle)