java.lang.invoke

クラス CallSite

java.lang.Object

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));
}

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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)
 

戻り値:

このコールサイトの現在のターゲットを常に呼び出すメソッドハンドル