java.lang.Object

java.lang.runtime.SwitchBootstraps

public class SwitchBootstraps extends Object

switch文の選択機能を実装するinvokedynamicコール・サイトをリンクするためのブートストラップ・メソッド。ブートストラップは、switchのcaseラベルに対応する追加の静的引数を取り、暗黙的に[0..N)から番号付けします。

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

メソッドのサマリー

修飾子と型

メソッド

説明

static CallSite

enumSwitch(MethodHandles.Lookup lookup, String invocationName, MethodType invocationType, Object... labels)

列挙型のターゲットにswitchを実装するinvokedynamicコール・サイトをリンクするためのブートストラップ・メソッド。

static CallSite

typeSwitch(MethodHandles.Lookup lookup, String invocationName, MethodType invocationType, Object... labels)

参照タイプのターゲットにswitchを実装するinvokedynamicコール・サイトをリンクするためのブートストラップ・メソッド。

クラスjava.lang.Objectで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細
- typeSwitch
  public static CallSite typeSwitch(MethodHandles.Lookup lookup, String invocationName, MethodType invocationType, Object... labels)
  
  参照タイプのターゲットにswitchを実装するinvokedynamicコール・サイトをリンクするためのブートストラップ・メソッド。静的引数は、null以外で、String、Integer、ClassまたはEnumDesc型の大/小文字ラベルの配列です。
  返されるCallSiteのメソッド・ハンドルのタイプは、intという戻り型になります。 2つのパラメータがあります: 最初の引数はObjectインスタンス(target)で、2番目の引数はint (restart)になります。
  targetがnullの場合、コール・サイトのメソッドは -1を返します。
  targetがnullでない場合、コール・サイトのメソッドは、次のいずれかの条件に一致するrestart索引から始まるlabels配列内の最初の要素の索引を返します:
  
  要素のタイプがClassで、ターゲット・クラスから割当て可能です。または
  
  要素のタイプはStringまたはIntegerで、ターゲットと同等です。
  
  要素のタイプはEnumDescで、ターゲットと等しい定数を記述します。
  
  labels配列内の要素がターゲットと一致しない場合、コール・サイトのメソッドはlabels配列の長さを返します。
  restart索引の値は、0 (inclusive)からlabels配列(inclusive)の長さの間にある必要があります。そうでない場合、両方ともIndexOutOfBoundsExceptionがスローされます。
  
  パラメータ:
  
  lookup - コール元のアクセシビリティ権限を持つルックアップ・コンテキストを表します。 invokedynamicで使用されるときは、これはVMによって自動的にスタックされます。
  
  invocationName - 未使用
  
  invocationType - 2つのパラメータ(参照タイプ、intおよびint)を含むCallSiteの起動タイプ。
  
  labels - ケース・ラベル - StringおよびInteger定数と、任意の組合せのClassおよびEnumDescインスタンス
  
  戻り値:
  
  前述のとおり、CallSiteは最初の一致する要素を返します
  
  例外:
  
  NullPointerException - 引数が1つの場合はnull
  
  IllegalArgumentException - ラベル配列の要素のいずれかがnullの場合、起動タイプが参照型の最初のパラメータのメソッド・タイプでない場合、型がintで戻り型がintの2番目のパラメータ、または型がString, Integer, ClassまたはEnumDescではない要素がlabelsに含まれている場合。
  
  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配列の長さを返します。
  restart索引の値は、0 (inclusive)からlabels配列(inclusive)の長さの間にある必要があります。そうでない場合、両方ともIndexOutOfBoundsExceptionがスローされます。
  
  パラメータ:
  
  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構造」

クラスSwitchBootstraps

メソッドのサマリー

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

メソッドの詳細

typeSwitch

enumSwitch