java.lang.invoke

Класс CallSite

java.lang. Объект

java.lang.invoke. CallSite

Прямые Известные Подклассы:

ConstantCallSite, MutableCallSite, VolatileCallSite

public abstract class CallSite
extends Object

A CallSite держатель для переменной MethodHandle, который вызывают target. invokedynamic инструкция, соединенная с a CallSite делегаты все звонки в текущую цель сайта. A CallSite может быть связан с несколькими invokedynamic инструкции, или это может быть "свободное плавание", связанный ни с одним. В любом случае это может быть вызвано через связанный дескриптор метода, названный его динамическим invoker.

CallSite абстрактный класс, который не позволяет прямое разделение на подклассы пользователями. У этого есть три непосредственных, конкретных подкласса, которые можно или инстанцировать или разделены на подклассы.

• Если изменчивая цель не требуется, invokedynamic инструкция может быть постоянно связана посредством постоянного сайта вызова.
• Если изменчивая цель требуется, у которого есть энергозависимая переменная семантика, потому что обновления к цели должны быть сразу и достоверно засвидетельствованы другими потоками, энергозависимый сайт вызова может быть использован.
• Иначе, если изменчивая цель требуется, изменчивый сайт вызова может быть использован.

Непостоянный сайт вызова может быть повторно соединен, изменяя его цель. У новой цели должен быть тот же самый тип как предыдущая цель. Таким образом, хотя сайт вызова может быть повторно соединен с серией последовательных целей, он не может изменить свой тип.

Вот демонстрационное использование сайтов вызова и методов начальной загрузки, который соединяет каждый динамический сайт вызова, чтобы напечатать его параметры:

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 унаследованный от класса. Объект

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

Деталь метода

ввести

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 - если предложенная новая цель является нулем

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)
 

Возвраты:

дескриптор метода, который всегда вызывает эту текущую цель сайта вызова