eu.fthevenet.util.version

Class Version

java.lang.Object

eu.fthevenet.util.version.Version

All Implemented Interfaces:

java.lang.Comparable

public class Version
extends java.lang.Object
implements java.lang.Comparable

* Copyright (c) OSGi Alliance (2004, 2007). All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Field Summary

Fields

Modifier and Type	Field and Description
static Version	emptyVersion The empty version "0.0.0".
static java.lang.String	SNAPSHOT

Constructor Summary

Constructors

Constructor and Description
Version(int major, int minor, int micro) Creates a version identifier from the specified numerical components.
Version(int major, int minor, int micro, java.lang.String qualifier)
Version(int major, int minor, int micro, java.lang.String qualifier, boolean snapshot) Creates a version identifier from the specifed components.
Version(java.lang.String version) Created a version identifier from the specified string.

Method Summary

Modifier and Type	Method and Description
int	compareTo(java.lang.Object object) Compares this Version object to another object.
boolean	equals(java.lang.Object object) Compares this Version object to another object.
int	getMajor() Returns the major component of this version identifier.
int	getMicro() Returns the micro component of this version identifier.
int	getMinor() Returns the minor component of this version identifier.
java.lang.String	getQualifier() Returns the qualifier component of this version identifier.
int	hashCode() Returns a hash code value for the object.
boolean	isSnapshot()
static Version	parseVersion(java.lang.String version) Parses a version identifier from the specified string.
java.lang.String	toString() Returns the string representation of this version identifier.

Methods inherited from class java.lang.Object

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

Field Detail

SNAPSHOT

public static final java.lang.String SNAPSHOT

See Also:

Constant Field Values

emptyVersion

public static final Version emptyVersion

The empty version "0.0.0". Equivalent to calling new Version(0,0,0).

Constructor Detail

Version

public Version(int major,
               int minor,
               int micro)

Creates a version identifier from the specified numerical components.

The qualifier is set to the empty string.

Parameters:

major - Major component of the version identifier.

minor - Minor component of the version identifier.

micro - Micro component of the version identifier.

Throws:

java.lang.IllegalArgumentException - If the numerical components are negative.

Version

public Version(int major,
               int minor,
               int micro,
               java.lang.String qualifier)

Version

public Version(int major,
               int minor,
               int micro,
               java.lang.String qualifier,
               boolean snapshot)

Creates a version identifier from the specifed components.

Parameters:

major - Major component of the version identifier.

minor - Minor component of the version identifier.

micro - Micro component of the version identifier.

qualifier - Qualifier component of the version identifier. If null is specified, then the qualifier will be set to the empty string.

Throws:

java.lang.IllegalArgumentException - If the numerical components are negative or the qualifier string is invalid.

Version

public Version(java.lang.String version)

Created a version identifier from the specified string.

Here is the grammar for version strings.

 version ::= major('.'minor('.'micro('.'qualifier)?)?)?
 major ::= digit+
 minor ::= digit+
 micro ::= digit+
 qualifier ::= (alpha|digit|'_'|'-')+
 digit ::= [0..9]
 alpha ::= [a..zA..Z]
 

There must be no whitespace in version.

Parameters:

version - String representation of the version identifier.

Throws:

java.lang.IllegalArgumentException - If version is improperly formatted.

Method Detail

parseVersion

public static Version parseVersion(java.lang.String version)

Parses a version identifier from the specified string.

See Version(String) for the format of the version string.

Parameters:

version - String representation of the version identifier. Leading and trailing whitespace will be ignored.

Returns:

A Version object representing the version identifier. If version is null or the empty string then emptyVersion will be returned.

Throws:

java.lang.IllegalArgumentException - If version is improperly formatted.

getMajor

public int getMajor()

Returns the major component of this version identifier.

Returns:

The major component.

getMinor

public int getMinor()

Returns the minor component of this version identifier.

Returns:

The minor component.

getMicro

public int getMicro()

Returns the micro component of this version identifier.

Returns:

The micro component.

getQualifier

public java.lang.String getQualifier()

Returns the qualifier component of this version identifier.

Returns:

The qualifier component.

isSnapshot

public boolean isSnapshot()

toString

public java.lang.String toString()

Returns the string representation of this version identifier.

The format of the version string will be major.minor.micro if qualifier is the empty string or major.minor.micro.qualifier otherwise.

Overrides:

toString in class java.lang.Object

Returns:

The string representation of this version identifier.

hashCode

public int hashCode()

Returns a hash code value for the object.

Overrides:

hashCode in class java.lang.Object

Returns:

An integer which is a hash code value for this object.

equals

public boolean equals(java.lang.Object object)

Compares this Version object to another object.

A version is considered to be equal to another version if the major, minor and micro components are equal and the qualifier component is equal (using String.equals).

Overrides:

equals in class java.lang.Object

Parameters:

object - The Version object to be compared.

Returns:

true if object is a Version and is equal to this object; false otherwise.

compareTo

public int compareTo(java.lang.Object object)

Compares this Version object to another object.

A version is considered to be less than another version if its major component is less than the other version's major component, or the major components are equal and its minor component is less than the other version's minor component, or the major and minor components are equal and its micro component is less than the other version's micro component, or the major, minor and micro components are equal and it's qualifier component is less than the other version's qualifier component (using String.compareTo).

A version is considered to be equal to another version if the major, minor and micro components are equal and the qualifier component is equal (using String.compareTo).

Specified by:

compareTo in interface java.lang.Comparable

Parameters:

object - The Version object to be compared.

Returns:

A negative integer, zero, or a positive integer if this object is less than, equal to, or greater than the specified Version object.

Throws:

java.lang.ClassCastException - If the specified object is not a Version.