Version

java.lang.Object
- com.partnersoft.system.Version

All Implemented Interfaces:

Immutable, java.lang.Comparable<Version>
```
public class Version
extends java.lang.Object
implements Immutable, java.lang.Comparable<Version>
```
A software version identifier.
This follows the more-or-less classic form of major.minor.release (e.g. 1.2.3). In general major versions indicate substantial platform changes, generally with incompatibilities between them. Minor versions indicate branches of the software. Often odd numbers are used to indicate unstable branches, while even numbers indicate stable branches. The release number is incremented for each release.
Note that these aren't ordinary decimal numbers. They are independent integers separated by periods. Thus versions are ordered 1.1, 1.2... 1.10, 1.11 - 1.1 is different from 1.10 and 1.2 comes before 1.19.
Missing pieces are represented by -1. This is only valid in the trailing versions - you can't have a version with no major version, and you can't have a version with major and release versions and no minor version.
There are a variety of interesting comparisons you can make between versions.
Copyright 2007 Partner Software, Inc.

Author:

Brad Gray, Paul Reavis, Jeremy Tarver

Constructor Summary

Constructors
Constructor and Description
`Version(int major)` Creates a new version with the given major version, no minor or release versions.
`Version(int major, int minor)` Creates a new version with the given major version, minor version, and no release version.
`Version(int major, int minor, int release)` Creates a new version with the given major, minor and release versions.
`Version(int major, int minor, int release, int subRelease)` Creates a new version with the given major, minor, release and subRelease versions.
`Version(java.lang.String versionString)` Creates a version from the provided version and build strings.
`Version(VfsFile versionFile)`

Method Summary

Methods
Modifier and Type	Method and Description
`int`	`compareTo(Version nother)`
`boolean`	`equals(java.lang.Object nother)`
`int`	`getMajor()` Returns the major version number.
`int`	`getMinor()` Returns the minor version number, or -1 if there is none.
`int`	`getRelease()` Returns the release version number, or -1 if there is none.
`int`	`getSubRelease()` Returns the subRelease version number, or -1 if there is none.
`java.lang.String`	`getVersionString()` Returns this version as a string in major.minor.release.subRelease (e.g.
`int`	`hashCode()`
`boolean`	`majorMatches(Version nother)` Returns true if the version given matches this one's major version.
`boolean`	`minorMatches(Version nother)` Returns true if the version given matches this one's major and minor versions.
`boolean`	`releaseMatches(Version nother)` Returns true if the version given matches this one's major, minor, and release versions.
`boolean`	`subReleaseMatches(Version nother)` Returns true if the version given matches this one's major, minor, release, and subrelease versions.
`java.lang.String`	`toString()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Version
```
public Version(java.lang.String versionString)
        throws java.lang.IllegalArgumentException
```
    Creates a version from the provided version and build strings. The version string must be in the correct format - 1-4 integers separated by periods (e.g. "1", "1.2", "1.2.3", "1.2.3.4", etc.). Incorrect formats will reward you with an IllegalArgumentException.
    
    Throws:
    
    java.lang.IllegalArgumentException
  - Version
```
public Version(int major)
```
    Creates a new version with the given major version, no minor or release versions.
  - Version
```
public Version(int major,
       int minor)
```
    Creates a new version with the given major version, minor version, and no release version.
  - Version
```
public Version(int major,
       int minor,
       int release)
```
    Creates a new version with the given major, minor and release versions.
  - Version
```
public Version(int major,
       int minor,
       int release,
       int subRelease)
```
    Creates a new version with the given major, minor, release and subRelease versions.
  - Version
```
public Version(VfsFile versionFile)
        throws java.lang.IllegalArgumentException
```
    Throws:
    
    java.lang.IllegalArgumentException
- Method Detail
  - majorMatches
```
public boolean majorMatches(Version nother)
```
    Returns true if the version given matches this one's major version.
  - minorMatches
```
public boolean minorMatches(Version nother)
```
    Returns true if the version given matches this one's major and minor versions. Also returns true if the major versions match and this version has no minor version (minor == -1).
  - releaseMatches
```
public boolean releaseMatches(Version nother)
```
    Returns true if the version given matches this one's major, minor, and release versions. Also returns true if the major versions match and this version has no minor version, or if the major and minor versions match and this version has no release version.
  - subReleaseMatches
```
public boolean subReleaseMatches(Version nother)
```
    Returns true if the version given matches this one's major, minor, release, and subrelease versions. Also returns true if the major versions match and this version has no minor version, or if the major and minor versions match and this version has no release version, or if the major, minor, and release match but this version has no buildNumber
  - compareTo
```
public int compareTo(Version nother)
```
    Specified by:
    
    compareTo in interface java.lang.Comparable<Version>
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object nother)
```
    Overrides:
    
    equals in class java.lang.Object
  - getVersionString
```
public java.lang.String getVersionString()
```
    Returns this version as a string in major.minor.release.subRelease (e.g. 1.2.3.4) format.
  - getMajor
```
public int getMajor()
```
    Returns the major version number.
    
    Returns:
    major version
  - getMinor
```
public int getMinor()
```
    Returns the minor version number, or -1 if there is none.
    
    Returns:
    minor version
  - getRelease
```
public int getRelease()
```
    Returns the release version number, or -1 if there is none.
    
    Returns:
    release version
  - getSubRelease
```
public int getSubRelease()
```
    Returns the subRelease version number, or -1 if there is none.
    
    Returns:
    subRelease version

Class Version

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Version

Version

Version

Version

Version

Version

Method Detail

majorMatches

minorMatches

releaseMatches

subReleaseMatches

compareTo

toString

hashCode

equals

getVersionString

getMajor

getMinor

getRelease

getSubRelease