モジュール java.compiler

パッケージ javax.lang.model

列挙型クラスSourceVersion

java.lang.Object

java.lang.Enum<SourceVersion>

javax.lang.model.SourceVersion

すべての実装されたインタフェース:

Serializable, Comparable<SourceVersion>, Constable

public enum SourceVersion extends Enum<SourceVersion>

Javaプログラミング言語のソース・バージョン。 特定のソース・バージョンの詳細は、「Java言語仕様」の適切なエディションを参照してください。

言語の将来のリリースをモデル化するために、ソース・バージョンの定数が今後追加されることに注意してください。

導入されたバージョン:

1.6

関連項目:

• ClassFileFormatVersion

ネストされたクラスのサマリー

クラスjava.lang.Enumで宣言されたネストされたクラス/インタフェース

Enum.EnumDesc<E extends Enum<E>>

列挙型定数のサマリー

列挙型定数

列挙型定数	説明
RELEASE_0	オリジナルのバージョンです。
RELEASE_1	Java Platform 1.1によって導入されたバージョン。
RELEASE_10	Java Platform, Standard Edition 10で導入されたバージョン。
RELEASE_11	Java Platform, Standard Edition 11で導入されたバージョン。
RELEASE_12	Java Platform, Standard Edition 12で導入されたバージョン。
RELEASE_13	Java Platform, Standard Edition 13で導入されたバージョン。
RELEASE_14	Java Platform, Standard Edition 14で導入されたバージョン。
RELEASE_15	Java Platform, Standard Edition 15で導入されたバージョン。
RELEASE_16	Java Platform, Standard Edition 16で導入されたバージョン。
RELEASE_17	Java Platform, Standard Edition 17で導入されたバージョン。
RELEASE_18	Java Platform, Standard Edition 18で導入されたバージョン。
RELEASE_19	Java Platform, Standard Edition 19で導入されたバージョン。
RELEASE_2	Java 2 Platform、Standard Edition、v 1.2によって導入されたバージョン。
RELEASE_20	Java Platform, Standard Edition 20で導入されたバージョン。
RELEASE_21	Java Platform, Standard Edition 21で導入されたバージョン。
RELEASE_22	Java Platform, Standard Edition 22で導入されたバージョン。
RELEASE_3	Java 2 Platform、Standard Edition、v 1.3によって導入されたバージョン。
RELEASE_4	Java 2 Platform、Standard Edition、v 1.4によって導入されたバージョン。
RELEASE_5	Java 2 Platform、Standard Edition 5.0によって導入されたバージョン。
RELEASE_6	Java Platform, Standard Edition 6で導入されたバージョン。
RELEASE_7	Java Platform, Standard Edition 7で導入されたバージョン。
RELEASE_8	Java Platform, Standard Edition 8で導入されたバージョン。
RELEASE_9	Java Platform, Standard Edition 9で導入されたバージョン。

メソッドのサマリー

修飾子と型	メソッド	説明
static boolean	isIdentifier(CharSequence name)	nameが最新のソース・バージョンで構文的に有効な識別子(単純名)またはキーワードであるかどうかを返します。
static boolean	isKeyword(CharSequence s)	sが、最新のソース・バージョンのキーワード、ブール・リテラルまたはnullリテラルかどうかを返します。
static boolean	isKeyword(CharSequence s, SourceVersion version)	sが、指定されたソース・バージョンのキーワード、ブール・リテラルまたはnullリテラルかどうかを返します。
static boolean	isName(CharSequence name)	nameが最新のソース・バージョンで構文的に有効な修飾名であるかどうかを返します。
static boolean	isName(CharSequence name, SourceVersion version)	nameが、指定されたソース・バージョンで構文的に有効な修飾名かどうかを返します。
static SourceVersion	latest()	モデル化可能な最新のソース・バージョンを返します。
static SourceVersion	latestSupported()	現在の実行環境で完全にサポートされている最新のソース・バージョンを返します。
Runtime.Version	runtimeVersion()	このソース・バージョンをサポートする最小ランタイム・バージョンを返します。それ以外の場合はnullを返します。
static SourceVersion	valueOf(Runtime.Version rv)	ランタイム・バージョン引数で使用可能な最新のソース・バージョンを返します。
static SourceVersion	valueOf(String name)	指定された名前を持つこのクラスのenum定数を返します。
static SourceVersion[]	values()	この列挙クラスの定数を含む配列を宣言されている順序で 返します。

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

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

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

getClass, notify, notifyAll, wait, wait, wait

列挙型定数の詳細

RELEASE_0

public static final SourceVersion RELEASE_0

オリジナルのバージョンです。 「Java言語仕様First Edition」で説明されている言語。

RELEASE_1

public static final SourceVersion RELEASE_1

Java Platform 1.1によって導入されたバージョン。 この言語は、「Java言語仕様First Edition」への1.1の更新で説明されているように、ネストされたクラスで拡張されたRELEASE_0です。

RELEASE_2

public static final SourceVersion RELEASE_2

Java 2 Platform、Standard Edition、v 1.2によって導入されたバージョン。 strictfp修飾子を含む、Java言語仕様, Second Editionで説明されている言語。

RELEASE_3

public static final SourceVersion RELEASE_3

Java 2 Platform、Standard Edition、v 1.3によって導入されたバージョン。 RELEASE_2から大きな変更はありません。

RELEASE_4

public static final SourceVersion RELEASE_4

Java 2 Platform、Standard Edition、v 1.4によって導入されたバージョン。 単純なアサーション機能が追加されています。

関連項目:

• JSR 41: 単純なアサーション機能

RELEASE_5

public static final SourceVersion RELEASE_5

Java 2 Platform、Standard Edition 5.0によって導入されたバージョン。 Java言語仕様, Third Editionで説明されている言語。 ジェネリックス、注釈、オートボクシング、var-arg、拡張 forループ、および16進浮動小数点リテラルを最初にサポートしたリリースです。

関連項目:

• JSR 14: Java™プログラミング言語への汎用タイプの追加
• JSR 175: Java™プログラミング言語用のMetadata機能
• JSR 201: 列挙、自動ボックス化、ループの拡張および静的インポートによるJava™プログラミング言語の拡張

RELEASE_6

public static final SourceVersion RELEASE_6

Java Platform, Standard Edition 6で導入されたバージョン。 RELEASE_5から大きな変更はありません。

関連項目:

• The Java Language Specification, Third Edition

RELEASE_7

public static final SourceVersion RELEASE_7

Java Platform, Standard Edition 7で導入されたバージョン。 このリリースでは、コンストラクタのダイヤモンド構文、try-with-resources、スイッチの文字列、バイナリ・リテラルおよびマルチ・キャッチが追加されています。

導入されたバージョン:

1.7

関連項目:

• Java言語仕様、Java SE 7エディション
• JSR 334: Java™プログラミング言語の小規模な拡張機能

RELEASE_8

public static final SourceVersion RELEASE_8

Java Platform, Standard Edition 8で導入されたバージョン。 このリリースでは、ラムダ式、デフォルト・メソッドなどが追加されています。

導入されたバージョン:

1.8

関連項目:

• Java言語仕様、Java SE 8エディション
• JSR 335: Java™プログラミング言語でのラムダ式

RELEASE_9

public static final SourceVersion RELEASE_9

Java Platform, Standard Edition 9で導入されたバージョン。 このリリースでの追加には、モジュールおよび有効な識別子名のセットからの単一のアンダースコアの削除が含まれます。

導入されたバージョン:

9

関連項目:

• Java言語仕様、Java SE 9エディション
• JSR 376: Java™プラットフォーム・モジュール・システム
• JEP 213: Milling Project Coin

RELEASE_10

public static final SourceVersion RELEASE_10

Java Platform, Standard Edition 10で導入されたバージョン。 このリリースの追加では、ローカル変数型の推論(var)が含まれています。

導入されたバージョン:

10

関連項目:

• Java言語仕様、Java SE 10エディション
• JEP 286: ローカル変数の型推論

RELEASE_11

public static final SourceVersion RELEASE_11

Java Platform, Standard Edition 11で導入されたバージョン。 このリリースに追加するには、ラムダのパラメータにローカル変数の構文が含まれます。

導入されたバージョン:

11

関連項目:

• Java言語仕様、Java SE 11エディション
• JEP 323: ラムダ・パラメータのローカル変数構文

RELEASE_12

public static final SourceVersion RELEASE_12

Java Platform, Standard Edition 12で導入されたバージョン。 以前のリリースからの大きな変更はありません。

導入されたバージョン:

12

関連項目:

• Java言語仕様、Java SE 12エディション

RELEASE_13

public static final SourceVersion RELEASE_13

Java Platform, Standard Edition 13で導入されたバージョン。 以前のリリースからの大きな変更はありません。

導入されたバージョン:

13

関連項目:

• Java Language Specification、Java SE 13 Edition

RELEASE_14

public static final SourceVersion RELEASE_14

Java Platform, Standard Edition 14で導入されたバージョン。 このリリースの追加には、式の切替えが含まれます。

導入されたバージョン:

14

関連項目:

• Java言語仕様, Java SE 14エディション
• JEP 361: 式の切替え

RELEASE_15

public static final SourceVersion RELEASE_15

Java Platform, Standard Edition 15で導入されたバージョン。 このリリースでの追加には、テキスト・ブロックが含まれます。

導入されたバージョン:

15

関連項目:

• Java Language Specification、Java SE 15 Edition
• JEP 378: テキスト・ブロック

RELEASE_16

public static final SourceVersion RELEASE_16

Java Platform, Standard Edition 16で導入されたバージョン。 このリリースでの追加には、instanceofのレコードおよびパターン一致が含まれます。

導入されたバージョン:

16

関連項目:

• Java言語仕様, Java SE 16 Edition
• JEP 394: instanceofのパターン・マッチング
• JEP 395: レコード

RELEASE_17

public static final SourceVersion RELEASE_17

Java Platform, Standard Edition 17で導入されたバージョン。 このリリースの追加には、密閉されたクラス、および常に厳格な浮動小数点セマンティクスのリストアが含まれます。

導入されたバージョン:

17

関連項目:

• Java言語仕様、Java SE 17エディション
• JEP 306: 常に厳密な浮動小数点セマンティクスのリストア
• JEP 409: シール・クラス

RELEASE_18

public static final SourceVersion RELEASE_18

Java Platform, Standard Edition 18で導入されたバージョン。 以前のリリースからの大きな変更はありません。

導入されたバージョン:

18

関連項目:

• Java言語仕様、Java SE 18エディション

RELEASE_19

public static final SourceVersion RELEASE_19

Java Platform, Standard Edition 19で導入されたバージョン。 以前のリリースからの大きな変更はありません。

導入されたバージョン:

19

関連項目:

• Java言語仕様、Java SE 19エディション

RELEASE_20

public static final SourceVersion RELEASE_20

Java Platform, Standard Edition 20で導入されたバージョン。 以前のリリースからの大きな変更はありません。

導入されたバージョン:

20

関連項目:

• Java言語仕様、Java SE 20エディション

RELEASE_21

public static final SourceVersion RELEASE_21

Java Platform, Standard Edition 21で導入されたバージョン。 このリリースでの追加には、switchのレコード・パターンとパターン・マッチングが含まれます。

導入されたバージョン:

21

関連項目:

• The Java Language Specification, Java SE 21 Edition
• JEP 440: レコード・パターン
• JEP 441: switchのパターン・マッチング

RELEASE_22

public static final SourceVersion RELEASE_22

Java Platform, Standard Edition 22で導入されたバージョン。 このリリースの追加には、名前のない変数および名前のないパターンが含まれます。

導入されたバージョン:

22

関連項目:

• Java言語仕様、Java SE 22 Edition
• JEP 456: 名前のない変数&パターン

メソッドの詳細

values

public static SourceVersion[] values()

この列挙クラスの定数を含む配列を宣言されている順序で 返します。

戻り値:

この列挙クラスの定数を宣言されている順序で含む配列

valueOf

public static SourceVersion valueOf(String name)

指定された名前を持つこのクラスのenum定数を返します。 文字列は、このクラスでenum定数を宣言するために使用される識別子と正確に一致する必要があります。 (不適切な空白文字は許可されません。)

パラメータ:

name - 返される列挙型定数の名前。

戻り値:

指定された名前を持つ列挙型定数

例外:

IllegalArgumentException - この列挙型クラスに指定された名前の定数がない場合

NullPointerException - 引数がnullの場合

latest

public static SourceVersion latest()

モデル化可能な最新のソース・バージョンを返します。

戻り値:

モデル化可能な最新のソース・バージョン

latestSupported

public static SourceVersion latestSupported()

現在の実行環境で完全にサポートされている最新のソース・バージョンを返します。 RELEASE_9以降が返されるはずです。

APIのノート:

このメソッドはlatest()とともに含まれ、言語モデルAPIが、APIでモデル化された最新バージョンとは異なるプラットフォーム・バージョンで実行されている状況を識別できます。 状況のソートが可能な方法の1つとして、IDEまたは同様のツールが、プラットフォーム・バージョンの(N-1)で実行中にソース・バージョンのNをモデル化するAPIを使用している場合があります。 この構成での実行は、APIによってサポートされています。 (N-1)より前のプラットフォーム・バージョンまたはNより後のプラットフォーム・バージョンでAPIを実行すると、実装の詳細として機能する場合と機能しない場合があります。 注釈プロセッサが現在の実行環境で実行するコードを生成している場合、プロセッサは、latestリリースより前のlatestSupportedリリースまでのプラットフォーム機能のみを使用する必要があります。

戻り値:

現在の実行環境で完全にサポートされている最新のソース・バージョン

isIdentifier

public static boolean isIdentifier(CharSequence name)

nameが最新のソース・バージョンで構文的に有効な識別子(単純名)またはキーワードであるかどうかを返します。 名前の先頭文字でCharacter.isJavaIdentifierStart(int)がtrueを返し、それに続く文字でCharacter.isJavaIdentifierPart(int)がtrueを返すような構成となっている場合、このメソッドはtrueを返します。 このパターンは、通常の識別子、キーワード、コンテキスト・キーワードおよびリテラル"true", "false", "null"に一致します。 その他すべての文字列に対して、このメソッドはfalseを返します。

パラメータ:

name - チェック対象の文字列

戻り値:

この文字列が構文的に有効な識別子またはキーワードである場合はtrue。そうでない場合はfalse。

Java言語仕様を参照してください:

3.8 識別子

isName

public static boolean isName(CharSequence name)

nameが最新のソース・バージョンで構文的に有効な修飾名であるかどうかを返します。 構文上、修飾名は、ピリオド文字の(".")で区切られた一連の識別子です。 このメソッドは、入力文字列を期間区切りのセグメントに分割し、各セグメントに順番にチェックを適用します。 isIdentifierとは異なり、このメソッドは、キーワード、ブール・リテラルおよび任意のセグメント内のnullリテラルに対してfalseを返します。 このメソッドは、「コンテキスト・キーワード」に対してtrueを返します。

パラメータ:

name - チェック対象の文字列

戻り値:

この文字列が構文的に有効な名前である場合はtrue。そうでない場合はfalse。

Java言語仕様を参照してください:

3.9 キーワード
6.2名前と識別子

isName

public static boolean isName(CharSequence name, SourceVersion version)

nameが、指定されたソース・バージョンで構文的に有効な修飾名かどうかを返します。 構文上、修飾名は、ピリオド文字の(".")で区切られた一連の識別子です。 このメソッドは、入力文字列を期間区切りのセグメントに分割し、各セグメントに順番にチェックを適用します。 isIdentifierとは異なり、このメソッドは、キーワード、ブール・リテラルおよび任意のセグメント内のnullリテラルに対してfalseを返します。 このメソッドは、「コンテキスト・キーワード」に対してtrueを返します。

パラメータ:

name - チェック対象の文字列

version - 使用するバージョン

戻り値:

この文字列が構文的に有効な名前である場合はtrue。そうでない場合はfalse。

Java言語仕様を参照してください:

3.9 キーワード
6.2名前と識別子

導入されたバージョン:

9

isKeyword

public static boolean isKeyword(CharSequence s)

sが、最新のソース・バージョンのキーワード、ブール・リテラルまたはnullリテラルかどうかを返します。 このメソッドは、「コンテキスト・キーワード」に対してfalseを返します。

パラメータ:

s - チェック対象の文字列

戻り値:

sがキーワード、ブール・リテラルまたはNULLリテラルである場合はtrue、それ以外の場合はfalse。

Java言語仕様を参照してください:

「3.9 キーワード」
「3.10.3 ブール・リテラル」
「3.10.8 Nullリテラル」

isKeyword

public static boolean isKeyword(CharSequence s, SourceVersion version)

sが、指定されたソース・バージョンのキーワード、ブール・リテラルまたはnullリテラルかどうかを返します。 このメソッドは、「コンテキスト・キーワード」に対してfalseを返します。

パラメータ:

s - チェック対象の文字列

version - 使用するバージョン

戻り値:

sがキーワード、ブール・リテラルまたはNULLリテラルである場合はtrue、それ以外の場合はfalse。

Java言語仕様を参照してください:

「3.9 キーワード」
「3.10.3 ブール・リテラル」
「3.10.8 Nullリテラル」

導入されたバージョン:

9

valueOf

public static SourceVersion valueOf(Runtime.Version rv)

ランタイム・バージョン引数で使用可能な最新のソース・バージョンを返します。 ランタイム・バージョンfeatureが「最新ソース・バージョン」の「ランタイム・バージョン」の機能より大きい場合、 IllegalArgumentExceptionがスローされます。

Javaプログラミング言語のソース・バージョンがこれまでに線形進行に従っているため、ソース・バージョンへのマッピングを決定するために問い合せるのは、ランタイム・バージョンの機能コンポーネントのみです。 その線形性が将来変更された場合、実行時バージョンの他のコンポーネントが結果に影響する可能性があります。

APIのノート:

文字列値("17"など)から対応するソース・バージョン( RELEASE_17)に変換する式は、次のとおりです:

SourceVersion.valueOf(Runtime.Version.parse("17"))

パラメータ:

rv - ソース・バージョンにマップするランタイム・バージョン

戻り値:

ランタイム・バージョン引数で使用可能な最新ソース・バージョン

例外:

IllegalArgumentException - バージョン引数の機能がプラットフォーム・バージョンの機能より大きい場合。

導入されたバージョン:

18

runtimeVersion

public Runtime.Version runtimeVersion()

このソース・バージョンをサポートする最小ランタイム・バージョンを返します。それ以外の場合はnullを返します。 返されるランタイム・バージョンには、このソース・バージョンをサポートするのに十分な大きさのfeatureがあり、他の要素が設定されていません。 RELEASE_6以上のソース・バージョンの結果は、null以外です。

戻り値:

このソース・バージョンをサポートする最小ランタイム・バージョン。それ以外の場合はnull

導入されたバージョン:

18