Класс VolatileCallSite

java.lang.Object

java.lang.invoke.CallSite

java.lang.invoke.VolatileCallSite

public class VolatileCallSite extends CallSite

VolatileCallSite — это CallSite, целевой метод которого ведет себя как переменная типа volatile. Инструкция invokedynamic, связанная с VolatileCallSite, немедленно видит обновления целевого метода вызова, даже если это обновление происходит в другом потоке. Такая тесная связь между потоками может привести к снижению производительности.

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

Во всех остальных аспектах VolatileCallSite взаимозаменяем с MutableCallSite.

Since:

1.7

See Also:

MutableCallSite

Краткое описание конструкторов

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

Краткое описание методов

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

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

type

Методы, унаследованные от класса java.lang.Object

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

Подробное описание конструкторов

VolatileCallSite

public VolatileCallSite(MethodType type)

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

Parameters:: type - тип метода, который будет иметь этот вызов
Throws:: NullPointerException - если предложенный тип null

VolatileCallSite

public VolatileCallSite(MethodHandle target)

Создаёт вызов с volatile связью с целевым методом. Целевой метод устанавливается в заданное значение.

Parameters:: target - метод-обработчик, который будет начальным целевым методом вызова
Throws:: NullPointerException - если предложенный целевой метод null

Подробное описание методов

getTarget

public final MethodHandle getTarget()

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

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

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

Specified by:

getTarget in class CallSite

Returns:

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

See Also:

setTarget(java.lang.invoke.MethodHandle)

setTarget

public void setTarget(MethodHandle newTarget)

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

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

Specified by:

setTarget in class CallSite

Parameters:

newTarget - новый целевой метод

Throws:

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

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

See Also:

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)

Specified by:: dynamicInvoker in class CallSite
Returns:: метод-обработчик, который всегда вызывает текущий целевой метод этого вызова

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/invoke/VolatileCallSite.html