compact1, compact2, compact3

java.lang.invoke

Class CallSite

java.lang.Object

java.lang.invoke.CallSite

已知直接子类：

ConstantCallSite， MutableCallSite， VolatileCallSite

public abstract class CallSite
extends Object

一个 CallSite是一个变量 MethodHandle持有人，即其 target。一个 invokedynamic指令链接到一个 CallSite代表站点的当前目标的所有电话。一个 CallSite可能与几个 invokedynamic指令有关，也可能是“自由浮动”，与没有。在任何情况下，它可能会通过相关方法处理所谓的 dynamic invoker

CallSite是一个抽象类，它不允许用户直接子类化。它有三个直接的、具体的子类，可以实例化或继承。

• 如果一个可变的目标不是必需的，一个invokedynamic指令可以通过一个constant call site意味着会永久。
• 如果一个可变的目标要求，volatile变量的语义，因为目标的更新必须及时、可靠地目睹了被其他线程，可以使用一个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文件这个方法的类的特定行为的直接子类。

结果

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

另请参见：

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

setTarget

public abstract void setTarget(MethodHandle newTarget)

更新此调用站点的目标方法，根据这个调用站点的特定类所定义的行为。对 CallSite文件这个方法的类的特定行为的直接子类。

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

参数

newTarget -新目标

异常

NullPointerException如果提出的新目标是空的

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)
 

结果

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