hudson.util

Class VersionNumber

java.lang.Object

hudson.util.VersionNumber

All Implemented Interfaces:

Comparable<VersionNumber>

public class VersionNumber
extends Object
implements Comparable<VersionNumber>

Immutable representation of a version number based on the Mercury version numbering scheme. VersionNumbers are Comparable.

Special tokens

We allow a component to be not just a number, but also "ea", "ea1", "ea2". "ea" is treated as "ea0", and eaN < M for any M < 0.

'*' is also allowed as a component, and '*' < M for any M < 0.

'SNAPSHOT' is also allowed as a component, and "N.SNAPSHOT" is interpreted as "N-1.*"

 2.0.* < 2.0.1 < 2.0.1-SNAPSHOT < 2.0.0.99 < 2.0.0 < 2.0.ea < 2.0
 

This class is re-implemented in 1.415. The class was originally introduced in 1.139

Since:

1.139

Author:

Stephen Connolly (stephenc@apache.org), Kenney Westerhof (kenney@apache.org), Hervé Boutemy (hboutemy@apache.org)

Field Summary

Fields

Modifier and Type	Field and Description
static Comparator<VersionNumber>	DESCENDING

Constructor Summary

Constructors

Constructor and Description
VersionNumber(String version)

Method Summary

Modifier and Type	Method and Description
int	compareTo(VersionNumber o)
int	digit(int idx) Deprecated. see getDigitAt(int)
boolean	equals(Object o)
int	getDigitAt(int idx) Returns a digit (numeric component) by its position.
int	hashCode()
boolean	isNewerThan(VersionNumber rhs)
boolean	isOlderThan(VersionNumber rhs)
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

DESCENDING

public static final Comparator<VersionNumber> DESCENDING

Constructor Detail

VersionNumber

public VersionNumber(String version)

Method Detail

compareTo

public int compareTo(VersionNumber o)

Specified by:

compareTo in interface Comparable<VersionNumber>

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

isOlderThan

public boolean isOlderThan(VersionNumber rhs)

isNewerThan

public boolean isNewerThan(VersionNumber rhs)

digit

public int digit(int idx)

Deprecated. see getDigitAt(int)

getDigitAt

public int getDigitAt(int idx)

Returns a digit (numeric component) by its position. Once a non-numeric component is found all remaining components are also considered non-numeric by this method.

Parameters:

idx - Digit position we want to retrieve starting by 0.

Returns:

The digit or -1 in case the position does not correspond with a digit.