jdk.internal.jvmci.code.stack

Interface StackIntrospection

All Known Subinterfaces:

HotSpotGraalRuntimeProvider

All Known Implementing Classes:

HotSpotGraalRuntime

public interface StackIntrospection

Method Summary

Modifier and Type	Method and Description
<T> T	iterateFrames(ResolvedJavaMethod[] initialMethods, ResolvedJavaMethod[] matchingMethods, int initialSkip, InspectedFrameVisitor<T> visitor) Accesses the current stack, providing InspectedFrames to the visitor that can be used to inspect the stack frames' contents.

Method Detail

iterateFrames

<T> T iterateFrames(ResolvedJavaMethod[] initialMethods,
                    ResolvedJavaMethod[] matchingMethods,
                    int initialSkip,
                    InspectedFrameVisitor<T> visitor)

Accesses the current stack, providing InspectedFrames to the visitor that can be used to inspect the stack frames' contents. Iteration continues as long as InspectedFrameVisitor.visitFrame(jdk.internal.jvmci.code.stack.InspectedFrame), which is invoked for every InspectedFrame, returns null. Any non-null result of the visitor indicates that frame iteration should stop.

Parameters:

initialMethods - if this is non-null, then the stack trace will start at these methods

matchingMethods - if this is non-null, then only matching stack frames are returned

initialSkip - the number of matching methods to skip (including the initial method)

visitor - the visitor that is called for every matching method

Returns:

the last result returned by the visitor (which is non-null to indicate that iteration should stop), or null if the whole stack was iterated.