org.identityconnectors.common

Class VersionRange

java.lang.Object

org.identityconnectors.common.VersionRange

public class VersionRange
extends Object

A version range is an interval describing a set of versions.

A range has a left (lower) endpoint and a right (upper) endpoint. Each endpoint can be open (excluded from the set) or closed (included in the set).

VersionRange objects are immutable.

Since:

1.4

Author:

Laszlo Hordos

Field Summary

Fields

Modifier and Type	Field and Description
static char	LEFT_CLOSED The left endpoint is closed and is included in the range.
static char	LEFT_OPEN The left endpoint is open and is excluded from the range.
static char	RIGHT_CLOSED The right endpoint is closed and is included in the range.
static char	RIGHT_OPEN The right endpoint is open and is excluded from the range.

Constructor Summary

Constructors

Constructor and Description
VersionRange(Version low, boolean isLowInclusive, Version high, boolean isHighInclusive)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object obj)
Version	getCeiling()
Version	getFloor()
int	hashCode()
boolean	isCeilingInclusive()
boolean	isEmpty() Returns whether this version range is empty.
boolean	isExact() Returns whether this version range contains only a single version.
boolean	isFloorInclusive()
boolean	isInRange(Version version)
static VersionRange	parse(String range) Creates a version range from the specified string.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

LEFT_OPEN

public static final char LEFT_OPEN

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

The value of LEFT_OPEN is '('.

See Also:

Constant Field Values

LEFT_CLOSED

public static final char LEFT_CLOSED

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

The value of LEFT_CLOSED is '['.

See Also:

Constant Field Values

RIGHT_OPEN

public static final char RIGHT_OPEN

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

The value of RIGHT_OPEN is ')'.

See Also:

Constant Field Values

RIGHT_CLOSED

public static final char RIGHT_CLOSED

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

The value of RIGHT_CLOSED is ']'.

See Also:

Constant Field Values

Constructor Detail

VersionRange

public VersionRange(Version low,
            boolean isLowInclusive,
            Version high,
            boolean isHighInclusive)

Method Detail

parse

public static VersionRange parse(String range)

Creates a version range from the specified string.

Version range string grammar:

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

Parameters:

range - String representation of the version range. The versions in the range must contain no whitespace. Other whitespace in the range string is ignored.

Throws:

IllegalArgumentException - If range is improperly formatted.

getFloor

public Version getFloor()

isFloorInclusive

public boolean isFloorInclusive()

getCeiling

public Version getCeiling()

isCeilingInclusive

public boolean isCeilingInclusive()

isInRange

public boolean isInRange(Version version)

isExact

public boolean isExact()

Returns whether this version range contains only a single version.

Returns:

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

isEmpty

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:

true if this version range is empty; false otherwise.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object