VersionNumber (Oracle Fusion Middleware Java API Reference for Oracle Extension SDK)

java.lang.Object
- oracle.ide.util.VersionNumber

All Implemented Interfaces:

java.lang.Comparable, StringConversion
```
public final class VersionNumber
extends java.lang.Object
implements java.lang.Comparable, StringConversion
```
This class encapsulates the notion of a version number or version string, which can be defined as a string of characters, usually digits, separated by dots ('.'). An example is 8.1.7.0.0.
VersionNumber has methods that can compare one instance of VersionNumber to another. During comparison, VersionNumber attempts to interpret the parts of the version string as numbers; if two corresponding parts cannot be compared as numbers, they are split in a leading number, if present, and a trailing non-number, and then compared numerically and lexicographically, e.g. 9-eb is before 10-ea and 9-ea is before 9-eb.
If one VersionNumber part has more digits and/or letters than the other, with the first portion of that part matching, then the VersionNumber with the longer part is considered to be later than the other VersionNumber, e.g. 9-e is before 9-ea and 9 is before 9.0.
Comparisons occur in a left-to-right manner, part by part. As soon as a difference is detected, then it can be determined which version number is earlier or later.
Examples:
- 8.1.7 comes after 8.1.6.
- 9.0 comes after 8.9.9.9.9.9.9.
- 8.0.5 equals 8.0.5.
- 8.0.6 comes before 8.0.6.0.
- 2.0a comes before 2.0b.
- 9-eb comes before 10-ea.
- 9-ea comes before 9-eb.
- 9-e comes before 9-eb.
- abc.xyz.qrs comes before qrs.xyz.
This class implements Comparable so that collections of VersionNumber can be easily sorted.
This class implements StringConversion so that instances of VersionNumber can be persisted and reloaded by Object2Dom.

Constructor Summary

Constructors
Constructor and Description
`VersionNumber(java.lang.String versionString)` This creates an instance of `VersionNumber` based on the dot-separated version string that is passed in.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`compareTo(java.lang.Object o)`
`int`	`countParts()` Determine how many dot-separated parts this VersionNumber has.
`boolean`	`equals(java.lang.Object o)` Compares this instance of `VersionNumber` with the specified `VersionNumber` and returns `true` if the version represented are identical.
`java.lang.String`	`getJdkSourceTargetString()` Looking at the version number as a JDK version, derive the value that is acceptable for the -source and -target Javac options, e.g.
`java.lang.String`	`getPart(int index)` Get a specific dot-separated part of this VersionNumber.
`int`	`hashCode()`
`boolean`	`isAfter(java.lang.String version)` Determine if this VersionNumber is after the other version, e.g.
`boolean`	`isAfter(java.lang.String version, boolean orEquals)` Determine if this VersionNumber is after or equal to the other version, e.g.
`boolean`	`isAfter(VersionNumber version)` Determine if this VersionNumber is after the other VersionNumber, e.g.
`boolean`	`isAfter(VersionNumber version, boolean orEquals)` Determine if this VersionNumber is after or equal to the other VersionNumber, e.g.
`boolean`	`isBefore(java.lang.String version)` Determine if this VersionNumber is before the other version, e.g.
`boolean`	`isBefore(java.lang.String version, boolean orEquals)` Determine if this VersionNumber is before or equal to the other version, e.g.
`boolean`	`isBefore(VersionNumber version)` Determine if this VersionNumber is before the other VersionNumber, e.g.
`boolean`	`isBefore(VersionNumber version, boolean orEquals)` Determine if this VersionNumber is before or equal to the other VersionNumber, e.g.
`java.lang.String`	`toString()` Returns the `VersionNumber` in dot-separated notation as a `String`.

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

- Constructor Detail
  - VersionNumber
```
public VersionNumber(java.lang.String versionString)
```
    This creates an instance of VersionNumber based on the dot-separated version string that is passed in.
    
    Parameters:
    
    versionString - A version which cannot be null
    
    Throws:
    
    java.lang.IllegalArgumentException - if versionString is null
- Method Detail
  - countParts
```
public int countParts()
```
    Determine how many dot-separated parts this VersionNumber has.
    
    Returns:
    
    the number of dot-separated parts, e.g. if the version string is "9.0", this method returns 2 and if the version string is "3", this method returns 1.
  - getPart
```
public java.lang.String getPart(int index)
```
    Get a specific dot-separated part of this VersionNumber.
    
    Parameters:
    
    index - The index of the requested part
    
    Returns:
    
    the part of the version string requested or null if index is out of bounds
  - isAfter
```
public final boolean isAfter(VersionNumber version)
```
    Determine if this VersionNumber is after the other VersionNumber, e.g. 10 is after 9. See the class javadoc for an explanation of the compare algorithm.
    
    Parameters:
    
    version - the other VersionNumber
    
    Returns:
    
    true if this VersionNumber is after the other VersionNumber, false otherwise.
  - isAfter
```
public final boolean isAfter(java.lang.String version)
```
    Determine if this VersionNumber is after the other version, e.g. 10 is after 9. See the class javadoc for an explanation of the compare algorithm.
    
    Parameters:
    
    version - the other version
    
    Returns:
    
    true if this VersionNumber is after the other version, false otherwise.
  - isAfter
```
public final boolean isAfter(VersionNumber version,
                             boolean orEquals)
```
    Determine if this VersionNumber is after or equal to the other VersionNumber, e.g. 10 is after 9. See the class javadoc for an explanation of the compare algorithm.
    
    Parameters:
    
    version - the other VersionNumber
    
    orEquals - if false, only consider after, otherwise consider after and equals to
    
    Returns:
    
    true if this VersionNumber is after or equal to the other VersionNumber, false otherwise.
  - isAfter
```
public final boolean isAfter(java.lang.String version,
                             boolean orEquals)
```
    Determine if this VersionNumber is after or equal to the other version, e.g. 10 is after 9. See the class javadoc for an explanation of the compare algorithm.
    
    Parameters:
    
    version - the other version
    
    orEquals - if false, only consider after, otherwise consider after and equals to
    
    Returns:
    
    true if this VersionNumber is after or equal to the other version, false otherwise.
  - isBefore
```
public final boolean isBefore(VersionNumber version)
```
    Determine if this VersionNumber is before the other VersionNumber, e.g. 9 is before 10. See the class javadoc for an explanation of the compare algorithm.
    
    Parameters:
    
    version - the other VersionNumber
    
    Returns:
    
    true if this VersionNumber is before the other VersionNumber, false otherwise.
  - isBefore
```
public final boolean isBefore(java.lang.String version)
```
    Determine if this VersionNumber is before the other version, e.g. 9 is before 10. See the class javadoc for an explanation of the compare algorithm.
    
    Parameters:
    
    version - the other version
    
    Returns:
    
    true if this VersionNumber is before the other version, false otherwise.
  - isBefore
```
public boolean isBefore(VersionNumber version,
                        boolean orEquals)
```
    Determine if this VersionNumber is before or equal to the other VersionNumber, e.g. 9 is before 10. See the class javadoc for an explanation of the compare algorithm.
    
    Parameters:
    
    version - the other VersionNumber
    
    orEquals - if false, only consider before, otherwise consider before and equals to
    
    Returns:
    
    true if this VersionNumber is before or equal to the other VersionNumber, false otherwise.
  - isBefore
```
public boolean isBefore(java.lang.String version,
                        boolean orEquals)
```
    Determine if this VersionNumber is before or equal to the other version, e.g. 9 is before 10. See the class javadoc for an explanation of the compare algorithm.
    
    Parameters:
    
    version - the other version
    
    orEquals - if false, only consider before, otherwise consider before and equals to
    
    Returns:
    
    true if this VersionNumber is before or equal to the other version, false otherwise.
  - getJdkSourceTargetString
```
public java.lang.String getJdkSourceTargetString()
```
    Looking at the version number as a JDK version, derive the value that is acceptable for the -source and -target Javac options, e.g. 1.8 or 9.
    
    Returns:
    
    A value acceptable for the -source and -target Javac options or null if this is not a JDK version
  - compareTo
```
public int compareTo(java.lang.Object o)
```
    Specified by:
    
    compareTo in interface java.lang.Comparable
  - equals
```
public boolean equals(java.lang.Object o)
```
    Compares this instance of VersionNumber with the specified VersionNumber and returns true if the version represented are identical.
    
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - toString
```
public java.lang.String toString()
```
    Returns the VersionNumber in dot-separated notation as a String.
    
    Overrides:
    
    toString in class java.lang.Object

Class VersionNumber

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

VersionNumber

Method Detail

countParts

getPart

isAfter

isAfter

isAfter

isAfter

isBefore

isBefore

isBefore

isBefore

getJdkSourceTargetString

compareTo

equals

hashCode

toString