org.dynalang.dynalink.support

Class RuntimeContextLinkRequestImpl

java.lang.Object

org.dynalang.dynalink.support.LinkRequestImpl

org.dynalang.dynalink.support.RuntimeContextLinkRequestImpl

All Implemented Interfaces:

LinkRequest

public class RuntimeContextLinkRequestImpl
extends LinkRequestImpl

A link request implementation for call sites that pass language runtime specific context arguments on the stack. The context specific arguments should be the first "n" arguments.

Author:

Attila Szegedi

Constructor Summary

Constructors

Constructor and Description
RuntimeContextLinkRequestImpl(CallSiteDescriptor callSiteDescriptor, boolean callSiteUnstable, Object[] arguments, int runtimeContextArgCount) Creates a new link request.

Method Summary

Modifier and Type	Method and Description
LinkRequest	replaceArguments(CallSiteDescriptor callSiteDescriptor, Object[] arguments) Returns a request identical to this one with call site descriptor and arguments replaced with the ones specified.
LinkRequest	withoutRuntimeContext() Returns a request stripped from runtime context arguments.

Methods inherited from class org.dynalang.dynalink.support.LinkRequestImpl

getArguments, getCallSiteDescriptor, getReceiver, isCallSiteUnstable

Methods inherited from class java.lang.Object

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

Constructor Detail

RuntimeContextLinkRequestImpl

public RuntimeContextLinkRequestImpl(CallSiteDescriptor callSiteDescriptor,
                             boolean callSiteUnstable,
                             Object[] arguments,
                             int runtimeContextArgCount)

Creates a new link request.

Parameters:

callSiteDescriptor - the descriptor for the call site being linked

arguments - the arguments for the invocation

callSiteUnstable - true if the call site being linked is considered unstable

runtimeContextArgCount - the number of the leading arguments on the stack that represent the language runtime specific context arguments.

Throws:

IllegalArgumentException - if runtimeContextArgCount is less than 1.

Method Detail

withoutRuntimeContext

public LinkRequest withoutRuntimeContext()

Description copied from interface: LinkRequest

Returns a request stripped from runtime context arguments. Some language runtimes will include runtime-specific context parameters in their call sites as few arguments between 0th argument "this" and the normal arguments. If a linker does not recognize such contexts at all, or does not recognize the call site as one with its own context, it can ask for the alternative link request with context parameters and arguments removed, and link against it instead.

Specified by:

withoutRuntimeContext in interface LinkRequest

Overrides:

withoutRuntimeContext in class LinkRequestImpl

Returns:

the context-stripped request. If the link request does not have any language runtime specific context parameters, the same link request is returned.

replaceArguments

public LinkRequest replaceArguments(CallSiteDescriptor callSiteDescriptor,
                           Object[] arguments)

Description copied from interface: LinkRequest

Returns a request identical to this one with call site descriptor and arguments replaced with the ones specified.

Specified by:

replaceArguments in interface LinkRequest

Overrides:

replaceArguments in class LinkRequestImpl

Parameters:

callSiteDescriptor - the new call site descriptor

arguments - the new arguments

Returns:

a new request identical to this one, except with the call site descriptor and arguments replaced with the specified ones.