com.phloc.commons.version

Class Version

java.lang.Object

com.phloc.commons.version.Version

All Implemented Interfaces:

IHasStringRepresentation, Serializable, Comparable<Version>

@Immutable
public final class Version
extends Object
implements Comparable<Version>, IHasStringRepresentation, Serializable

This class represents a single version object. It supports 4 elements: major version (integer), minor version (integer), micro version (integer) and a qualifier (string).

Author:

Philip Helger

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_PRINT_ZERO_ELEMENTS Default value for printing zero elements in getAsString
static String	DEFAULT_VERSION_STRING default version if nothing is specified.

Constructor Summary

Constructors

Constructor and Description
Version(int nMajor) Create a new version with major version only.
Version(int nMajor, int nMinor) Create a new version with major and minor version only.
Version(int nMajor, int nMinor, int nMicro) Create a new version with major, minor and micro version number.
Version(int nMajor, int nMinor, int nMicro, int nQualifier)
Version(int nMajor, int nMinor, int nMicro, String sQualifier) Create a new version with 3 integer values and a qualifier.
Version(String sVersionString) Construct a version object from a string.
Version(String sVersionString, boolean bOldVersion) Construct a version object from a string.

Method Summary

Methods

Modifier and Type	Method and Description
int	compareTo(Version rhs) Compares two Version objects.
boolean	equals(Object o)
String	getAsString()
String	getAsString(boolean bPrintZeroElements) Get the string representation of the version number.
int	getMajor()
int	getMicro()
int	getMinor()
String	getQualifier()
int	hashCode()
boolean	isGreaterOrEqualThan(Version aVersion)
boolean	isGreaterThan(Version aVersion)
boolean	isLowerOrEqualThan(Version aVersion)
boolean	isLowerThan(Version aVersion)
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_VERSION_STRING

public static final String DEFAULT_VERSION_STRING

default version if nothing is specified.

See Also:

Constant Field Values

DEFAULT_PRINT_ZERO_ELEMENTS

public static final boolean DEFAULT_PRINT_ZERO_ELEMENTS

Default value for printing zero elements in getAsString

See Also:

Constant Field Values

Constructor Detail

Version

public Version(@Nonnegative
       int nMajor)

Create a new version with major version only.

Parameters:

nMajor - major version

Throws:

IllegalArgumentException - if the parameter is < 0

Version

public Version(@Nonnegative
       int nMajor,
       @Nonnegative
       int nMinor)

Create a new version with major and minor version only.

Parameters:

nMajor - major version

nMinor - minor version

Throws:

IllegalArgumentException - if any of the parameters is < 0

Version

public Version(@Nonnegative
       int nMajor,
       @Nonnegative
       int nMinor,
       @Nonnegative
       int nMicro)

Create a new version with major, minor and micro version number. The qualifier remains null.

Parameters:

nMajor - major version

nMinor - minor version

nMicro - micro version

Throws:

IllegalArgumentException - if any of the parameters is < 0

Version

public Version(@Nonnegative
       int nMajor,
       @Nonnegative
       int nMinor,
       @Nonnegative
       int nMicro,
       @Nonnegative
       int nQualifier)

Version

public Version(@Nonnegative
       int nMajor,
       @Nonnegative
       int nMinor,
       @Nonnegative
       int nMicro,
       @Nullable
       String sQualifier)

Create a new version with 3 integer values and a qualifier.

Parameters:

nMajor - major version

nMinor - minor version

nMicro - micro version

sQualifier - the version qualifier - may be null. If a qualifier is supplied, it may neither contain the "." or the "," character since they are used to determine the fields of a version and to separate 2 versions in a VersionRange.

Throws:

IllegalArgumentException - if any of the numeric parameters is < 0 or if the qualifier contains a forbidden character

Version

public Version(@Nullable
       String sVersionString)

Construct a version object from a string.
EBNF:
version ::= major( '.' minor ( '.' micro ( ( '.' | '-' ) qualifier )? )? )?
major ::= number
minor ::= number
micro ::= number
qualifier ::= .+

Parameters:

sVersionString - the version string to be interpreted as a version

Throws:

IllegalArgumentException - if any of the parameters is < 0

Version

public Version(@Nullable
       String sVersionString,
       boolean bOldVersion)

Construct a version object from a string.

Parameters:

sVersionString - the version string to be interpreted as a version

bOldVersion - true to use the old version to parse a string, meaning splitting only by dot; or false to indicate that the more complex parsing should be used.

Throws:

IllegalArgumentException - if any of the parameters is < 0

Method Detail

getMajor

@Nonnegative
public int getMajor()

getMinor

@Nonnegative
public int getMinor()

getMicro

@Nonnegative
public int getMicro()

getQualifier

@Nullable
public String getQualifier()

compareTo

public int compareTo(@Nonnull
            Version rhs)

Compares two Version objects.

Specified by:

compareTo in interface Comparable<Version>

Parameters:

rhs - the version to compare to

Returns:

< 0 if this is less than rhs; > 0 if this is greater than rhs, and 0 if they are equal.

Throws:

IllegalArgumentException - if the parameter is null

isGreaterThan

public boolean isGreaterThan(@Nonnull
                    Version aVersion)

isGreaterOrEqualThan

public boolean isGreaterOrEqualThan(@Nonnull
                           Version aVersion)

isLowerThan

public boolean isLowerThan(@Nonnull
                  Version aVersion)

isLowerOrEqualThan

public boolean isLowerOrEqualThan(@Nonnull
                         Version aVersion)

getAsString

@Nonnull
public String getAsString()

Specified by:

getAsString in interface IHasStringRepresentation

Returns:

The non-null string representation of this object.

getAsString

@Nonnull
public String getAsString(boolean bPrintZeroElements)

Get the string representation of the version number.

Parameters:

bPrintZeroElements - If true than trailing zeroes are printed, otherwise printed zeroes are not printed.

Returns:

Never null.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object