io.apigee.trireme.kernel

Class NodeVersion<T>

java.lang.Object

io.apigee.trireme.kernel.NodeVersion<T>

All Implemented Interfaces:

java.lang.Comparable<NodeVersion<T>>

public class NodeVersion<T>
extends java.lang.Object
implements java.lang.Comparable<NodeVersion<T>>

This class is used when comparing versions of Node.js. It implements many of the facilities of "semver" without necessarily getting carried away. Basically, a version has three digits -- major, minor, and release. A version may be expressed as the string "1.2.3". Versions may also have wildcards, such as "1.2.x", "1.x.x", "x.x.x", or just "x". A NodeVersion has an attachment so that you can use it to match an actual implementation of something.

Constructor Summary

Constructors

Constructor and Description
NodeVersion(java.lang.String str) Create a new version descriptor.
NodeVersion(java.lang.String str, T att)

Method Summary

Modifier and Type	Method and Description
int	compareTo(NodeVersion v)
boolean	equals(java.lang.Object o)
T	getAttachment()
int	getMajor()
int	getMinor()
int	getRelease()
int	hashCode()
void	setAttachment(T a)
void	setMajor(int major)
void	setMinor(int minor)
void	setRelease(int release)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

NodeVersion

public NodeVersion(java.lang.String str)
            throws java.lang.IllegalArgumentException

Create a new version descriptor. Descriptors take the format "major.minor.release", where each is a positive integer or "x" to denote a wildcard. For instance, "1.2.3", "1.2.x", "1.2", "1.x", "1", and "x" are all valid. Any missing digits are treated as an "x".

Version numbers may be checked for equality, again with any "x" standing for a wildcard. In addition, they may be sorted, although if they contain any wildcards then the sort order will not be consistent.

Throws:

java.lang.IllegalArgumentException

NodeVersion

public NodeVersion(java.lang.String str,
                   T att)
            throws java.lang.IllegalArgumentException

Throws:

java.lang.IllegalArgumentException

Method Detail

getAttachment

public T getAttachment()

setAttachment

public void setAttachment(T a)

getMajor

public int getMajor()

setMajor

public void setMajor(int major)

getMinor

public int getMinor()

setMinor

public void setMinor(int minor)

getRelease

public int getRelease()

setRelease

public void setRelease(int release)

compareTo

public int compareTo(NodeVersion v)

Specified by:

compareTo in interface java.lang.Comparable<NodeVersion<T>>

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

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object