程序包 java.lang.invoke

类 ConstantCallSite

java.lang.Object

java.lang.invoke.CallSite

java.lang.invoke.ConstantCallSite

public class ConstantCallSite
extends CallSite

A ConstantCallSite is a CallSite whose target is permanent, and can never be changed. An invokedynamic instruction linked to a ConstantCallSite is permanently bound to the call site's target.

构造器概要

构造器

限定符	构造器	说明
	ConstantCallSite(MethodHandle target)	Creates a call site with a permanent target.
protected	ConstantCallSite(MethodType targetType, MethodHandle createTargetHook)	Creates a call site with a permanent target, possibly bound to the call site itself.

方法概要

限定符和类型	方法	说明
MethodHandle	dynamicInvoker()	Returns this call site's permanent target.
MethodHandle	getTarget()	Returns the target method of the call site, which behaves like a final field of the ConstantCallSite.
void	setTarget(MethodHandle ignore)	Always throws an UnsupportedOperationException.

从类继承的方法 java.lang.invoke.CallSite

type

从类继承的方法 java.lang.Object

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

构造器详细资料

ConstantCallSite

public ConstantCallSite(MethodHandle target)

Creates a call site with a permanent target.

参数:

target - the target to be permanently associated with this call site

抛出:

NullPointerException - if the proposed target is null

ConstantCallSite

protected ConstantCallSite(MethodType targetType,
                           MethodHandle createTargetHook)
                    throws Throwable

Creates a call site with a permanent target, possibly bound to the call site itself.

During construction of the call site, the createTargetHook is invoked to produce the actual target, as if by a call of the form (MethodHandle) createTargetHook.invoke(this).

Note that user code cannot perform such an action directly in a subclass constructor, since the target must be fixed before the ConstantCallSite constructor returns.

The hook is said to bind the call site to a target method handle, and a typical action would be someTarget.bindTo(this). However, the hook is free to take any action whatever, including ignoring the call site and returning a constant target.

The result returned by the hook must be a method handle of exactly the same type as the call site.

While the hook is being called, the new ConstantCallSite object is in a partially constructed state. In this state, a call to getTarget, or any other attempt to use the target, will result in an IllegalStateException. It is legal at all times to obtain the call site's type using the type method.

参数:

targetType - the type of the method handle to be permanently associated with this call site

createTargetHook - a method handle to invoke (on the call site) to produce the call site's target

抛出:

WrongMethodTypeException - if the hook cannot be invoked on the required arguments, or if the target returned by the hook is not of the given targetType

NullPointerException - if the hook returns a null value

ClassCastException - if the hook returns something other than a MethodHandle

Throwable - anything else thrown by the hook function

方法详细资料

getTarget

public final MethodHandle getTarget()

Returns the target method of the call site, which behaves like a final field of the ConstantCallSite. That is, the target is always the original value passed to the constructor call which created this instance.

指定者:

getTarget 在类中 CallSite

返回:

the immutable linkage state of this call site, a constant method handle

抛出:

IllegalStateException - if the ConstantCallSite constructor has not completed

另请参阅:

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

setTarget

public final void setTarget(MethodHandle ignore)

Always throws an UnsupportedOperationException. This kind of call site cannot change its target.

指定者:

setTarget 在类中 CallSite

参数:

ignore - a new target proposed for the call site, which is ignored

抛出:

UnsupportedOperationException - because this kind of call site cannot change its target

另请参阅:

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

dynamicInvoker

public final MethodHandle dynamicInvoker()

Returns this call site's permanent target. Since that target will never change, this is a correct implementation of CallSite#dynamicInvoker.

指定者:

dynamicInvoker 在类中 CallSite

返回:

the immutable linkage state of this call site, a constant method handle

抛出:

IllegalStateException - if the ConstantCallSite constructor has not completed