Class Version

java.lang.Object
org.java.plugin.registry.Version
All Implemented Interfaces:
Serializable, Comparable<Version>

public final class Version extends Object implements Serializable, Comparable<Version>
This class represents a plug-in version identifier.
Version:
$Id$
See Also:
  • Field Details

    • SEPARATOR

      public static final char SEPARATOR
      Version identifier parts separator.
      See Also:
  • Constructor Details

    • Version

      public Version(int aMajor, int aMinor, int aBuild, String aName)
      Creates version identifier object from given parts. No validation performed during object instantiation, all values become parts of version identifier as they are.
      Parameters:
      aMajor - major version number
      aMinor - minor version number
      aBuild - build number
      aName - build name, null value becomes empty string
  • Method Details

    • parse

      public static Version parse(String str)
      Parses given string as version identifier. All missing parts will be initialized to 0 or empty string. Parsing starts from left side of the string.
      Parameters:
      str - version identifier as string
      Returns:
      version identifier object
    • getBuild

      public int getBuild()
      Returns:
      build number
    • getMajor

      public int getMajor()
      Returns:
      major version number
    • getMinor

      public int getMinor()
      Returns:
      minor version number
    • getName

      public String getName()
      Returns:
      build name
    • isGreaterOrEqualTo

      public boolean isGreaterOrEqualTo(Version other)
      Compares two version identifiers to see if this one is greater than or equal to the argument.

      A version identifier is considered to be greater than or equal if its major component is greater than the argument major component, or the major components are equal and its minor component is greater than the argument minor component, or the major and minor components are equal and its build component is greater than the argument build component, or all components are equal.

      Parameters:
      other - the other version identifier
      Returns:
      true if this version identifier is compatible with the given version identifier, and false otherwise
    • isCompatibleWith

      public boolean isCompatibleWith(Version other)
      Compares two version identifiers for compatibility.

      A version identifier is considered to be compatible if its major component equals to the argument major component, and its minor component is greater than or equal to the argument minor component. If the minor components are equal, than the build component of the version identifier must be greater than or equal to the build component of the argument identifier.

      Parameters:
      other - the other version identifier
      Returns:
      true if this version identifier is compatible with the given version identifier, and false otherwise
    • isEquivalentTo

      public boolean isEquivalentTo(Version other)
      Compares two version identifiers for equivalency.

      Two version identifiers are considered to be equivalent if their major and minor components equal and are at least at the same build level as the argument.

      Parameters:
      other - the other version identifier
      Returns:
      true if this version identifier is equivalent to the given version identifier, and false otherwise
    • isGreaterThan

      public boolean isGreaterThan(Version other)
      Compares two version identifiers for order using multi-decimal comparison.
      Parameters:
      other - the other version identifier
      Returns:
      true if this version identifier is greater than the given version identifier, and false otherwise
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object
      See Also:
    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object
      See Also:
    • toString

      public String toString()
      Returns the string representation of this version identifier. The result satisfies version.equals(new Version(version.toString())).
      Overrides:
      toString in class Object
      Returns:
      the string representation of this version identifier
    • compareTo

      public int compareTo(Version obj)
      Specified by:
      compareTo in interface Comparable<Version>
      Parameters:
      obj - version to compare this instance with
      Returns:
      comparison result
      See Also: