モジュール java.base
パッケージ java.lang.runtime

クラスSwitchBootstraps

java.lang.Object
java.lang.runtime.SwitchBootstraps
public class SwitchBootstraps extends Object
SwitchBootstrapsは、JavaプラットフォームのプレビューAPIです。
プログラムは、プレビュー機能が有効になっている場合にのみSwitchBootstrapsを使用できます。
プレビュー機能は、今後のリリースで削除するか、Javaプラットフォームの永続機能にアップグレードすることができます。
switch文の選択機能を実装するinvokedynamicコール・サイトをリンクするためのブートストラップ・メソッド。 ブートストラップは、switchのcaseラベルに対応する追加の静的引数を取り、暗黙的に[0..N)から番号付けします。
導入されたバージョン:
17

  • メソッドの詳細

    • typeSwitch

      public static CallSite typeSwitch(MethodHandles.Lookup lookup, String invocationName, MethodType invocationType, Object... labels)
      参照タイプのターゲットにswitchを実装するinvokedynamicコール・サイトをリンクするためのブートストラップ・メソッド。 静的引数は、NULL以外で、StringまたはIntegerまたはClassタイプの大/小文字ラベルの配列です。

      返されるCallSiteのメソッド・ハンドルのタイプは、intという戻り型になります。 2つのパラメータがあります: 最初の引数はObjectインスタンス(target)で、2番目の引数はint (restart)になります。

      targetがnullの場合、コール・サイトのメソッドは -1を返します。

      targetがnullでない場合、コール・サイトのメソッドは、次のいずれかの条件に一致するrestart索引から始まるlabels配列内の最初の要素の索引を返します:

      • 要素のタイプがClassで、ターゲット・クラスから割当て可能です。または
      • 要素のタイプはStringまたはIntegerで、ターゲットと同等です。

      labels配列内の要素がターゲットと一致しない場合、コール・サイトのメソッドはlabels配列の長さを返します。

      パラメータ:
      lookup - 呼び出し元のアクセシビリティ権限を持つ参照コンテキストを表します。 invokedynamicで使用されるときは、これはVMによって自動的にスタックされます。
      invocationName - 未使用
      invocationType - 2つのパラメータ(参照タイプ、intおよびint)を含むCallSiteの起動タイプ。
      labels - ケース・ラベル - StringおよびInteger定数およびClassインスタンスの任意の組合せ
      戻り値:
      前述のとおり、CallSiteは最初の一致する要素を返します
      例外:
      NullPointerException - 引数が1つの場合はnull
      IllegalArgumentException - ラベル配列内のいずれかの要素がNULLの場合、呼出しタイプが参照タイプの第1パラメータのメソッド・タイプでない場合、int型の第2パラメータ、および戻り型としてintの2番目のパラメータでない場合、またはlabelsに、タイプString、IntegerまたはClassではない要素が含まれている場合。
      Java Virtual Machine仕様を参照してください:
      「4.4.6 CONSTANT_NameAndType_info構造」
      「4.4.10 CONSTANT_Dynamic_infoおよびCONSTANT_InvokeDynamic_info構造」

    • enumSwitch

      public static CallSite enumSwitch(MethodHandles.Lookup lookup, String invocationName, MethodType invocationType, Object... labels)
      列挙型のターゲットにswitchを実装するinvokedynamicコール・サイトをリンクするためのブートストラップ・メソッド。 静的引数は、switchコンストラクトに関連付けられたcaseのラベルのエンコードに使用されます。ここでは、各ラベルを2つの方法でエンコードできます:
      • String値として、ラベルに関連付けられている列挙定数の名前を表します
      • Class値として、タイプ・テスト・パターンに関連付けられた列挙型を表します

      返されたCallSiteのメソッド・ハンドルの戻り型はintで、2つのパラメータを受け入れます: 最初の引数はEnumインスタンス(target)で、2番目の引数はint (restart)になります。

      targetがnullの場合、コール・サイトのメソッドは -1を返します。

      targetがnullでない場合、コール・サイトのメソッドは、次のいずれかの条件に一致するrestart索引から始まるlabels配列内の最初の要素の索引を返します:

      • 要素のタイプがClassで、ターゲット・クラスから割当て可能です。または
      • 要素のタイプはStringで、ターゲット列挙定数Enum.name()と同等です。

      labels配列内の要素がターゲットと一致しない場合、コール・サイトのメソッドはlabels配列の長さを返します。

      パラメータ:
      lookup - 呼び出し元のアクセシビリティ権限を持つ参照コンテキストを表します。 invokedynamicで使用されるときは、これはVMによって自動的にスタックされます。
      invocationName - 未使用
      invocationType - 2つのパラメータ(列挙型、intおよびintの戻り型)を持つCallSiteの起動タイプ。
      labels - ケース・ラベル - String定数およびClassインスタンスの任意の組合せ
      戻り値:
      前述のとおり、CallSiteは最初の一致する要素を返します
      例外:
      NullPointerException - 引数が1つの場合はnull
      IllegalArgumentException - ラベル配列内のいずれかの要素がNULLの場合、起動タイプが、最初のパラメータ・タイプが列挙型であるメソッド・タイプではない場合、int型の2番目のパラメータ、戻り型がintである場合、またはlabelsにターゲット列挙型のStringまたはClass型ではない要素が含まれる場合。
      Java Virtual Machine仕様を参照してください:
      「4.4.6 CONSTANT_NameAndType_info構造」
      「4.4.10 CONSTANT_Dynamic_infoおよびCONSTANT_InvokeDynamic_info構造」