com.oracle.truffle.api.instrumentation

Interface ExecutionEventListener

public interface ExecutionEventListener

A listener attached by an Instrumenter to specific locations of a guest language program to listen to execution events.

Since:

0.12

Method Summary

Modifier and Type	Method and Description
void	onEnter(EventContext context, VirtualFrame frame) Invoked immediately before the instrumented node is executed.
void	onReturnExceptional(EventContext context, VirtualFrame frame, Throwable exception) Invoked immediately after an instrumented node did not successfully execute.
void	onReturnValue(EventContext context, VirtualFrame frame, Object result) Invoked immediately after an instrumented node is successfully executed.

Method Detail

onEnter

void onEnter(EventContext context,
             VirtualFrame frame)

Invoked immediately before the instrumented node is executed. The order in which multiple event listeners are notified matches the order they are attached .

Parameters:

context - indicating the current location in the guest language AST

frame - the frame that was used for executing instrumented node

Since:

0.12

onReturnValue

void onReturnValue(EventContext context,
                   VirtualFrame frame,
                   Object result)

Invoked immediately after an instrumented node is successfully executed. The order in which multiple event listeners are notified matches the order they are attached.

Parameters:

context - indicating the current location in the guest language AST

frame - the frame that was used for executing instrumented node

Since:

0.12

onReturnExceptional

void onReturnExceptional(EventContext context,
                         VirtualFrame frame,
                         Throwable exception)

Invoked immediately after an instrumented node did not successfully execute. The order in which multiple event listeners are notified matches the order they are attached.

Parameters:

context - indicating the current location in the guest language AST

frame - the frame that was used for executing instrumented node

Since:

0.12