org.eclipse.osgi.internal.module
Class ResolverImpl

java.lang.Object
  org.eclipse.osgi.internal.module.ResolverImpl

All Implemented Interfaces:

Resolver

public class ResolverImpl
extends java.lang.Object
implements Resolver

Field Summary

static boolean	DEBUG
static boolean	DEBUG_CYCLES
static boolean	DEBUG_GENERICS
static boolean	DEBUG_IMPORTS
static boolean	DEBUG_REQUIRES
static boolean	DEBUG_USES
static boolean	DEBUG_WIRING

Constructor Summary

ResolverImpl(BundleContext context, boolean checkPermissions)

Method Summary

void	bundleAdded(BundleDescription bundle) Notifies the resolver a bundle has been added to the state.
void	bundleRemoved(BundleDescription bundle, boolean pending) Notifies the resolver a bundle has been removed from the state.
void	bundleUpdated(BundleDescription newDescription, BundleDescription existingDescription, boolean pending) Notifies the resolver a bundle has been updated in the state.
void	flush() Flushes this resolver of any stored/cached data it may be keeping to facilitate incremental processing on its associated state.
java.util.Comparator	getSelectionPolicy() Returns the selection policy for this resolver or null if it is not set
State	getState() Returns the state associated with this resolver.
void	resolve(BundleDescription[] reRefresh, java.util.Dictionary[] platformProperties) Resolves the state associated with this resolver and returns an array of bundle deltas describing the changes..
ExportPackageDescription	resolveDynamicImport(BundleDescription importingBundle, java.lang.String requestedPackage) Attempts to find an ExportPackageDescription that will satisfy a dynamic import for the specified requestedPackage for the specified importingBundle.
void	setCompositeResolveHelperRegistry(CompositeResolveHelperRegistry compositeHelpers)
void	setSelectionPolicy(java.util.Comparator selectionPolicy) Sets the selection policy for this resolver.
void	setState(State newState) Sets the state associated with this resolver.

Methods inherited from class java.lang.Object

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

Field Detail

DEBUG

public static boolean DEBUG

DEBUG_WIRING

public static boolean DEBUG_WIRING

DEBUG_IMPORTS

public static boolean DEBUG_IMPORTS

DEBUG_REQUIRES

public static boolean DEBUG_REQUIRES

DEBUG_GENERICS

public static boolean DEBUG_GENERICS

DEBUG_USES

public static boolean DEBUG_USES

DEBUG_CYCLES

public static boolean DEBUG_CYCLES

Constructor Detail

ResolverImpl

public ResolverImpl(BundleContext context,
                    boolean checkPermissions)

Method Detail

resolve

public void resolve(BundleDescription[] reRefresh,
                    java.util.Dictionary[] platformProperties)

Description copied from interface: Resolver

Resolves the state associated with this resolver and returns an array of bundle deltas describing the changes.. The state and version bindings for the various bundles and packages in this state are updated and a array containing bundle deltas describing the changes returned.

This method is intended to be called only by State objects in response to a user invocation of State.resolve(). States will typically refuse to update their constituents (see State.resolveBundle() and State.resolveConstraint()) if their resolve method is not currently being invoked.

Note the given state is destructively modified to reflect the results of resolution.

Specified by:

resolve in interface Resolver

Parameters:

reRefresh - the list of bundles to discard the resolve status and reresolve. A null value indicates that all currently unresolved bundles in the state should be resolved.

platformProperties - the platform properties used to match platform filters against. A null value indicates that the system properties should be used to match against

resolveDynamicImport

public ExportPackageDescription resolveDynamicImport(BundleDescription importingBundle,
                                                     java.lang.String requestedPackage)

Description copied from interface: Resolver

Attempts to find an ExportPackageDescription that will satisfy a dynamic import for the specified requestedPackage for the specified importingBundle. If no ExportPackageDescription is available that satisfies a dynamic import for the importingBundle then null is returned.

Specified by:

resolveDynamicImport in interface Resolver

Parameters:

importingBundle - the BundleDescription that is requesting a dynamic package

requestedPackage - the name of the package that is being requested

Returns:

the ExportPackageDescription that satisfies the dynamic import request; a value of null is returned if none is available.

bundleAdded

public void bundleAdded(BundleDescription bundle)

Description copied from interface: Resolver

Notifies the resolver a bundle has been added to the state.

Specified by:

bundleAdded in interface Resolver

bundleRemoved

public void bundleRemoved(BundleDescription bundle,
                          boolean pending)

Description copied from interface: Resolver

Notifies the resolver a bundle has been removed from the state.

Specified by:

bundleRemoved in interface Resolver

Parameters:

bundle - the bundle description to remove

pending - indicates if the bundle to be remove has current dependents and will pend complete removal until the bundle has been re-resolved.

bundleUpdated

public void bundleUpdated(BundleDescription newDescription,
                          BundleDescription existingDescription,
                          boolean pending)

Description copied from interface: Resolver

Notifies the resolver a bundle has been updated in the state.

Specified by:

bundleUpdated in interface Resolver

Parameters:

newDescription - the new description

existingDescription - the existing description

pending - indicates if the bundle to be updated has current dependents and will pend complete removal until the bundle has been re-resolved.

flush

public void flush()

Description copied from interface: Resolver

Flushes this resolver of any stored/cached data it may be keeping to facilitate incremental processing on its associated state. This is typicaly used when switching the resolver's state object.

Specified by:

flush in interface Resolver

getState

public State getState()

Description copied from interface: Resolver

Returns the state associated with this resolver. A state can work with at most one resolver at any given time. Similarly, a resolver can work with at most one state at a time.

Specified by:

getState in interface Resolver

Returns:

the state for this resolver. null is returned if the resolver does not have a state

setState

public void setState(State newState)

Description copied from interface: Resolver

Sets the state associated with this resolver. A state can work with at most one resolver at any given time. Similarly, a resolver can work with at most one state at a time.

To ensure that this resolver and the given state are properly linked, the following expression must be included in this method if the given state (value) is not identical to the result of this.getState().

  if (this.getState() != value) value.setResolver(this);
 

Specified by:

setState in interface Resolver

setSelectionPolicy

public void setSelectionPolicy(java.util.Comparator selectionPolicy)

Description copied from interface: Resolver

Sets the selection policy for this resolver. A selection policy is used to sort possible suppliers of a version constraint in descending order. That is an order which is from most desired to least desired. The objects passed to the selection policy Comparator.compare(Object, Object) method will be of type BaseDescription. The selection policy should return a negative number, zero, or a positive number depending on if the first object is more desired, equal amount of desire, or less desired than the second object respectively.

If no selection policy is set then a default policy will be used which sorts according to the following rules:

1. The resolution status of the bundle which supplies the base description. Resolved bundles take priority over unresolved ones.
2. The version of the base description. Higher versions take priority over lower versions.
3. The bundle ID which supplies the base description. Lower IDs take priority over higher IDs.

Specified by:

setSelectionPolicy in interface Resolver

Parameters:

selectionPolicy - the selection policy for this resolver

getSelectionPolicy

public java.util.Comparator getSelectionPolicy()

Description copied from interface: Resolver

Returns the selection policy for this resolver or null if it is not set

Specified by:

getSelectionPolicy in interface Resolver

Returns:

the selection policy for this resolver or null if it is not set

setCompositeResolveHelperRegistry

public void setCompositeResolveHelperRegistry(CompositeResolveHelperRegistry compositeHelpers)