クラスRuntime.Version

java.lang.Object
java.lang.Runtime.Version
すべての実装されたインタフェース:
Comparable<Runtime.Version>
含まれているクラス:
Runtime
public static final class Runtime.Version extends Object implements Comparable<Runtime.Version>
Java SEプラットフォー の実装用のバージョン文字列の表現。 バージョン文字列は、オプションでリリース前およびビルド前の情 が続くバージョン番号で構成されます。

バージョン番号

「バージョン番号」、$VNUMは、ピリオド(U+002E)で区切られた要 の空ではないシーケンスです。 要 はゼロ、または先 にゼロのない符号なし整数です。 バージョン番号の最終エレメントはゼロにできません。 要 がインクリメントされると、それ以降の要 はすべて削除されます。 書式は次のとおりです。 

 [1-9][0-9]*((\.0)*\.[1-9][0-9]*)*

シーケンスは任意の長さでも構いませんが、最初の4つの要 には次のように特有の意味が割り当てられます:

 $FEATURE.$INTERIM.$UPDATE.$PATCH

  • $FEATURE - フィーチャ・リリース・カウンタは、リリースの内容に関係なく、フィーチャ・リリースごとに増分されます。 フィーチャはフィーチャ・リリースで追 することができます。事前に少なくとも1つの機能のリリースが事前に通知されている 合は、削除することもできます。 正当化された 合、互換性のない変更が行われることがあります。

  • $INTERIM - 暫定リリース・カウンタは、互換性のないバグ修正と拡張機能が含まれていますが、互換性のない変更、機能の削除、および標準APIの変更は含まれていません。

  • $UPDATE - アップデート・リリース・カウンタは、セキュリティ上の問題、回帰、および新しい機能のバグを修正する互換性のあるアップデート・リリースで増やされました。

  • $PATCH - 緊急パッチ・リリース・カウンタは、クリティカルな問題を修正するために緊急リリースを生成する必要がある 合にのみ増分されます。

バージョン番号の5番目以降の要 は、実装者固有のパッチ・リリースを識別するために、プラットフォー 実装者が自由に使用できます。

バージョン番号はゼロ要 の後ろにはありません。 要 とそれに続くすべての要 が論理的にゼロの 合、それらの要 はすべて省略されます。

バージョン番号の数値のシーケンスは、数値のポイント・ワイズ方式で別のシーケンスと比較されます。e.g.、 10.0.4は、10.1.2未満です。 ある配列が他の配列よりも短い 合、短い配列の 損した要 は、より長い配列の対応する要 よりも小さいと考えられます。e.g.、10.0.2は10.0.2.1より小さい。

バージョン文字列

「バージョン文字列」、$VSTRは、前述したバージョン番号 $VNUMで、オプションでリリース前およびビルド前の情 を次の形式のいずれかで指定します: 

     $VNUM(-$PRE)?\+$BUILD(-$OPT)?
     $VNUM-$PRE(-$OPT)?
     $VNUM(\+-$OPT)?

説明:

  • $PRE、一致する([a-zA-Z0-9]+) - リリース前の識別子。 通常、eaは、アクティブ開発中の不安定な早期アクセス・リリースの 合、または内部開発者ビルドの 合はinternalです。

  • $BUILD、一致する (0|[1-9][0-9]*) - ビルド番号。各プロモート・ビルドごとに増分されます。$BUILDは、 $VNUMの任意の部分がインクリメントされると、1にリセットされます。

  • $OPT、一致する([-a-zA-Z0-9.]+) - 必要に応じて追 のビルド情 。 internalビルドの 合、多くの 合、ビルド日時が含まれます。

バージョン文字列10-eaは、$VNUM = "10"と$PRE = "ea"に一致します。 バージョン文字列10+-eaは、$VNUM = "10"と$OPT = "ea"に一致します。

2つのバージョン文字列を比較する 合、$OPTの値(存在する 合)は、選択した比較メソッドに応じて重要である 合とそうでない 合があります。 比較メソッドcompareTo()およびcompareToIgnoreOptional()は、対応するメソッドequals()およびequalsIgnoreOptional()と一貫して使用する必要があります。

「短いバージョンの文字列」、$SVSTRは、多くの 合、あまり形式的なコンテキストでは役に立たず、オプションでリリース前の識別子が続くバージョン番号です:

     $VNUM(-$PRE)?

これはvalue-basedクラスです。プログラマは、equalのインスタンスを交換可能として扱い、同期にインスタンスを使用しないようにする必要があります。そうしないと、予期しない動作が発生する可能性があります。 たとえば、将来のリリースでは、同期が失敗する可能性があります。

導入されたバージョン:
9

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    Optional<Integer>
    build()
    「ビルド番号」を返します。
    int
    compareTo(Runtime.Version obj)
    このバージョンを別のバージョンと比較します。
    int
    compareToIgnoreOptional(Runtime.Version obj)
    このバージョンを、オプションのビルド情 を無視する別のバージョンと比較します。
    boolean
    equals(Object obj)
    このVersionが別のオブジェクトと等しいかどうかを決定します。
    boolean
    equalsIgnoreOptional(Object obj)
    このVersionが、オプションのビルド情 を無視する別のビルド情 と等しいかどうかを決定します。
    int
    feature()
    バージョン番号のfeature要 の値を返します。
    int
    hashCode()
    このバージョンのハッシュ・コードを返します。
    int
    interim()
    バージョン番号のinterim要 の値を返します。存在しない 合はゼロを返します。
    int
    major()
    非推奨。
    Java SE 10以降、バージョン番号の最初の要 はメジャー・リリース番号ではなく、機能リリース・カウンタであり、タイ ・ベースのリリースごとに増分されています。
    int
    minor()
    非推奨。
    Java SE 10以降、バージョン番号の2番目の要 は、マイナー・リリース番号ではなく、暫定リリースごとに増 する暫定リリース・カウンタです。
    Optional<String>
    optional()
    optionalの追 識別ビルド情 を返します。
    static Runtime.Version
    parse(String s)
    指定された文字列を、「バージョン番号」の後にリリース前およびビルド前の情 を含む有効な「バージョン文字列」として解析します。
    int
    patch()
    バージョン番号のpatch要 の値を返します。存在しない 合はゼロを返します。
    Optional<String>
    pre()
    オプションのpre-release情 を返します。
    int
    security()
    非推奨。
    Java SE 10以降、バージョン番号の3番目の要 はセキュリティ・レベルではなく、更新リリースごとに増分されるupdate-releaseカウンタです。
    String
    toString()
    このバージョンの文字列表現を返します。
    int
    update()
    バージョン番号のupdate要 の値を返します。存在しない 合はゼロを返します。
    List<Integer>
    version()
    「バージョン番号」で表される整数の変更不可能なListを返します。

    クラスjava.lang.Objectで宣言されたメソッド

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

  • メソッドの詳細

    • parse

      public static Runtime.Version parse(String s)
      指定された文字列を、「バージョン番号」の後にリリース前およびビルド前の情 を含む有効な「バージョン文字列」として解析します。
      パラメータ:
      s - バージョンとして解釈する文字列
      戻り値:
      指定された文字列のバージョン
      スロー:
      IllegalArgumentException - 指定された文字列を有効なバージョンとして解釈できない 合
      NullPointerException - 指定された文字列がnull
      NumberFormatException - バージョン番号またはビルド番号の要 をIntegerとして表すことができない 合

    • feature

      public int feature()
      バージョン番号のfeature要 の値を返します。
      戻り値:
      特徴要 の値
      導入されたバージョン:
      10

    • interim

      public int interim()
      バージョン番号のinterim要 の値を返します。存在しない 合はゼロを返します。
      戻り値:
      中間要 の値、またはゼロ
      導入されたバージョン:
      10

    • update

      public int update()
      バージョン番号のupdate要 の値を返します。存在しない 合はゼロを返します。
      戻り値:
      更新要 の値、またはゼロ
      導入されたバージョン:
      10

    • patch

      public int patch()
      バージョン番号のpatch要 の値を返します。存在しない 合はゼロを返します。
      戻り値:
      パッチ要 の値、またはゼロ
      導入されたバージョン:
      10

    • major

      @Deprecated(since="10") public int major()
      非推奨。
      Java SE 10以降、バージョン番号の最初の要 はメジャー・リリース番号ではなく、機能リリース・カウンタであり、タイ ・ベースのリリースごとに増分されています。 このメソッドに優先してfeature()メソッドを使用します。 互換性のために、このメソッドはfeature要 の値を返します。
      バージョン番号の主要な要 の値を返します。
      戻り値:
      特徴要 の値

    • minor

      @Deprecated(since="10") public int minor()
      非推奨。
      Java SE 10以降、バージョン番号の2番目の要 は、マイナー・リリース番号ではなく、暫定リリースごとに増 する暫定リリース・カウンタです。 このメソッドに優先してinterim()メソッドを使用します。 互換性のために、このメソッドはinterim要 の値を返します。存在しない 合はゼロを返します。
      バージョン番号のマイナー要 の値を返します。存在しない 合はゼロを返します。
      戻り値:
      中間要 の値、またはゼロ

    • security

      @Deprecated(since="10") public int security()
      非推奨。
      Java SE 10以降、バージョン番号の3番目の要 はセキュリティ・レベルではなく、更新リリースごとに増分されるupdate-releaseカウンタです。 このメソッドに優先してupdate()メソッドを使用します。 互換性のために、このメソッドはupdate要 の値を返します。存在しない 合はゼロを返します。
      バージョン番号のセキュリティ要 の値を返します。存在しない 合は0を返します。
      戻り値:
      更新要 の値、またはゼロ

    • version

      public List<Integer> version()
      「バージョン番号」で表される整数の変更不可能なListを返します。 Listには常に「機能のバージョン番号」に対応する要 が少なくとも1つ含まれています。
      戻り値:
      バージョン番号で表される整数の変更不可能なリスト

    • pre

      public Optional<String> pre()
      オプションのpre-release情 を返します。
      戻り値:
      オプションのプレリリース情 を文字列として

    • build

      public Optional<Integer> build()
      「ビルド番号」を返します。
      戻り値:
      オプションのビルド番号。

    • optional

      public Optional<String> optional()
      optionalの追 識別ビルド情 を返します。
      戻り値:
      追 のビルド情 を文字列として

    • compareTo

      public int compareTo(Runtime.Version obj)
      このバージョンを別のバージョンと比較します。

      version内の各コンポーネントは、次の優先 位で比較されます: バージョン番号、プレリリース識別子、ビルド番号、オプションのビルド情 。

      比較は、バージョン番号のシーケンスを調べることから始まります。 あるシーケンスが別のシーケンスより短い 合、短いシーケンスの 落している要 は、長いシーケンスの対応する要 より小さいとみなされます。

      プレリリース識別子を持つバージョンは、常に1つのバージョンを持たないバージョンより小さいと見なされます。 プレリリース識別子は、数字のみで構成されている 合は数値で比較され、それ以外の 合は辞書 で比較されます。 数値識別子は、非数値識別子より小さいとみなされます。

      ビルド番号のないバージョンは、常にビルド番号を持つバージョンより小さくなります。それ以外の 合は、ビルド番号が数値で比較されます。

      オプションのビルド情 は辞書 に比較されます。 この比較中、オプションのビルド情 を含むバージョンは、バージョンのないバージョンよりも大きいと見なされます。

      定義:
      インタフェースComparable<Runtime.Version>内のcompareTo
      パラメータ:
      obj -比較対象のオブジェクト
      戻り値:
       の整数、ゼロ、またはこのVersionが指定されたVersionより小さいか等しいか大きい 合は正の整数
      スロー:
      NullPointerException - 指定されたオブジェクトがnull

    • compareToIgnoreOptional

      public int compareToIgnoreOptional(Runtime.Version obj)
      このバージョンを、オプションのビルド情 を無視する別のバージョンと比較します。

      2つのバージョンを比較するには、compareTo(Version)の説明に従ってバージョン文字列を調べます。た し、オプションのビルド情 は常に無視されます。

      このメソッドは、equalsIgnoreOptional()と一致する 序付けを提供します。

      パラメータ:
      obj -比較対象のオブジェクト
      戻り値:
       の整数、ゼロ、またはこのVersionが指定されたVersionより小さいか等しいか大きい 合は正の整数
      スロー:
      NullPointerException - 指定されたオブジェクトがnull

    • toString

      public String toString()
      このバージョンの文字列表現を返します。
      オーバーライド:
      toString、クラスObject
      戻り値:
      バージョン文字列

    • equals

      public boolean equals(Object obj)
      このVersionが別のオブジェクトと等しいかどうかを決定します。

      2つのVersionは、同じバージョン文字列を表す 合にのみ等しくなります。

      オーバーライド:
      equals、クラスObject
      パラメータ:
      obj - このVersionを比較する対象のオブジェクト
      戻り値:
      指定されたオブジェクトが、このVersionと同じ Versionである 合にかぎり、true
      関連 目:

    • equalsIgnoreOptional

      public boolean equalsIgnoreOptional(Object obj)
      このVersionが、オプションのビルド情 を無視する別のビルド情 と等しいかどうかを決定します。

      2つのVersionは、オプションのビルド情 を無視して同じバージョン文字列を表す 合にのみ等しくなります。

      パラメータ:
      obj - このVersionを比較する対象のオブジェクト
      戻り値:
      指定されたオブジェクトが、オプションのビルド情 を無視してこのVersionと同じ Versionである 合にかぎり、true

    • hashCode

      public int hashCode()
      このバージョンのハッシュ・コードを返します。
      オーバーライド:
      hashCode、クラスObject
      戻り値:
      このバージョンのハッシュ・コード
      関連 目: