org.sonar.api.utils

Class Version

java.lang.Object

org.sonar.api.utils.Version

All Implemented Interfaces:

Comparable<Version>

@Immutable
public class Version
extends Object
implements Comparable<Version>

Version composed of 3 integer-sequences (major, minor and patch fields) and optionally a qualifier.

Examples: 1.0, 1.0.0, 1.2.3, 1.2-beta1, 1.2.1-beta-1

IMPORTANT NOTE

Qualifier is ignored when comparing objects (methods equals(Object), hashCode() and compareTo(Version)).

   assertThat(Version.parse("1.2")).isEqualTo(Version.parse("1.2-beta1"));
   assertThat(Version.parse("1.2").compareTo(Version.parse("1.2-beta1"))).isZero();
 

Since:

5.5

Method Summary

Modifier and Type	Method and Description
int	compareTo(Version other)
static Version	create(int major, int minor)
static Version	create(int major, int minor, int patch)
static Version	create(int major, int minor, int patch, String qualifier)
boolean	equals(Object o)
int	hashCode()
boolean	isGreaterThanOrEqual(Version than)
int	major()
int	minor()
static Version	parse(String text) Convert a String to a Version.
int	patch()
String	qualifier()
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

major

public int major()

minor

public int minor()

patch

public int patch()

qualifier

public String qualifier()

Returns:

non-null suffix. Empty if absent, else the suffix without the first character "-"

parse

public static Version parse(String text)

Convert a String to a Version. Supported formats:

• 1
• 1.2
• 1.2.3
• 1-beta-1
• 1.2-beta-1
• 1.2.3-beta-1

Note that the optional qualifier is the part after the first "-".

Throws:

IllegalArgumentException - if parameter is badly formatted, for example if it defines 4 integer-sequences.

create

public static Version create(int major,
                             int minor)

create

public static Version create(int major,
                             int minor,
                             int patch)

create

public static Version create(int major,
                             int minor,
                             int patch,
                             String qualifier)

isGreaterThanOrEqual

public boolean isGreaterThanOrEqual(Version than)

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

compareTo

public int compareTo(Version other)

Specified by:

compareTo in interface Comparable<Version>

toString

public String toString()

Overrides:

toString in class Object