org.apache.myfaces.trinidad.context

## Class Version

- java.lang.Object
- - org.apache.myfaces.trinidad.context.Version

- All Implemented Interfaces:
    Comparable<Version>

      public final class Version
      extends Object
      implements Comparable<Version>

  Immutable Representation of a dot-separated version. This representation allows individual sections of the version to be wild-carded and allows for comparisons between Versions with different numbers of version subsections to be compared. When comparing Versions, each version subsection is compared from left to right. If one Version doesn't have a version subsection at the current index, the value of versionPadding is used for this comparison. Version subsections with the wild-card value "*" are considered equal. The value returned by compareTo() is the value of the first non-equal version subsection or zero if all subsections match. Due to the support for wild-cards, this class has a natural ordering that is inconsistent with equals. For example, `Version("5", "*").compareTo(Version("5.0", "*") == 0` `Version("5", "*").equals(Version("5.0", "*") == false;`
  Author:
    Blake Sullivan

- - ### Constructor Summary

    Constructors
    Constructor and Description
    `Version(String version)` Creates a Version instance from the dot-separated Version String using null as the padding
    `Version(String version, String versionPadding)` Creates a Version instance from the dot-separated Version String and the versionPadding.

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `int` | `compareTo(Version otherVersion)` When comparing Versions, each version subsection is compared from left to right.
    `boolean` | `equals(Object o)`
    `int` | `hashCode()`
    `String` | `toString()`

    - ### Methods inherited from class java.lang.Object

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

- - ### Constructor Detail

    - #### Version

          public Version(String version)

      Creates a Version instance from the dot-separated Version String using null as the padding
      Parameters:
        `version` - The dot-separated version to represent
      Throws:
        `NullPointerException` - if the version is null
        `IllegalArgumentException` - if the version is an empty String
      See Also:
        `Version(String, String)`

    - #### Version

          public Version(String version,
                 String versionPadding)

      Creates a Version instance from the dot-separated Version String and the versionPadding.
      Parameters:
        `version` - The dot-separated version to represent
        `versionPadding` - The value to return for sub-version sections requested beyond the sub-version sections present in the version String
      Throws:
        `NullPointerException` - if version or versionPadding are null
        `IllegalArgumentException` - if version or versionPadding are the empty String

  - ### Method Detail

    - #### compareTo

          public int compareTo(Version otherVersion)

      When comparing Versions, each version subsection is compared from left to right. If one Version doesn't have a version subsection at the current index, the value of versionPadding is used for this comparison. Version subsections with the wild-card value "*" care considered equal. The value returned by compareTo() is the value of the first non-equal version subsection or zero if all subsections match.
      Specified by:
        `compareTo` in interface `Comparable<Version>`
      Parameters:
        `otherVersion` - The Version object to compare this Version Object with
      Returns:
        a negative integer, zero, or a positive integer as this object is less than, equal to, or greater than the specified object.

    - #### toString

          public String toString()

      Overrides:
        `toString` in class `Object`

    - #### equals

          public boolean equals(Object o)

      Overrides:
        `equals` in class `Object`

    - #### hashCode

          public int hashCode()

      Overrides:
        `hashCode` in class `Object`

Copyright © 2001-2016 The Apache Software Foundation. All Rights Reserved.