java.lang.invoke

Класс ConstantCallSite

java.lang. Объект

java.lang.invoke. CallSite

java.lang.invoke. ConstantCallSite

public class ConstantCallSite
extends CallSite

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

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

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

Модификатор	Конструктор и Описание
	ConstantCallSite(MethodHandle target) Создает сайт вызова с постоянной целью.
protected	ConstantCallSite(MethodType targetType, MethodHandle createTargetHook) Создает сайт вызова с постоянной целью, возможно связанной с сайтом вызова непосредственно.

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

Методы

Модификатор и Тип	Метод и Описание
MethodHandle	dynamicInvoker() Возвраты постоянная цель сайта этого вызова.
MethodHandle	getTarget() Возвращает целевой метод сайта вызова, который ведет себя как a final поле ConstantCallSite.
void	setTarget(MethodHandle ignore) Всегда броски UnsupportedOperationException.

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

ввести

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

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

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

ConstantCallSite

public ConstantCallSite(MethodHandle target)

Создает сайт вызова с постоянной целью.

Параметры:

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

Броски:

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

ConstantCallSite

protected ConstantCallSite(MethodType targetType,
                MethodHandle createTargetHook)
                    throws Throwable

Создает сайт вызова с постоянной целью, возможно связанной с сайтом вызова непосредственно.

Во время конструкции сайта вызова, createTargetHook вызывается, чтобы произвести фактическую цель, как будто вызовом формы (MethodHandle) createTargetHook.invoke(this).

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

Рычаг, как говорят, связывает сайт вызова с целевым дескриптором метода, и типичное действие было бы someTarget.bindTo(this). Однако, рычаг свободен предпринять любые меры вообще, включая игнорирование сайта вызова и возврат постоянной цели.

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

В то время как рычаг вызывают, новое ConstantCallSite объект находится в частично созданном состоянии. В этом состоянии, звонке getTarget, или любая другая попытка использовать цель, приведет к IllegalStateException. Законно всегда получить тип сайта вызова, используя type метод.

Параметры:

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

createTargetHook - дескриптор метода, чтобы вызвать (на сайт вызова), чтобы произвести цель сайта вызова

Броски:

WrongMethodTypeException - если рычаг не может быть вызван на необходимые параметры, или если цель, возвращенная рычагом, не имеет данного targetType

NullPointerException - если рычаг возвращает нулевое значение

ClassCastException - если рычаг возвращает что-то другое чем a MethodHandle

Throwable - что-либо еще брошенное функция рычага

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

getTarget

public final MethodHandle getTarget()

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

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

getTarget в классе CallSite

Возвраты:

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

Броски:

IllegalStateException - если ConstantCallSite конструктор не завершился

См. Также:

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

setTarget

public final void setTarget(MethodHandle ignore)

Всегда броски UnsupportedOperationException. Этот вид сайта вызова не может изменить свою цель.

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

setTarget в классе CallSite

Параметры:

ignore - новая цель, предложенная для сайта вызова, который игнорируется

Броски:

UnsupportedOperationException - потому что этот вид сайта вызова не может изменить свою цель

См. Также:

CallSite.getTarget(), setTarget(java.lang.invoke.MethodHandle), MutableCallSite.setTarget(java.lang.invoke.MethodHandle), VolatileCallSite.setTarget(java.lang.invoke.MethodHandle)

dynamicInvoker

public final MethodHandle dynamicInvoker()

Возвраты постоянная цель сайта этого вызова. Так как та цель никогда не будет изменяться, это - корректная реализация CallSite.dynamicInvoker.

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

dynamicInvoker в классе CallSite

Возвраты:

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

Броски:

IllegalStateException - если ConstantCallSite конструктор не завершился