Package aQute.bnd.version.maven

Class ComparableVersion

java.lang.Object

aQute.bnd.version.maven.ComparableVersion

All Implemented Interfaces:

Comparable<ComparableVersion>

public class ComparableVersion
extends Object
implements Comparable<ComparableVersion>

Generic implementation of version comparison.

Features:

• mixing of '-' (hyphen) and '.' (dot) separators,
• transition between characters and digits also constitutes a separator: 1.0alpha1 => [1, 0, alpha, 1]
• unlimited number of version components,
• version components in the text can be digits or strings,
• strings are checked for well-known qualifiers and the qualifier ordering is used for version ordering. Well-known qualifiers (case insensitive) are:
  • alpha or a
  • beta or b
  • milestone or m
  • rc or cr
  • snapshot
  • (the empty string) or ga or final
  • sp
  Unknown qualifiers are considered after known qualifiers, with lexical order (always case insensitive),
• a hyphen usually precedes a qualifier, and is always less important than something preceded with a dot.

See Also:

• "Versioning" on Maven Wiki

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	ComparableVersion.BigIntegerItem	Represents a numeric item in the version item list.
private static class	ComparableVersion.IntItem	Represents a numeric item in the version item list that can be represented with an int.
private static interface	ComparableVersion.Item
private static class	ComparableVersion.ListItem	Represents a version list item.
private static class	ComparableVersion.LongItem	Represents a numeric item in the version item list that can be represented with a long.
private static class	ComparableVersion.StringItem	Represents a string in the version item list, usually a qualifier.

Field Summary

Fields

Modifier and Type	Field	Description
private String	canonical
private ComparableVersion.ListItem	items
private static final int	MAX_INTITEM_LENGTH
private static final int	MAX_LONGITEM_LENGTH
private String	value

Constructor Summary

Constructors

Constructor	Description
ComparableVersion(String version)

Method Summary

Modifier and Type	Method	Description
int	compareTo(ComparableVersion o)
boolean	equals(Object o)
String	getCanonical()
int	hashCode()
private static ComparableVersion.Item	parseItem(boolean isDigit, String buf)
final void	parseVersion(String version)
private static String	stripLeadingZeroes(String buf)
String	toString()

Methods inherited from class java.lang.Object

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

Field Details

MAX_INTITEM_LENGTH

private static final int MAX_INTITEM_LENGTH

See Also:

• Constant Field Values

MAX_LONGITEM_LENGTH

private static final int MAX_LONGITEM_LENGTH

See Also:

• Constant Field Values

value

private String value

canonical

private String canonical

items

private ComparableVersion.ListItem items

Constructor Details

ComparableVersion

public ComparableVersion(String version)

Method Details

parseVersion

public final void parseVersion(String version)

parseItem

private static ComparableVersion.Item parseItem(boolean isDigit,
 String buf)

stripLeadingZeroes

private static String stripLeadingZeroes(String buf)

compareTo

public int compareTo(ComparableVersion o)

Specified by:

compareTo in interface Comparable<ComparableVersion>

toString

public String toString()

Overrides:

toString in class Object

getCanonical

public String getCanonical()

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object