org.dynalang.dynalink.linker

Interface LinkRequest

All Known Implementing Classes:

LinkRequestImpl, RuntimeContextLinkRequestImpl

public interface LinkRequest

Represents a request to link a particular invocation at a particular call site. Instances of these requests are being passed to GuardingDynamicLinker.

Author:

Attila Szegedi

Method Summary

Methods

Modifier and Type	Method and Description
Object[]	getArguments() Returns the arguments for the invocation being linked.
CallSiteDescriptor	getCallSiteDescriptor() Returns the call site descriptor for the call site being linked.
Object	getReceiver() Returns the 0th argument for the invocation being linked; this is typically the receiver object.
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.

Method Detail

getCallSiteDescriptor

CallSiteDescriptor getCallSiteDescriptor()

Returns the call site descriptor for the call site being linked.

Returns:

the call site descriptor for the call site being linked.

getArguments

Object[] getArguments()

Returns the arguments for the invocation being linked. The returned array is a clone; modifications to it won't affect the arguments in this request.

Returns:

the arguments for the invocation being linked.

getReceiver

Object getReceiver()

Returns the 0th argument for the invocation being linked; this is typically the receiver object.

Returns:

the receiver object.

withoutRuntimeContext

LinkRequest withoutRuntimeContext()

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.

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

LinkRequest replaceArguments(CallSiteDescriptor callSiteDescriptor,
                           Object[] arguments)

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

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.