java.lang.invoke.CallSite

直系の既知のサブクラス:: ConstantCallSite, MutableCallSite, VolatileCallSite

public abstract class CallSite
extends Object

CallSiteは、ターゲットと呼ばれる変数MethodHandleのホルダーです。 CallSiteにリンクされたinvokedynamic命令は、すべての呼出しをそのサイトの現在のターゲットに委譲します。 CallSiteは、いくつかのinvokedynamic命令に関連付けることができ、どの命令にも関連付けられていない「フリー・フローティング」の状態にすることもできます。いずれにしても、動的インボーカと呼ばれる関連付けられたメソッド・ハンドルを通じて呼び出すことができます。

CallSiteは、ユーザーによる直接的なサブクラス化を許可しない抽象クラスです。その直下には、インスタンス化やサブクラス化を行える具象サブクラスが3つあります。

可変ターゲットが不要な場合は、定数コール・サイトを使ってinvokedynamic命令を永続的にバインドできます。
ターゲットへの更新をほかのスレッドから即時かつ確実に確認できる必要があるためにvolatile変数セマンティックスを持つ可変ターゲットが必要な場合には、揮発性コール・サイトを使用できます。
それ以外の場合に可変ターゲットが必要な場合は、可変コール・サイトを使用できます。

定数でないコール・サイトは、ターゲット変更による再リンクが可能です。新しいターゲットは以前のターゲットと同じ型を持つ必要があります。したがって、1つのコール・サイトを一連のターゲットに次々と再リンクすることはできますが、その型を変更することはできません。

コール・サイトとブートストラップ・メソッドを使用してすべての動的コール・サイトをリンクし、引数を出力する例を次に示します。


static void test() throws Throwable {
    // THE FOLLOWING LINE IS PSEUDOCODE FOR A JVM INSTRUCTION
    InvokeDynamic[#bootstrapDynamic].baz("baz arg", 2, 3.14);
}
private static void printArgs(Object... args) {
  System.out.println(java.util.Arrays.deepToString(args));
}
private static final MethodHandle printArgs;
static {
  MethodHandles.Lookup lookup = MethodHandles.lookup();
  Class thisClass = lookup.lookupClass();  // (who am I?)
  printArgs = lookup.findStatic(thisClass,
      "printArgs", MethodType.methodType(void.class, Object[].class));
}
private static CallSite bootstrapDynamic(MethodHandles.Lookup caller, String name, MethodType type) {
  // ignore caller and name, but match the type:
  return new ConstantCallSite(printArgs.asType(type));
}

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

メソッドのサマリー

修飾子と型	メソッド	説明
`abstract MethodHandle`	`dynamicInvoker()`	このコール・サイトにリンクされているinvokedynamic命令と同等のメソッド・ハンドルを生成します。
`abstract MethodHandle`	`getTarget()`	このコール・サイトの特定のクラスで定義された動作に従って、コール・サイトのターゲット・メソッドを返します。
`abstract void`	`setTarget(MethodHandle newTarget)`	このコール・サイトの特定のクラスで定義された動作に従って、このコール・サイトのターゲット・メソッドを更新します。
`MethodType`	`type()`	このコール・サイトのターゲットの型を返します。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細
- type
  
  public MethodType type()
  
  このコール・サイトのターゲットの型を返します。ターゲットは変更可能ですが、すべてのコール・サイトの型は永続的であり、異なる型に変更することは決してできません。 setTargetメソッドはこの不変性を実現するため、以前のターゲットの型を持たない新しいターゲットをすべて拒否します。
  
  戻り値:
  
  現在のターゲットの型(将来のすべてのターゲットの型でもある)
- getTarget
  
  public abstract MethodHandle getTarget()
  
  このコール・サイトの特定のクラスで定義された動作に従って、コール・サイトのターゲット・メソッドを返します。このメソッドのクラス固有の動作に関するドキュメントについては、CallSiteの直下のサブクラスを参照してください。
  
  戻り値:
  
  コール・サイトの現在のリンケージ状態(ターゲット・メソッド・ハンドル)
  
  関連項目:
  
  ConstantCallSite, VolatileCallSite, setTarget(java.lang.invoke.MethodHandle), ConstantCallSite.getTarget(), MutableCallSite.getTarget(), VolatileCallSite.getTarget()
- setTarget
  
  public abstract void setTarget(MethodHandle newTarget)
  
  このコール・サイトの特定のクラスで定義された動作に従って、このコール・サイトのターゲット・メソッドを更新します。このメソッドのクラス固有の動作に関するドキュメントについては、CallSiteの直下のサブクラスを参照してください。
  新しいターゲットの型は古いターゲットの型と等しくなければいけません。
  
  パラメータ:
  
  newTarget - 新しいターゲット
  
  例外:
  
  NullPointerException - 提案された新しいターゲットがnullの場合
  
  WrongMethodTypeException - 提案された新しいターゲットのメソッド型が以前のターゲットと異なる場合
  
  関連項目:
  
  getTarget(), ConstantCallSite.setTarget(java.lang.invoke.MethodHandle), MutableCallSite.setTarget(java.lang.invoke.MethodHandle), VolatileCallSite.setTarget(java.lang.invoke.MethodHandle)
- dynamicInvoker
  
  public abstract MethodHandle dynamicInvoker()
  このコール・サイトにリンクされているinvokedynamic命令と同等のメソッド・ハンドルを生成します。
  このメソッドは次のコードと同等です。
  MethodHandle getTarget, invoker, result; getTarget = MethodHandles.publicLookup().bind(this, "getTarget", MethodType.methodType(MethodHandle.class)); invoker = MethodHandles.exactInvoker(this.type()); result = MethodHandles.foldArguments(invoker, getTarget)
  戻り値:
  
  このコール・サイトの現在のターゲットを常に呼び出すメソッド・ハンドル

クラスCallSite

メソッドのサマリー

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

メソッドの詳細

type

getTarget

setTarget

dynamicInvoker