com.oracle.svm.truffle.api

Class SubstrateOptimizedCallTargetInstalledCode

java.lang.Object

jdk.vm.ci.code.InstalledCode

com.oracle.svm.truffle.api.SubstrateOptimizedCallTargetInstalledCode

All Implemented Interfaces:

SubstrateInstalledCode, org.graalvm.compiler.truffle.common.OptimizedAssumptionDependency

public class SubstrateOptimizedCallTargetInstalledCode
extends jdk.vm.ci.code.InstalledCode
implements SubstrateInstalledCode, org.graalvm.compiler.truffle.common.OptimizedAssumptionDependency

Represents the compiled code of a SubstrateOptimizedCallTarget.

Assume that methods return stale values because internal state can change at any safepoint (see SubstrateInstalledCode).

Nested Class Summary

Nested classes/interfaces inherited from interface com.oracle.svm.core.deopt.SubstrateInstalledCode

SubstrateInstalledCode.Factory

Nested classes/interfaces inherited from interface org.graalvm.compiler.truffle.common.OptimizedAssumptionDependency

org.graalvm.compiler.truffle.common.OptimizedAssumptionDependency.Access

Field Summary

Fields

Modifier and Type	Field and Description
protected SubstrateOptimizedCallTarget	callTarget

Fields inherited from class jdk.vm.ci.code.InstalledCode

address, entryPoint, name, version

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SubstrateOptimizedCallTargetInstalledCode(SubstrateOptimizedCallTarget callTarget)

Method Summary

Modifier and Type	Method and Description
void	clearAddress() This method is called during code uninstallation.
Object	executeVarargs(Object... args)
byte[]	getCode()
org.graalvm.compiler.truffle.common.CompilableTruffleAST	getCompilable()
jdk.vm.ci.meta.ResolvedJavaMethod	getMethod() Returns the last method object passed to SubstrateInstalledCode.setAddress(long, jdk.vm.ci.meta.ResolvedJavaMethod).
String	getName()
SubstrateSpeculationLog	getSpeculationLog()
long	getStart()
void	invalidate() Invalidates this installed code and deoptimizes all live invocations, after which both SubstrateInstalledCode.isValid() and SubstrateInstalledCode.isAlive() return false.
void	invalidateWithoutDeoptimization() Make this code non-entrant, but let live invocations continue execution.
boolean	isValid() Returns false if not valid, including if previously invalidated without deoptimization in which case there can still be live activations.
void	onAssumptionInvalidated(Object source, CharSequence reason)
void	setAddress(long address, jdk.vm.ci.meta.ResolvedJavaMethod method) Called during code installation: initialize this instance with the given address where its instructions are, and the method it was compiled from.
void	setCompilationId(org.graalvm.compiler.core.common.CompilationIdentifier id) Sets the identifier of the compilation that resulted in this code, which can be used to provide additional information in SubstrateInstalledCode.getName().

Methods inherited from class jdk.vm.ci.code.InstalledCode

getAddress, getEntryPoint, getVersion, isAlive

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.oracle.svm.core.deopt.SubstrateInstalledCode

getAddress, getEntryPoint, isAlive

Methods inherited from interface org.graalvm.compiler.truffle.common.OptimizedAssumptionDependency

soleExecutionEntryPoint

Field Detail

callTarget

protected final SubstrateOptimizedCallTarget callTarget

Constructor Detail

SubstrateOptimizedCallTargetInstalledCode

protected SubstrateOptimizedCallTargetInstalledCode(SubstrateOptimizedCallTarget callTarget)

Method Detail

invalidate

public final void invalidate()

Description copied from interface: SubstrateInstalledCode

Invalidates this installed code and deoptimizes all live invocations, after which both SubstrateInstalledCode.isValid() and SubstrateInstalledCode.isAlive() return false.

Specified by:

invalidate in interface SubstrateInstalledCode

Overrides:

invalidate in class jdk.vm.ci.code.InstalledCode

onAssumptionInvalidated

public void onAssumptionInvalidated(Object source,
                                    CharSequence reason)

Specified by:

onAssumptionInvalidated in interface org.graalvm.compiler.truffle.common.OptimizedAssumptionDependency

isValid

public boolean isValid()

Returns false if not valid, including if previously invalidated without deoptimization in which case there can still be live activations. In order to entirely invalidate code in such cases, SubstrateOptimizedCallTargetInstalledCode.invalidate() must still be called even when this method returns false.

Specified by:

isValid in interface SubstrateInstalledCode

Specified by:

isValid in interface org.graalvm.compiler.truffle.common.OptimizedAssumptionDependency

Overrides:

isValid in class jdk.vm.ci.code.InstalledCode

getCompilable

public org.graalvm.compiler.truffle.common.CompilableTruffleAST getCompilable()

Specified by:

getCompilable in interface org.graalvm.compiler.truffle.common.OptimizedAssumptionDependency

getSpeculationLog

public SubstrateSpeculationLog getSpeculationLog()

Specified by:

getSpeculationLog in interface SubstrateInstalledCode

setCompilationId

public void setCompilationId(org.graalvm.compiler.core.common.CompilationIdentifier id)

Description copied from interface: SubstrateInstalledCode

Sets the identifier of the compilation that resulted in this code, which can be used to provide additional information in SubstrateInstalledCode.getName().

Specified by:

setCompilationId in interface SubstrateInstalledCode

getName

public String getName()

Specified by:

getName in interface SubstrateInstalledCode

Overrides:

getName in class jdk.vm.ci.code.InstalledCode

getMethod

public jdk.vm.ci.meta.ResolvedJavaMethod getMethod()

Description copied from interface: SubstrateInstalledCode

Returns the last method object passed to SubstrateInstalledCode.setAddress(long, jdk.vm.ci.meta.ResolvedJavaMethod). The return value might be passed as the argument to future calls to SubstrateInstalledCode.setAddress(long, jdk.vm.ci.meta.ResolvedJavaMethod).

May return null if the subclass does not have a use for the method object (also not in SubstrateInstalledCode.setAddress(long, jdk.vm.ci.meta.ResolvedJavaMethod)) and therefore no need to retain it. Expected to return null if SubstrateInstalledCode.setAddress(long, jdk.vm.ci.meta.ResolvedJavaMethod) has never been called, or after SubstrateInstalledCode.clearAddress() has been called.

Specified by:

getMethod in interface SubstrateInstalledCode

setAddress

public void setAddress(long address,
                       jdk.vm.ci.meta.ResolvedJavaMethod method)

Description copied from interface: SubstrateInstalledCode

Called during code installation: initialize this instance with the given address where its instructions are, and the method it was compiled from. Afterwards, SubstrateInstalledCode.getAddress() and SubstrateInstalledCode.getEntryPoint() return the given address, and SubstrateInstalledCode.isValid() and SubstrateInstalledCode.isAlive() return true.

Specified by:

setAddress in interface SubstrateInstalledCode

clearAddress

public void clearAddress()

Description copied from interface: SubstrateInstalledCode

This method is called during code uninstallation. Consider SubstrateInstalledCode.invalidate() instead.

Reset this instance so that SubstrateInstalledCode.getAddress() and SubstrateInstalledCode.getEntryPoint() return 0, and SubstrateInstalledCode.isValid() and SubstrateInstalledCode.isAlive() return false.

Specified by:

clearAddress in interface SubstrateInstalledCode

invalidateWithoutDeoptimization

public void invalidateWithoutDeoptimization()

Description copied from interface: SubstrateInstalledCode

Make this code non-entrant, but let live invocations continue execution. Afterwards, SubstrateInstalledCode.isValid() returns false, SubstrateInstalledCode.isAlive() returns true, and SubstrateInstalledCode.getEntryPoint() returns 0.

Specified by:

invalidateWithoutDeoptimization in interface SubstrateInstalledCode

getStart

public long getStart()

Overrides:

getStart in class jdk.vm.ci.code.InstalledCode

getCode

public byte[] getCode()

Overrides:

getCode in class jdk.vm.ci.code.InstalledCode

executeVarargs

public Object executeVarargs(Object... args)

Overrides:

executeVarargs in class jdk.vm.ci.code.InstalledCode