com.oracle.truffle.api.instrumentation

Class EventBinding<T>

java.lang.Object

com.oracle.truffle.api.instrumentation.EventBinding<T>

Type Parameters:

T - subscriber type: ExecutionEventListener or ExecutionEventNodeFactory.

public final class EventBinding<T>
extends Object

An instrumentation handle for a subscription to a filtered stream of execution event notifications.

The subscription remains active until:

• explicit disposal of the subscription; or
• the instrument that created the subscription is disabled; or
• the instrumented engine is disposed.

Since:

0.12

See Also:

Instrumenter.attachListener(SourceSectionFilter, ExecutionEventListener), Instrumenter.attachFactory(SourceSectionFilter, ExecutionEventNodeFactory)

Method Summary

Modifier and Type	Method and Description
void	dispose() Cancels the subscription permanently.
T	getElement()
SourceSectionFilter	getFilter()
boolean	isDisposed()

Methods inherited from class java.lang.Object

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

Method Detail

getElement

public T getElement()

Returns:

the subscriber: an ExecutionEventNodeFactory or ExecutionEventListener.

Since:

0.12

getFilter

public SourceSectionFilter getFilter()

Returns:

the filter being applied to the subscription's stream of notifications

Since:

0.12

isDisposed

public boolean isDisposed()

Returns:

whether the subscription has been permanently cancelled.

Since:

0.12

dispose

public void dispose()
             throws IllegalStateException

Cancels the subscription permanently.

Throws:

IllegalStateException

Since:

0.12