com.oracle.truffle.api.instrumentation

Class EventContext

java.lang.Object

com.oracle.truffle.api.instrumentation.EventContext

public final class EventContext
extends Object

Represents the context of an instrumentation event. Instances of EventContext should be neither stored, cached nor hashed. One exception is when they are stored in ExecutionEventNode implementations. The equality and hashing behavior is undefined.

Since:

0.12

See Also:

ExecutionEventNodeFactory, ExecutionEventListener

Method Summary

Modifier and Type	Method and Description
Node	getInstrumentedNode() Accessor to the instrumented node at which the event occurred.
SourceSection	getInstrumentedSourceSection() Returns the SourceSection that is being instrumented.
boolean	isLanguageContextInitialized() Test if language context of the source of the event is initialized.
ExecutionEventNode	lookupExecutionEventNode(EventBinding<? extends ExecutionEventNodeFactory> binding) Returns the execution event node that was inserted at this location given an event binding.
CallTarget	parseInContext(Source source, String... argumentNames) Evaluates source of (potentially different) language using the current context.
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

getInstrumentedSourceSection

public SourceSection getInstrumentedSourceSection()

Returns the SourceSection that is being instrumented. The returned source section is final for each EventContext instance.

Performance note: this is method may be invoked in compiled code and is guaranteed to always return a compilation constant .

Since:

0.12

getInstrumentedNode

public Node getInstrumentedNode()

Accessor to the instrumented node at which the event occurred. The returned AST must not be mutated by the user.

Performance note: this is method may be invoked in compiled code and is guaranteed to always return a compilation constant .

Since:

0.12

isLanguageContextInitialized

public boolean isLanguageContextInitialized()

Test if language context of the source of the event is initialized.

Since:

0.26

parseInContext

public CallTarget parseInContext(Source source,
                                 String... argumentNames)
                          throws IOException

Evaluates source of (potentially different) language using the current context. The names of arguments are parameters for the resulting {#link CallTarget} that allow the source to reference the actual parameters passed to CallTarget.call(java.lang.Object...).

Parameters:

source - the source to evaluate

argumentNames - the names of CallTarget.call(java.lang.Object...) arguments that can be referenced from the source

Returns:

the call target representing the parsed result

Throws:

IOException - if the parsing or evaluation fails for some reason

Since:

0.12

lookupExecutionEventNode

public ExecutionEventNode lookupExecutionEventNode(EventBinding<? extends ExecutionEventNodeFactory> binding)

Returns the execution event node that was inserted at this location given an event binding. This is useful to disambiguate multiple bindings from each other when installed at the same source location.

Parameters:

binding - the binding to lookup

Since:

0.17

toString

public String toString()

Overrides:

toString in class Object

Since:

0.12