org.nuiton.util
Class Version

java.lang.Object
  org.nuiton.util.Version

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<Version>

public class Version
extends java.lang.Object
implements java.lang.Comparable<Version>, java.io.Serializable

A class to represent an application version with possible classifier. Replace previously org.nuiton.util.VersionNumber class. Simple version number is defined like this :

 1.0.0 or 1
 

A version can be more complex, with a classifier like this :

 1.0.0-alpha-1, 1.0.0-beta-2, 1.0.0-rc-1
 

A classifier (alpha, beta, rc, ...) must be follwed by a classifier number. Note : - initial value is 0 - the equals order is defined on getVersion() property. - the class is comparable, using the natural version order :

0 < 0.1 < 1 < 1.0 < 1.1-alpha-0 < 1.1-alpha-1 < 1.1-beta-0 <
        1.1-rc-1 < 1.1 

- the class is immutable, you should not instanciate directly a Version, but prefer use the factory static methods VersionUtil.valueOf(...) instead.

Since:

1.1.0

Author:

tchemit

See Also:

Serialized Form

Field Summary

protected java.lang.String	classifier optional classifier
protected java.lang.Integer	classifierNumber optional classifier number (if no classifier should ne null)
protected int[]	numbers main numbers of the version
protected java.lang.String	version representation textuelle de la version (celle utilisee dans le toString().
static Version	VZERO Version V0

Constructor Summary

Version()
Constructeur par defaut, definit la version par defaut, i.e 0

Version(int... numbers)
Constructeur d'une version simple (sans classifier).

Version(java.lang.String version)
Constructeur de version a partir de sa representation textuelle

Version(java.lang.String classifier, java.lang.Integer classiferNumber, int... numbers)
Constructeur d'une version (simple ou avec classifier)

Method Summary

boolean	after(Version o)
boolean	before(Version o)
int	compareTo(Version o)
boolean	equals(java.lang.Object obj)
java.lang.String	getClassifier()
java.lang.Integer	getClassifierNumber()
int	getNbComponents()
int	getNumber(int level)
int[]	getNumbers()
java.lang.String	getValidName() Convertit la representation textuelle de la version en identifiant java valide : - en java : "." interdit - en mysql, h2 ... : "." interdit
java.lang.String	getVersion()
boolean	hasClassifier()
int	hashCode()
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

VZERO

public static final Version VZERO

Version V0

classifier

protected final java.lang.String classifier

optional classifier

classifierNumber

protected final java.lang.Integer classifierNumber

optional classifier number (if no classifier should ne null)

numbers

protected final int[] numbers

main numbers of the version

version

protected transient java.lang.String version

representation textuelle de la version (celle utilisee dans le toString().

Constructor Detail

Version

public Version()

Constructeur par defaut, definit la version par defaut, i.e 0

Version

public Version(int... numbers)

Constructeur d'une version simple (sans classifier).

Parameters:

numbers - les nombres de la version

Version

public Version(java.lang.String classifier,
               java.lang.Integer classiferNumber,
               int... numbers)

Constructeur d'une version (simple ou avec classifier)

Parameters:

classifier - le classifier (peut-être null)

classiferNumber - la version du classifier (doit etre null si le classifier est null)

numbers - les nombres de la version

Version

public Version(java.lang.String version)
        throws java.lang.IllegalArgumentException

Constructeur de version a partir de sa representation textuelle

Parameters:

version - la represention de la version a instancier

Throws:

java.lang.IllegalArgumentException - si la version n'est pas valide

Method Detail

getNumbers

public int[] getNumbers()

getClassifier

public java.lang.String getClassifier()

hasClassifier

public boolean hasClassifier()

getClassifierNumber

public java.lang.Integer getClassifierNumber()

getNbComponents

public int getNbComponents()

getNumber

public int getNumber(int level)

getVersion

public java.lang.String getVersion()

getValidName

public java.lang.String getValidName()

Convertit la representation textuelle de la version en identifiant java valide : - en java : "." interdit - en mysql, h2 ... : "." interdit

Returns:

la valeur ou les carateres interdits sont remplaces par '_'

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

compareTo

public int compareTo(Version o)

Specified by:

compareTo in interface java.lang.Comparable<Version>

before

public boolean before(Version o)

Parameters:

o - the other version to test

Returns:

true if current version is before the given one

after

public boolean after(Version o)

Parameters:

o - the other version to test

Returns:

true if current version is after the given one

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object