com.day.cq.commons

Class Version

java.lang.Object

com.day.cq.commons.Version

All Implemented Interfaces:

java.lang.Comparable<Version>

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

Implements a version.

Field Summary

Fields

Modifier and Type	Field and Description
static Version	EMPTY The empty version

Method Summary

Modifier and Type	Method and Description
int	compareTo(Version o) Compares this version to the given one, segment by segment with a special "SNAPSHOT" handling.
static Version	create(java.lang.String str) Creates a new version from the given string.
static Version	create(java.lang.String[] segments) Creates a new version from version segments
boolean	equals(java.lang.Object o)
java.lang.String[]	getNormalizedSegments() Returns all segments.
int	hashCode()
java.lang.String	toString()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

EMPTY

public static final Version EMPTY

The empty version

Method Detail

create

public static Version create(java.lang.String str)

Creates a new version from the given string.

Parameters:

str - the version string.

Returns:

the new version or EMPTY if str is an empty string.

create

public static Version create(java.lang.String[] segments)

Creates a new version from version segments

Parameters:

segments - version segments

Returns:

the new version or EMPTY if segments is empty.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getNormalizedSegments

public java.lang.String[] getNormalizedSegments()

Returns all segments.

Returns:

all segments.

compareTo

public int compareTo(Version o)

Compares this version to the given one, segment by segment with a special "SNAPSHOT" handling. Examples:
"1" < "2"
"1.0" < "2"
"2.0.1" < "2.1"
"2.1" < "2.1.1"
"2.1" < "2.1-SNAPSHOT"
"2.1" < "2.1-R1234556"
"2.1-R12345" < "2.1-SNAPSHOT"

Specified by:

compareTo in interface java.lang.Comparable<Version>

Parameters:

o - the other version

Returns:

a negative integer, zero, or a positive integer as this version is less than, equal to, or greater than the specified version.