クラスCallSiteDescriptor

java.lang.Object
jdk.dynalink.SecureLookupSupplier
jdk.dynalink.CallSiteDescriptor
public class CallSiteDescriptor extends SecureLookupSupplier
コール・サイト記述子には、コール・サイトのリンクに必要なすべての情報が含まれます。 この情報は通常、ブートストラップ・メソッドへのパラメータとして渡され、コール・サイトが発生するコール元クラスのMethodHandles.Lookupオブジェクト、コール・サイトでの動的操作およびコール・サイトのメソッド・タイプで構成されます。 CallSiteDescriptorオブジェクトはDynalinkで使用され、DynamicLinkerが後で使用するためにこれらのパラメータを取得して保存します。

組込みのRelinkableCallSite実装のコンストラクタはすべて、コール・サイト記述子を取ります。

コール・サイト記述子は不変である必要があります。 このクラスをそのまま使用することも、特に記述子にさらに情報を追加する必要がある場合(通常は、追加パラメータでブートストラップ・メソッドに渡される値)にサブクラス化することもできます。 記述子は不変である必要があるため、呼び出しサイトがそれらを共有するように、同等の記述子のキャッシュを設定できます。

このクラスは、SecureLookupSupplierを拡張して MethodHandles.Lookupオブジェクトをカプセル化します。 このルックアップは、この記述子によって記述されたコール・サイトのターゲットとして設定するメソッド・ハンドルを検索するために使用する必要があります。

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

  • コンストラクタの詳細

    • CallSiteDescriptor

      public CallSiteDescriptor(MethodHandles.Lookup lookup, Operation operation, MethodType methodType)
      新しいコール・サイト記述子を作成します。
      パラメータ:
      lookup - コール・サイトが属するクラスを記述するルックアップ・オブジェクト。 java.lang.invokeブートストラップ・メソッドから記述子を作成する場合、その記述子はブートストラップに渡されるルックアップである必要があります。
      operation - コール・サイトでの動的操作。
      methodType - コール・サイトのメソッド・タイプ。 java.lang.invokeブートストラップ・メソッドから記述子を作成する場合、その記述子はブートストラップに渡されるメソッド・タイプである必要があります。

  • メソッドの詳細

    • getOperation

      public final Operation getOperation()
      コール・サイトで操作を返します。
      戻り値:
      コール・サイトでの操作。

    • getMethodType

      public final MethodType getMethodType()
      コール・サイトのメソッドのタイプ。
      戻り値:
      コール・サイトでのメソッドのタイプ。

    • changeMethodType

      public final CallSiteDescriptor changeMethodType(MethodType newMethodType)
      メソッド・タイプとこの記述子のみが異なるコール・サイト記述子を検索または作成します。 changeMethodTypeInternal(MethodType)を呼び出します。
      パラメータ:
      newMethodType - 新しいメソッド型
      戻り値:
      メソッド・タイプが変更されたコール・サイト記述子。
      スロー:
      NullPointerException - newMethodTypeがNULLの場合。

    • changeMethodTypeInternal

      protected CallSiteDescriptor changeMethodTypeInternal(MethodType newMethodType)
      メソッド・タイプとこの記述子のみが異なるコール・サイト記述子を検索または作成します。 サブクラスは、その正確なクラスのオブジェクトを返すため、このメソッドをオーバーライドする必要があります。 オーバーライドされたメソッドが記述子(クラス、ルックアップまたは操作)内のメソッド型以外を変更するか、nullを返す場合、AssertionErrorはchangeMethodType(MethodType)からスローされます。
      パラメータ:
      newMethodType - 新しいメソッド型
      戻り値:
      変更されたメソッド・タイプを持つコール・サイト記述子。

    • changeOperation

      public final CallSiteDescriptor changeOperation(Operation newOperation)
      この記述子と操作のみが異なるコール・サイト記述子を検索または作成します。 changeOperationInternal(Operation)を呼び出します。
      パラメータ:
      newOperation - 新しい操作
      戻り値:
      変更された操作を含むコール・サイト記述子。
      スロー:
      NullPointerException - newOperationがNULLの場合。

    • changeOperationInternal

      protected CallSiteDescriptor changeOperationInternal(Operation newOperation)
      この記述子と操作のみが異なるコール・サイト記述子を検索または作成します。 サブクラスは、その正確なクラスのオブジェクトを返すため、このメソッドをオーバーライドする必要があります。 オーバーライドされたメソッドが記述子(クラス、ルックアップまたはメソッド・タイプ)の操作以外を変更するか、nullを返す場合、changeOperation(Operation)からAssertionErrorがスローされます。
      パラメータ:
      newOperation - 新しい操作
      戻り値:
      変更された操作を含むコール・サイト記述子。

    • equals

      public boolean equals(Object obj)
      このコール・サイト記述子が渡されたオブジェクトと等しい場合はtrueを返します。 他のオブジェクトがまったく同じクラスで、それらの操作とメソッド・タイプが等しく、それらのルックアップのMethodHandles.Lookup.lookupClass()とMethodHandles.Lookup.lookupModes()が同じである場合、同じとみなされます。
      オーバーライド:
      equals、クラスObject
      パラメータ:
      obj - 比較対象の参照オブジェクト。
      戻り値:
      このオブジェクトがobj引数と同じである場合はtrue、それ以外の場合はfalse。
      関連項目:

    • hashCode

      public int hashCode()
      操作、メソッド・タイプおよびルックアップ・オブジェクトのルックアップ・クラスおよびルックアップ・モードから計算された、このコール・サイト記述子の値ベースのハッシュ・コードを返します。
      オーバーライド:
      hashCode、クラスObject
      戻り値:
      このコール・サイト記述子の値ベースのハッシュ・コード。
      関連項目:

    • toString

      public String toString()
      name(parameterTypes)returnType@lookupという形式の、このコール・サイト記述子の文字列表現を返します。
      オーバーライド:
      toString、クラスObject
      戻り値:
      このオブジェクトの文字列表現