org.gradle.playframework.util

Class VersionNumber

java.lang.Object

org.gradle.playframework.util.VersionNumber

All Implemented Interfaces:

Comparable<VersionNumber>

public class VersionNumber
extends Object
implements Comparable<VersionNumber>

Represents, parses, and compares version numbers. Supports a couple of different schemes:

• MAJOR.MINOR.MICRO-QUALIFIER (the default).
• MAJOR.MINOR.MICRO.PATCH-QUALIFIER.

The parse(java.lang.String) method handles missing parts and allows "." to be used instead of "-", and "_" to be used instead of "." for the patch number.

This class considers missing parts to be 0, so that "1.0" == "1.0.0" == "1.0.0_0".

Note that this class considers "1.2.3-something" less than "1.2.3". Qualifiers are compared lexicographically ("1.2.3-alpha" < "1.2.3-beta") and case-insensitive ("1.2.3-alpha" < "1.2.3.RELEASE").

To check if a version number is at least "1.2.3", disregarding a potential qualifier like "beta", use version.getBaseVersion().compareTo(VersionNumber.parse("1.2.3")) >= 0.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	VersionNumber.Scheme

Field Summary

Fields

Modifier and Type	Field and Description
static VersionNumber	UNKNOWN

Constructor Summary

Constructors

Constructor and Description
VersionNumber(int major, int minor, int micro, int patch, String qualifier)
VersionNumber(int major, int minor, int micro, String qualifier)

Method Summary

Modifier and Type	Method and Description
int	compareTo(VersionNumber other)
boolean	equals(Object other)
VersionNumber	getBaseVersion()
int	getMajor()
int	getMicro()
int	getMinor()
int	getPatch()
String	getQualifier()
int	hashCode()
static VersionNumber	parse(String versionString)
static VersionNumber.Scheme	scheme() Returns the default MAJOR.MINOR.MICRO-QUALIFIER scheme.
String	toString()
static VersionNumber	version(int major)
static VersionNumber.Scheme	withPatchNumber() Returns the MAJOR.MINOR.MICRO.PATCH-QUALIFIER scheme.

Methods inherited from class java.lang.Object

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

Field Detail

UNKNOWN

public static final VersionNumber UNKNOWN

Constructor Detail

VersionNumber

public VersionNumber(int major,
                     int minor,
                     int micro,
                     @Nullable
                     String qualifier)

VersionNumber

public VersionNumber(int major,
                     int minor,
                     int micro,
                     int patch,
                     @Nullable
                     String qualifier)

Method Detail

getMajor

public int getMajor()

getMinor

public int getMinor()

getMicro

public int getMicro()

getPatch

public int getPatch()

getQualifier

@Nullable
public String getQualifier()

getBaseVersion

public VersionNumber getBaseVersion()

compareTo

public int compareTo(VersionNumber other)

Specified by:

compareTo in interface Comparable<VersionNumber>

equals

public boolean equals(@Nullable
                      Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

version

public static VersionNumber version(int major)

scheme

public static VersionNumber.Scheme scheme()

Returns the default MAJOR.MINOR.MICRO-QUALIFIER scheme.

Returns:

the default scheme

withPatchNumber

public static VersionNumber.Scheme withPatchNumber()

Returns the MAJOR.MINOR.MICRO.PATCH-QUALIFIER scheme.

Returns:

the scheme with patch number

parse

public static VersionNumber parse(String versionString)