java.lang.invoke

Класс VolatileCallSite

java.lang. Объект

java.lang.invoke. CallSite

java.lang.invoke. VolatileCallSite

public class VolatileCallSite
extends CallSite

A VolatileCallSite a CallSite чья цель действует как энергозависимая переменная. invokedynamic инструкция, соединенная с a VolatileCallSite видит обновления к его цели сайта вызова сразу, даже если обновление происходит в другом потоке. Может быть потеря производительности для такой жесткой связи между потоками.

В отличие от этого MutableCallSite, на энергозависимых сайтах вызова нет никакой syncAll работы, так как каждая запись к энергозависимой переменной неявно синхронизируется с потоками читателя.

В других отношениях, a VolatileCallSite является взаимозаменяемым MutableCallSite.

См. Также:

MutableCallSite

Сводка конструктора

Конструкторы

Конструктор и Описание
VolatileCallSite(MethodHandle target) Создает сайт вызова с энергозависимой привязкой с ее целью.
VolatileCallSite(MethodType type) Создает сайт вызова с энергозависимой привязкой с ее целью.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
MethodHandle	dynamicInvoker() Производит дескриптор метода, эквивалентный invokedynamic инструкции, которая была соединена с этим сайтом вызова.
MethodHandle	getTarget() Возвращает целевой метод сайта вызова, который ведет себя как a volatile поле VolatileCallSite.
void	setTarget(MethodHandle newTarget) Обновляет целевой метод этого сайта вызова, как энергозависимая переменная.

Методы java.lang.invoke унаследованный от класса. CallSite

ввести

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

VolatileCallSite

public VolatileCallSite(MethodType type)

Создает сайт вызова с энергозависимой привязкой с ее целью. Начальная цель ставится к дескриптору метода данного типа, который бросит IllegalStateException если вызвано.

Параметры:

type - тип метода, который будет иметь этот сайт вызова

Броски:

NullPointerException - если предложенный тип является нулем

VolatileCallSite

public VolatileCallSite(MethodHandle target)

Создает сайт вызова с энергозависимой привязкой с ее целью. Цель ставится к данному значению.

Параметры:

target - дескриптор метода, который будет начальной целью сайта вызова

Броски:

NullPointerException - если предложенная цель является нулем

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

getTarget

public final MethodHandle getTarget()

Возвращает целевой метод сайта вызова, который ведет себя как a volatile поле VolatileCallSite.

Взаимодействия getTarget с памятью то же самое с чтения от a volatile поле.

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

Определенный:

getTarget в классе CallSite

Возвраты:

состояние редактирования этого сайта вызова, дескриптор метода, который может измениться в течение долгого времени

См. Также:

setTarget(java.lang.invoke.MethodHandle)

setTarget

public void setTarget(MethodHandle newTarget)

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

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

Определенный:

setTarget в классе CallSite

Параметры:

newTarget - новая цель

Броски:

NullPointerException - если предложенная новая цель является нулем

WrongMethodTypeException - если у предложенной новой цели есть тип метода, который отличается от предыдущей цели

См. Также:

getTarget()

dynamicInvoker

public final 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)
 

Определенный:

dynamicInvoker в классе CallSite

Возвраты:

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