org.dynalang.dynalink.support

Class LinkRequestImpl

java.lang.Object

org.dynalang.dynalink.support.LinkRequestImpl

All Implemented Interfaces:

LinkRequest

Direct Known Subclasses:

RuntimeContextLinkRequestImpl

public class LinkRequestImpl
extends Object
implements LinkRequest

Default implementation of the LinkRequest, representing a link request to a call site that passes no language runtime specific native context arguments on the stack.

Author:

Attila Szegedi

Constructor Summary

Constructors

Constructor and Description
LinkRequestImpl(CallSiteDescriptor callSiteDescriptor, boolean callSiteUnstable, Object... arguments) Creates a new link request.

Method Summary

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.
boolean	isCallSiteUnstable() Returns true if the call site is considered unstable, that is, it has been relinked more times than was specified in DynamicLinkerFactory.setUnstableRelinkThreshold(int).
LinkRequest	replaceArguments(CallSiteDescriptor newCallSiteDescriptor, Object[] newArguments) 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 java.lang.Object

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

Constructor Detail

LinkRequestImpl

public LinkRequestImpl(CallSiteDescriptor callSiteDescriptor,
               boolean callSiteUnstable,
               Object... arguments)

Creates a new link request.

Parameters:

callSiteDescriptor - the descriptor for the call site being linked

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

arguments - the arguments for the invocation

Method Detail

getArguments

public Object[] getArguments()

Description copied from interface: LinkRequest

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.

Specified by:

getArguments in interface LinkRequest

Returns:

the arguments for the invocation being linked.

getReceiver

public Object getReceiver()

Description copied from interface: LinkRequest

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

Specified by:

getReceiver in interface LinkRequest

Returns:

the receiver object.

getCallSiteDescriptor

public CallSiteDescriptor getCallSiteDescriptor()

Description copied from interface: LinkRequest

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

Specified by:

getCallSiteDescriptor in interface LinkRequest

Returns:

the call site descriptor for the call site being linked.

isCallSiteUnstable

public boolean isCallSiteUnstable()

Description copied from interface: LinkRequest

Returns true if the call site is considered unstable, that is, it has been relinked more times than was specified in DynamicLinkerFactory.setUnstableRelinkThreshold(int). Linkers should use this as a hint to prefer producing linkage that is more stable (its guard fails less frequently), even if that assumption causes a less effective version of an operation to be linked. This is just a hint, of course, and linkers are free to ignore this property.

Specified by:

isCallSiteUnstable in interface LinkRequest

Returns:

true if the call site is considered unstable.

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

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 newCallSiteDescriptor,
                           Object[] newArguments)

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

Parameters:

newCallSiteDescriptor - the new call site descriptor

newArguments - the new arguments

Returns:

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