LinkRequest (Java SE 15 & JDK 15) (original) (raw)

All Known Implementing Classes:

[SimpleLinkRequest](support/SimpleLinkRequest.html "class in jdk.dynalink.linker.support")

public interface LinkRequest

Represents a request to link a particular invocation at a particular call site. Instances of these requests will be constructed and passed to allGuardingDynamicLinker objects managed by the DynamicLinker that is trying to link the call site.

• Method Summary

• Method Details

  • getCallSiteDescriptor

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

  • getArguments

  Returns the arguments for the invocation being linked. The returned array must be a clone; modifications to it must not affect the arguments in this request.
  Returns:
  the arguments for the invocation being linked.

  • getReceiver

  Returns the first argument for the invocation being linked; this is typically the receiver object. This is a shorthand forgetArguments()[0] that also avoids the cloning of the arguments array.
  Returns:
  the receiver object.

  • isCallSiteUnstable

  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). 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, though, and linkers are allowed to ignore this property.
  Returns:
  true if the call site is considered unstable.

  • replaceArguments

  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.