org.osgi.core 6.0.0 · org.osgi.framework.VersionRange

Modifier and Type	Field and Description
private final boolean	empty
private static final String	ENDPOINT_DELIMITER
private transient int	hash
private final Version	left
public static final char	LEFT_CLOSED The left endpoint is closed and is included in the range.
private static final String	LEFT_CLOSED_DELIMITER
private static final String	LEFT_DELIMITERS
public static final char	LEFT_OPEN The left endpoint is open and is excluded from the range.
private static final String	LEFT_OPEN_DELIMITER
private final boolean	leftClosed
private final Version	right
public static final char	RIGHT_CLOSED The right endpoint is closed and is included in the range.
private static final String	RIGHT_CLOSED_DELIMITER
private static final String	RIGHT_DELIMITERS
public static final char	RIGHT_OPEN The right endpoint is open and is excluded from the range.
private static final String	RIGHT_OPEN_DELIMITER
private final boolean	rightClosed
private transient String	versionRangeString

Access	Constructor and Description
public	VersionRange(char Must be either `LEFT_CLOSED` or `LEFT_OPEN` . leftType, Version Left endpoint of range. Must not be `null`. leftEndpoint, Version Right endpoint of range. May be `null` to indicate the right endpoint is Infinity. rightEndpoint, char Must be either `RIGHT_CLOSED` or `RIGHT_OPEN`. rightType) Creates a version range from the specified versions.
public	VersionRange(String String representation of the version range. The versions in the range must contain no whitespace. Other whitespace in the range string is ignored. Must not be `null`. range) Creates a version range from the specified string.

Method Summary

Modifier and Type	Method and Description
public boolean	Returns: `true` if `object` is a `VersionRange` and is equal to this object; `false` otherwise. equals(Object The `VersionRange` object to be compared. object) Overrides java.lang.Object.equals. Compares this `VersionRange` object to another object.
public Version	Returns: The left endpoint. getLeft() Returns the left endpoint of this version range.
public char	Returns: `LEFT_CLOSED` if the left endpoint is closed or `LEFT_OPEN` if the left endpoint is open. getLeftType() Returns the type of the left endpoint of this version range.
public Version	Returns: The right endpoint. May be `null` which indicates the right endpoint is Infinity. getRight() Returns the right endpoint of this version range.
public char	Returns: `RIGHT_CLOSED` if the right endpoint is closed or `RIGHT_OPEN` if the right endpoint is open. getRightType() Returns the type of the right endpoint of this version range.
public int	Returns: An integer which is a hash code value for this object. hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for the object.
public boolean	Returns: `true` if the specified version is included in this version range; `false` otherwise. includes(Version The version to test for inclusion in this version range. version) Returns whether this version range includes the specified version.
public VersionRange	Returns: A version range representing the intersection of this version range and the specified version ranges. If no version ranges are specified, then this version range is returned. intersection(VersionRange... The version ranges to intersect with this version range. ranges) Returns the intersection of this version range with the specified version ranges.
public boolean	Returns: `true` if this version range is empty; `false` otherwise. isEmpty() Returns whether this version range is empty.
private boolean	Returns: `true` if this version range is empty; `false` otherwise. isEmpty0() Internal isEmpty behavior.
public boolean	Returns: `true` if this version range contains only a single version; `false` otherwise. isExact() Returns whether this version range contains only a single version.
private static Version	Returns: Version parseVersion(String version component string version, String Complete range string for exception message, if any range) Parse version component into a Version.
public String	Returns: A filter string for this version range using the specified attribute name. toFilterString(String The attribute name to use in the returned filter string. attributeName) Returns the filter string for this version range using the specified attribute name.
public String	Returns: The string representation of this version range. toString() Overrides java.lang.Object.toString. Returns the string representation of this version range.
public static VersionRange	Returns: A `VersionRange` object representing the version range. valueOf(String String representation of the version range. The versions in the range must contain no whitespace. Other whitespace in the range string is ignored. Must not be `null`. range) Returns a `VersionRange` object holding the version range in the specified `String`.

Inherited from java.lang.Object:: clone finalize getClass notify notifyAll wait wait wait

Field Detail

empty	back to summary
private final boolean empty

ENDPOINT_DELIMITER	back to summary
private static final String ENDPOINT_DELIMITER

hash	back to summary
private transient int hash

left	back to summary
private final Version left

LEFT_CLOSED back to summary

LEFT_CLOSED	back to summary
public static final char LEFT_CLOSED The left endpoint is closed and is included in the range. The value of `LEFT_CLOSED` is `'['`.

public static final char LEFT_CLOSED

The left endpoint is closed and is included in the range.

The value of LEFT_CLOSED is '['.

LEFT_CLOSED_DELIMITER	back to summary
private static final String LEFT_CLOSED_DELIMITER

LEFT_DELIMITERS	back to summary
private static final String LEFT_DELIMITERS

LEFT_OPEN back to summary

LEFT_OPEN	back to summary
public static final char LEFT_OPEN The left endpoint is open and is excluded from the range. The value of `LEFT_OPEN` is `'('`.

public static final char LEFT_OPEN

The left endpoint is open and is excluded from the range.

The value of LEFT_OPEN is '('.

LEFT_OPEN_DELIMITER	back to summary
private static final String LEFT_OPEN_DELIMITER

leftClosed	back to summary
private final boolean leftClosed

right	back to summary
private final Version right

RIGHT_CLOSED back to summary

RIGHT_CLOSED	back to summary
public static final char RIGHT_CLOSED The right endpoint is closed and is included in the range. The value of `RIGHT_CLOSED` is `']'`.

public static final char RIGHT_CLOSED

The right endpoint is closed and is included in the range.

The value of RIGHT_CLOSED is ']'.

RIGHT_CLOSED_DELIMITER	back to summary
private static final String RIGHT_CLOSED_DELIMITER

RIGHT_DELIMITERS	back to summary
private static final String RIGHT_DELIMITERS

RIGHT_OPEN back to summary

RIGHT_OPEN	back to summary
public static final char RIGHT_OPEN The right endpoint is open and is excluded from the range. The value of `RIGHT_OPEN` is `')'`.

public static final char RIGHT_OPEN

The right endpoint is open and is excluded from the range.

The value of RIGHT_OPEN is ')'.

RIGHT_OPEN_DELIMITER	back to summary
private static final String RIGHT_OPEN_DELIMITER

rightClosed	back to summary
private final boolean rightClosed

versionRangeString	back to summary
private transient String versionRangeString

Constructor Detail

VersionRange back to summary

VersionRange	back to summary
public VersionRange(char leftType, Version leftEndpoint, Version rightEndpoint, char rightType) Creates a version range from the specified versions. Parameters leftType:char Must be either `LEFT_CLOSED` or `LEFT_OPEN` . leftEndpoint:Version Left endpoint of range. Must not be `null`. rightEndpoint:Version Right endpoint of range. May be `null` to indicate the right endpoint is Infinity. rightType:char Must be either `RIGHT_CLOSED` or `RIGHT_OPEN`. Exceptions IllegalArgumentException: If the arguments are invalid.

public VersionRange(char leftType, Version leftEndpoint, Version rightEndpoint, char rightType)

Creates a version range from the specified versions.

Parameters

leftType:char: Must be either LEFT_CLOSED or LEFT_OPEN .
leftEndpoint:Version: Left endpoint of range. Must not be null.
rightEndpoint:Version: Right endpoint of range. May be null to indicate the right endpoint is Infinity.
rightType:char: Must be either RIGHT_CLOSED or RIGHT_OPEN.

Exceptions

IllegalArgumentException:: If the arguments are invalid.

VersionRange back to summary

VersionRange	back to summary
public VersionRange(String range) Creates a version range from the specified string. Version range string grammar: range ::= interval \| atleast interval ::= ( '[' \| '(' ) left ',' right ( ']' \| ')' ) left ::= version right ::= version atleast ::= version Parameters range:String String representation of the version range. The versions in the range must contain no whitespace. Other whitespace in the range string is ignored. Must not be `null`. Exceptions IllegalArgumentException: If `range` is improperly formatted.

public VersionRange(String range)

Creates a version range from the specified string.

Version range string grammar:

range ::= interval | atleast
interval ::= ( '[' | '(' ) left ',' right ( ']' | ')' )
left ::= version
right ::= version
atleast ::= version

Parameters

range:String: String representation of the version range. The versions in the range must contain no whitespace. Other whitespace in the range string is ignored. Must not be null.

Exceptions

IllegalArgumentException:: If range is improperly formatted.

Method Detail

equals back to summary

equals	back to summary
public boolean equals(Object object) Overrides java.lang.Object.equals. Compares this `VersionRange` object to another object. A version range is considered to be equal to another version range if both the endpoints and their types are equal or if both version ranges are `empty`. Parameters object:Object The `VersionRange` object to be compared. Returns:boolean `true` if `object` is a `VersionRange` and is equal to this object; `false` otherwise. Annotations @Override

public boolean equals(Object object)

Overrides java.lang.Object.equals.

Compares this VersionRange object to another object.

A version range is considered to be equal to another version range if both the endpoints and their types are equal or if both version ranges are empty.

Parameters

object:Object: The VersionRange object to be compared.

Returns:boolean

true if object is a VersionRange and is equal to this object; false otherwise.

Annotations

@Override

getLeft	back to summary
public Version getLeft() Returns the left endpoint of this version range. Returns:Version The left endpoint.

getLeft

back to summary

public Version getLeft()

Returns the left endpoint of this version range.

Returns:Version: The left endpoint.

getLeftType back to summary

getLeftType	back to summary
public char getLeftType() Returns the type of the left endpoint of this version range. Returns:char `LEFT_CLOSED` if the left endpoint is closed or `LEFT_OPEN` if the left endpoint is open.

public char getLeftType()

Returns the type of the left endpoint of this version range.

Returns:char: LEFT_CLOSED if the left endpoint is closed or LEFT_OPEN if the left endpoint is open.

getRight back to summary

getRight	back to summary
public Version getRight() Returns the right endpoint of this version range. Returns:Version The right endpoint. May be `null` which indicates the right endpoint is Infinity.

public Version getRight()

Returns the right endpoint of this version range.

Returns:Version: The right endpoint. May be null which indicates the right endpoint is Infinity.

getRightType back to summary

getRightType	back to summary
public char getRightType() Returns the type of the right endpoint of this version range. Returns:char `RIGHT_CLOSED` if the right endpoint is closed or `RIGHT_OPEN` if the right endpoint is open.

public char getRightType()

Returns the type of the right endpoint of this version range.

Returns:char: RIGHT_CLOSED if the right endpoint is closed or RIGHT_OPEN if the right endpoint is open.

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for the object. Returns:int An integer which is a hash code value for this object. Annotations @Override

hashCode

back to summary

public int hashCode()

Overrides java.lang.Object.hashCode.

Returns a hash code value for the object.

Returns:int

An integer which is a hash code value for this object.

Annotations

@Override

includes back to summary

includes	back to summary
public boolean includes(Version version) Returns whether this version range includes the specified version. Parameters version:Version The version to test for inclusion in this version range. Returns:boolean `true` if the specified version is included in this version range; `false` otherwise.

public boolean includes(Version version)

Returns whether this version range includes the specified version.

Parameters

version:Version: The version to test for inclusion in this version range.

Returns:boolean

true if the specified version is included in this version range; false otherwise.

intersection	back to summary
public VersionRange intersection(VersionRange... ranges) Returns the intersection of this version range with the specified version ranges. Parameters ranges:VersionRange[] The version ranges to intersect with this version range. Returns:VersionRange A version range representing the intersection of this version range and the specified version ranges. If no version ranges are specified, then this version range is returned.

intersection

back to summary

public VersionRange intersection(VersionRange... ranges)

Returns the intersection of this version range with the specified version ranges.

Parameters

ranges:VersionRange[]: The version ranges to intersect with this version range.

Returns:VersionRange

A version range representing the intersection of this version range and the specified version ranges. If no version ranges are specified, then this version range is returned.

isEmpty back to summary

isEmpty	back to summary
public boolean isEmpty() Returns whether this version range is empty. A version range is empty if the set of versions defined by the interval is empty. Returns:boolean `true` if this version range is empty; `false` otherwise.

public boolean isEmpty()

Returns whether this version range is empty. A version range is empty if the set of versions defined by the interval is empty.

Returns:boolean: true if this version range is empty; false otherwise.

isEmpty0 back to summary

isEmpty0	back to summary
private boolean isEmpty0() Internal isEmpty behavior. Returns:boolean `true` if this version range is empty; `false` otherwise.

private boolean isEmpty0()

Internal isEmpty behavior.

Returns:boolean: true if this version range is empty; false otherwise.

isExact back to summary

isExact	back to summary
public boolean isExact() Returns whether this version range contains only a single version. Returns:boolean `true` if this version range contains only a single version; `false` otherwise.

public boolean isExact()

Returns whether this version range contains only a single version.

Returns:boolean: true if this version range contains only a single version; false otherwise.

parseVersion	back to summary
private static Version parseVersion(String version, String range) Parse version component into a Version. Parameters version:String version component string range:String Complete range string for exception message, if any Returns:Version Version

parseVersion

back to summary

private static Version parseVersion(String version, String range)

Parse version component into a Version.

Parameters

version:String: version component string
range:String: Complete range string for exception message, if any

Returns:Version

Version

toFilterString	back to summary
public String toFilterString(String attributeName) Returns the filter string for this version range using the specified attribute name. Parameters attributeName:String The attribute name to use in the returned filter string. Returns:String A filter string for this version range using the specified attribute name. Exceptions IllegalArgumentException: If the specified attribute name is not a valid attribute name. See Also Core Specification, Filters, for a description of the filter string syntax.

toFilterString

back to summary

public String toFilterString(String attributeName)

Returns the filter string for this version range using the specified attribute name.

Parameters

attributeName:String: The attribute name to use in the returned filter string.

Returns:String

A filter string for this version range using the specified attribute name.

Exceptions

IllegalArgumentException:: If the specified attribute name is not a valid attribute name.

See Also

Core Specification, Filters, for a description of the filter string syntax.

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Returns the string representation of this version range. The format of the version range string will be a version string if the right end point is Infinity (`null`) or an interval string. Returns:String The string representation of this version range. Annotations @Override

public String toString()

Overrides java.lang.Object.toString.

Returns the string representation of this version range.

The format of the version range string will be a version string if the right end point is Infinity (null) or an interval string.

Returns:String

The string representation of this version range.

Annotations

@Override

valueOf back to summary

valueOf	back to summary
public static VersionRange valueOf(String range) Returns a `VersionRange` object holding the version range in the specified `String`. See `VersionRange(String)` for the format of the version range string. Parameters range:String String representation of the version range. The versions in the range must contain no whitespace. Other whitespace in the range string is ignored. Must not be `null`. Returns:VersionRange A `VersionRange` object representing the version range. Exceptions IllegalArgumentException: If `range` is improperly formatted. Since 1.8

public static VersionRange valueOf(String range)

Returns a VersionRange object holding the version range in the specified String.

See VersionRange(String) for the format of the version range string.

Parameters

range:String: String representation of the version range. The versions in the range must contain no whitespace. Other whitespace in the range string is ignored. Must not be null.

Returns:VersionRange

A VersionRange object representing the version range.

Exceptions

IllegalArgumentException:: If range is improperly formatted.

Since

1.8

public Class VersionRange

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail