org.eclipse.osgi.internal.resolver
Class GenericSpecificationImpl

java.lang.Object
  org.eclipse.osgi.internal.resolver.GenericSpecificationImpl

All Implemented Interfaces:

Cloneable, GenericSpecification, VersionConstraint

public class GenericSpecificationImpl
extends Object
implements GenericSpecification

Field Summary

protected Object	monitor
static int	RESOLUTION_FROM_BREE

Fields inherited from interface org.eclipse.osgi.service.resolver.GenericSpecification

RESOLUTION_MULTIPLE, RESOLUTION_OPTIONAL

Constructor Summary

GenericSpecificationImpl()

Method Summary

BundleDescription	getBundle() Returns the bundle that declares this constraint.
protected Map<String,Object>	getInteralAttributes()
protected Map<String,String>	getInternalDirectives()
protected String	getInternalNameSpace()
String	getMatchingFilter() Returns a matching filter used to match with a suppliers attributes
String	getName() Returns this constraint's name.
BundleRequirement	getRequirement() Returns the requirement represented by this constraint.
int	getResolution() Returns the resolution type of the required capability.
BaseDescription	getSupplier() Returns the supplier that satisfies this constraint, if it is resolved.
GenericDescription[]	getSuppliers() Returns the suppliers of the capability.
String	getType() Returns the type of generic specification
Object	getUserObject() Returns the user object associated to this constraint, or null if none exists.
VersionRange	getVersionRange() Returns the version range for this constraint.
protected boolean	hasMandatoryAttributes(String[] mandatory)
boolean	isResolved() Returns whether this constraint is resolved.
boolean	isSatisfiedBy(BaseDescription supplier) Returns whether this constraint could be satisfied by the given supplier.
protected void	setBundle(BundleDescription bundle)
protected void	setName(String name)
protected void	setSupplier(BaseDescription supplier)
void	setUserObject(Object userObject) Associates a user-provided object to this constraint, or removes an existing association, if null is provided.
protected void	setVersionRange(VersionRange versionRange)
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.osgi.service.resolver.VersionConstraint

getBundle, getName, getRequirement, getUserObject, getVersionRange, setUserObject

Field Detail

RESOLUTION_FROM_BREE

public static final int RESOLUTION_FROM_BREE

See Also:

Constant Field Values

monitor

protected final Object monitor

Constructor Detail

GenericSpecificationImpl

public GenericSpecificationImpl()

Method Detail

getMatchingFilter

public String getMatchingFilter()

Description copied from interface: GenericSpecification

Returns a matching filter used to match with a suppliers attributes

Specified by:

getMatchingFilter in interface GenericSpecification

Returns:

a matching filter used to match with a suppliers attributes

isSatisfiedBy

public boolean isSatisfiedBy(BaseDescription supplier)

Description copied from interface: VersionConstraint

Returns whether this constraint could be satisfied by the given supplier. This will depend on the suppliers different attributes including its name, versions and other arbitrary attributes

Specified by:

isSatisfiedBy in interface VersionConstraint

Parameters:

supplier - a supplier to be tested against this constraint (may be null)

Returns:

true if this constraint could be resolved using the supplier, false otherwise

hasMandatoryAttributes

protected boolean hasMandatoryAttributes(String[] mandatory)

toString

public String toString()

Overrides:

toString in class Object

getType

public String getType()

Description copied from interface: GenericSpecification

Returns the type of generic specification

Specified by:

getType in interface GenericSpecification

Returns:

the type of generic specification

getResolution

public int getResolution()

Description copied from interface: GenericSpecification

Returns the resolution type of the required capability. The returned value is a bit mask that may have the optional bit GenericSpecification.RESOLUTION_OPTIONAL and/or the multiple bit GenericSpecification.RESOLUTION_MULTIPLE set.

Specified by:

getResolution in interface GenericSpecification

Returns:

the resolution type of the required capability

isResolved

public boolean isResolved()

Description copied from interface: VersionConstraint

Returns whether this constraint is resolved. A resolved constraint is guaranteed to have its supplier defined.

Specified by:

isResolved in interface VersionConstraint

Returns:

true if this bundle is resolved, false otherwise

getSupplier

public BaseDescription getSupplier()

Description copied from interface: VersionConstraint

Returns the supplier that satisfies this constraint, if it is resolved.

Specified by:

getSupplier in interface VersionConstraint

Returns:

a supplier, or null

See Also:

VersionConstraint.isResolved()

setSupplier

protected void setSupplier(BaseDescription supplier)

getSuppliers

public GenericDescription[] getSuppliers()

Description copied from interface: GenericSpecification

Returns the suppliers of the capability. If the the resolution is multiple then more than one supplier may be returned

Specified by:

getSuppliers in interface GenericSpecification

Returns:

the suppliers of the capability

getInternalDirectives

protected Map<String,String> getInternalDirectives()

getInteralAttributes

protected Map<String,Object> getInteralAttributes()

getInternalNameSpace

protected String getInternalNameSpace()

getName

public String getName()

Description copied from interface: VersionConstraint

Returns this constraint's name.

Specified by:

getName in interface VersionConstraint

Returns:

this constraint's name

getVersionRange

public VersionRange getVersionRange()

Description copied from interface: VersionConstraint

Returns the version range for this constraint.

Specified by:

getVersionRange in interface VersionConstraint

Returns:

the version range for this constraint, or null

getBundle

public BundleDescription getBundle()

Description copied from interface: VersionConstraint

Returns the bundle that declares this constraint.

Specified by:

getBundle in interface VersionConstraint

Returns:

a bundle description

setName

protected void setName(String name)

setVersionRange

protected void setVersionRange(VersionRange versionRange)

setBundle

protected void setBundle(BundleDescription bundle)

getRequirement

public BundleRequirement getRequirement()

Description copied from interface: VersionConstraint

Returns the requirement represented by this constraint. Some constraint types may not be able to represent a requirement. In such cases null is returned.

Specified by:

getRequirement in interface VersionConstraint

Returns:

the requirement represented by this constraint

getUserObject

public Object getUserObject()

Description copied from interface: VersionConstraint

Returns the user object associated to this constraint, or null if none exists.

Specified by:

getUserObject in interface VersionConstraint

Returns:

the user object associated to this constraint, or null

setUserObject

public void setUserObject(Object userObject)

Description copied from interface: VersionConstraint

Associates a user-provided object to this constraint, or removes an existing association, if null is provided. The provided object is not interpreted in any ways by this constrain.

Specified by:

setUserObject in interface VersionConstraint

Parameters:

userObject - an arbitrary object provided by the user, or null