RelinkableCallSite
ChainedCallSite
, SimpleRelinkableCallSite
public abstract class AbstractRelinkableCallSite extends MutableCallSite implements RelinkableCallSite
RelinkableCallSite
as a MutableCallSite
. It carries a CallSiteDescriptor
passed in the constructor and provides the correct implementation of the initialize(MethodHandle)
method. Subclasses must provide RelinkableCallSite.relink(GuardedInvocation, MethodHandle)
and RelinkableCallSite.resetAndRelink(GuardedInvocation, MethodHandle)
methods.Modifier | Constructor | Description |
---|---|---|
protected |
Creates a new abstract relinkable call site. |
Modifier and Type | Method | Description |
---|---|---|
CallSiteDescriptor |
getDescriptor() |
Returns the descriptor for this call site. |
void |
initialize |
Invoked by dynamic linker to initialize the relinkable call site by setting a relink-and-invoke method handle. |
dynamicInvoker, getTarget, setTarget, syncAll
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
relink, resetAndRelink
protected AbstractRelinkableCallSite(CallSiteDescriptor descriptor)
descriptor
- the descriptor for this call site that will be returned from getDescriptor()
. The call site's CallSite.type()
will be equal to descriptor's CallSiteDescriptor.getMethodType()
.NullPointerException
- if descriptor
is null.public CallSiteDescriptor getDescriptor()
RelinkableCallSite
getDescriptor
in interface RelinkableCallSite
public void initialize(MethodHandle relinkAndInvoke)
RelinkableCallSite
CallSite.setTarget(MethodHandle)
. Relink-and-invoke is the initial method handle set by DynamicLinker.link(RelinkableCallSite)
that will cause the call site to be relinked to an appropriate target on its first invocation based on its arguments, and that linked target will then be invoked (hence the name). This linking protocol effectively delays linking until the call site is invoked with actual arguments and thus ensures that linkers can make nuanced linking decisions based on those arguments and not just on the static method type of the call site.initialize
in interface RelinkableCallSite
relinkAndInvoke
- a relink-and-invoke method handle supplied by Dynalink.
© 1993, 2023, 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/21/docs/api/jdk.dynalink/jdk/dynalink/support/AbstractRelinkableCallSite.html