compact1, compact2, compact3

java.lang.invoke

Class CallSite

java.lang.Object

java.lang.invoke.CallSite

已知直接子类：

ConstantCallSite ， MutableCallSite ， VolatileCallSite

public abstract class CallSite
extends Object

A CallSite是一个变量MethodHandle的持有人，被称为它的target 。 一个invokedynamic指令链接到CallSite委托给该网站的当前目标的所有呼叫。 A CallSite可以与几个invokedynamic联，或者它可以是“自由浮动”，与无关联。 在任何情况下，它可以通过称为其dynamic invoker的关联方法句柄来调用。

CallSite是一个抽象类，不允许用户直接进行子类化。 它有三个立即具体的子类，可以被实例化或子类化。

• 如果不需要一个可变的靶， invokedynamic指令可永久地用的手段结合constant call site 。
• 如果需要具有易变性语义的可变目标，因为目标的更新必须立即可靠地被其他线程目击 ， 所以可以使用volatile call site 。
• 否则，如果需要可变目标，则可以使用mutable call site 。

通过更改其目标可以重新链接非常数呼叫站点。 新的目标必须与之前的目标相同的type 。 因此，虽然呼叫站点可以重新链接到一系列连续的目标，但它不能改变其类型。

以下是使用呼叫站点和引导方法的示例，它们链接每个动态调用站点以打印其参数：

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

方法摘要

Modifier and Type	Method and Description
abstract MethodHandle	dynamicInvoker() 生成等效于已经链接到此调用站点的invokedynamic指令的方法句柄。
abstract MethodHandle	getTarget() 根据此调用站点的特定类定义的行为，返回调用站点的目标方法。
abstract void	setTarget(MethodHandle newTarget) 根据此呼叫站点的特定类定义的行为，更新此呼叫站点的目标方法。
MethodType	type() 返回此呼叫站点目标的类型。

Methods inherited from class 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的CallSite子类记录了此方法的类特定行为。

结果

当前链接状态的调用站点，其目标方法句柄

另请参见：

ConstantCallSite ， VolatileCallSite ， setTarget(java.lang.invoke.MethodHandle) ， ConstantCallSite.getTarget() ， MutableCallSite.getTarget() ， VolatileCallSite.getTarget()

setTarget

public abstract void setTarget(MethodHandle newTarget)

根据此呼叫站点的特定类定义的行为，更新此呼叫站点的目标方法。 CallSite的CallSite子类记录了该方法的类特定行为。

新目标的类型必须为equal to旧目标的类型。

参数

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)
 

结果

一个总是调用此调用站点的当前目标的方法句柄