aQute.bnd.version

Class ComparableVersion

java.lang.Object

aQute.bnd.version.ComparableVersion

All Implemented Interfaces:

java.lang.Comparable<ComparableVersion>

class ComparableVersion
extends java.lang.Object
implements java.lang.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 and Description
private static class	ComparableVersion.IntegerItem Represents a numeric item in the version item list.
private static interface	ComparableVersion.Item
private static class	ComparableVersion.ListItem Represents a version list item.
private static class	ComparableVersion.StringItem Represents a string in the version item list, usually a qualifier.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	canonical
private static ComparableVersion	empty
private ComparableVersion.ListItem	items
private java.lang.String	value

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ComparableVersion(java.lang.String version)

Method Summary

Modifier and Type	Method and Description
int	compareTo(ComparableVersion o)
boolean	equals(java.lang.Object o)
int	hashCode()
private static ComparableVersion.Item	parseItem(boolean isDigit, java.lang.String buf)
(package private) static ComparableVersion	parseVersion(java.lang.String version)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

empty

private static final ComparableVersion empty

value

private final java.lang.String value

canonical

private final java.lang.String canonical

items

private final ComparableVersion.ListItem items

Constructor Detail

ComparableVersion

private ComparableVersion(java.lang.String version)

Method Detail

parseVersion

static ComparableVersion parseVersion(java.lang.String version)

parseItem

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

compareTo

public int compareTo(ComparableVersion o)

Specified by:

compareTo in interface java.lang.Comparable<ComparableVersion>

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object