Class Version

java.lang.Object
org.apache.lucene.util.Version

public final class Version extends Object
Use by certain classes to match version compatibility across releases of Lucene.

WARNING: When changing the version parameter that you supply to components in Lucene, do not simply change the version at search-time, but instead also adjust your indexing code to match, and re-index.

  • Field Details

    • LUCENE_7_0_0

      @Deprecated public static final Version LUCENE_7_0_0
      Deprecated.
      (8.0.0) Use latest
      Match settings and bugs in Lucene's 7.0.0 release.
    • LUCENE_7_0_1

      @Deprecated public static final Version LUCENE_7_0_1
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.0.1 release.
    • LUCENE_7_1_0

      @Deprecated public static final Version LUCENE_7_1_0
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.1.0 release.
    • LUCENE_7_2_0

      @Deprecated public static final Version LUCENE_7_2_0
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.2.0 release.
    • LUCENE_7_2_1

      @Deprecated public static final Version LUCENE_7_2_1
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.2.1 release.
    • LUCENE_7_3_0

      @Deprecated public static final Version LUCENE_7_3_0
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.3.0 release.
    • LUCENE_7_3_1

      @Deprecated public static final Version LUCENE_7_3_1
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.3.1 release.
    • LUCENE_7_4_0

      @Deprecated public static final Version LUCENE_7_4_0
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.4.0 release.
    • LUCENE_7_5_0

      @Deprecated public static final Version LUCENE_7_5_0
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.5.0 release.
    • LUCENE_7_6_0

      @Deprecated public static final Version LUCENE_7_6_0
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.6.0 release.
    • LUCENE_7_7_0

      @Deprecated public static final Version LUCENE_7_7_0
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.7.0 release.
    • LUCENE_7_7_1

      @Deprecated public static final Version LUCENE_7_7_1
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.7.1 release.
    • LUCENE_7_7_2

      @Deprecated public static final Version LUCENE_7_7_2
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.7.2 release.
    • LUCENE_7_7_3

      @Deprecated public static final Version LUCENE_7_7_3
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.7.2 release.
    • LUCENE_7_8_0

      @Deprecated public static final Version LUCENE_7_8_0
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 7.8.0 release.
    • LUCENE_8_0_0

      @Deprecated public static final Version LUCENE_8_0_0
      Deprecated.
      (8.1.0) Use latest
      Match settings and bugs in Lucene's 8.0.0 release.
    • LUCENE_8_1_0

      @Deprecated public static final Version LUCENE_8_1_0
      Deprecated.
      (8.2.0) Use latest
      Match settings and bugs in Lucene's 8.1.0 release.
    • LUCENE_8_1_1

      @Deprecated public static final Version LUCENE_8_1_1
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 8.1.1 release.
    • LUCENE_8_2_0

      @Deprecated public static final Version LUCENE_8_2_0
      Deprecated.
      (8.3.0) Use latest
      Match settings and bugs in Lucene's 8.2.0 release.
    • LUCENE_8_3_0

      @Deprecated public static final Version LUCENE_8_3_0
      Deprecated.
      (8.4.0) Use latest
      Match settings and bugs in Lucene's 8.3.0 release.
    • LUCENE_8_3_1

      @Deprecated public static final Version LUCENE_8_3_1
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 8.3.1 release.
    • LUCENE_8_4_0

      @Deprecated public static final Version LUCENE_8_4_0
      Deprecated.
      (8.5.0) Use latest
      Match settings and bugs in Lucene's 8.4.0 release.
    • LUCENE_8_4_1

      @Deprecated public static final Version LUCENE_8_4_1
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 8.4.1 release.
    • LUCENE_8_5_0

      @Deprecated public static final Version LUCENE_8_5_0
      Deprecated.
      (8.6.0) Use latest
      Match settings and bugs in Lucene's 8.5.0 release.
    • LUCENE_8_5_1

      @Deprecated public static final Version LUCENE_8_5_1
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 8.5.1 release.
    • LUCENE_8_5_2

      @Deprecated public static final Version LUCENE_8_5_2
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 8.5.2 release.
    • LUCENE_8_6_0

      @Deprecated public static final Version LUCENE_8_6_0
      Deprecated.
      (8.7.0) Use latest
      Match settings and bugs in Lucene's 8.6.0 release.
    • LUCENE_8_6_1

      @Deprecated public static final Version LUCENE_8_6_1
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 8.6.1 release.
    • LUCENE_8_6_2

      @Deprecated public static final Version LUCENE_8_6_2
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 8.6.2 release.
    • LUCENE_8_6_3

      @Deprecated public static final Version LUCENE_8_6_3
      Deprecated.
      Use latest
      Match settings and bugs in Lucene's 8.6.3 release.
    • LUCENE_8_7_0

      @Deprecated public static final Version LUCENE_8_7_0
      Deprecated.
      (8.8.0) Use latest
      Match settings and bugs in Lucene's 8.7.0 release.
    • LUCENE_8_8_0

      @Deprecated public static final Version LUCENE_8_8_0
      Deprecated.
      (8.8.1) Use latest
      Match settings and bugs in Lucene's 8.8.0 release.
    • LUCENE_8_8_1

      @Deprecated public static final Version LUCENE_8_8_1
      Deprecated.
      (8.8.2) Use latest
      Match settings and bugs in Lucene's 8.8.1 release.
    • LUCENE_8_8_2

      public static final Version LUCENE_8_8_2
      Match settings and bugs in Lucene's 8.8.2 release.

      Use this to get the latest & greatest settings, bug fixes, etc, for Lucene.

    • LATEST

      public static final Version LATEST

      WARNING: if you use this setting, and then upgrade to a newer release of Lucene, sizable changes may happen. If backwards compatibility is important then you should instead explicitly specify an actual version.

      If you use this constant then you may need to re-index all of your documents when upgrading Lucene, as the way text is indexed may have changed. Additionally, you may need to re-test your entire application to ensure it behaves as expected, as some defaults may have changed and may break functionality in your application.

    • LUCENE_CURRENT

      @Deprecated public static final Version LUCENE_CURRENT
      Deprecated.
      Use LATEST
      Constant for backwards compatibility.
    • major

      public final int major
      Major version, the difference between stable and trunk
    • minor

      public final int minor
      Minor version, incremented within the stable branch
    • bugfix

      public final int bugfix
      Bugfix number, incremented on release branches
    • prerelease

      public final int prerelease
      Prerelease version, currently 0 (alpha), 1 (beta), or 2 (final)
    • encodedValue

      private final int encodedValue
  • Constructor Details

    • Version

      private Version(int major, int minor, int bugfix)
    • Version

      private Version(int major, int minor, int bugfix, int prerelease)
  • Method Details

    • parse

      public static Version parse(String version) throws ParseException
      Parse a version number of the form "major.minor.bugfix.prerelease". Part ".bugfix" and part ".prerelease" are optional. Note that this is forwards compatible: the parsed version does not have to exist as a constant.
      Throws:
      ParseException
    • parseLeniently

      public static Version parseLeniently(String version) throws ParseException
      Parse the given version number as a constant or dot based version.

      This method allows to use "LUCENE_X_Y" constant names, or version numbers in the format "x.y.z".

      Throws:
      ParseException
    • fromBits

      public static Version fromBits(int major, int minor, int bugfix)
      Returns a new version based on raw numbers
    • onOrAfter

      public boolean onOrAfter(Version other)
      Returns true if this version is the same or after the version from the argument.
    • toString

      public String toString()
      Overrides:
      toString in class Object
    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object
    • encodedIsValid

      private boolean encodedIsValid()
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object