クラス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
      戻り値:
      このバージョンのハッシュ・コード
      関連項目: