compact1、compact2、compact3

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)
 

戻り値:

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