com.oracle.truffle.api.instrumentation

Interface ThreadsListener

public interface ThreadsListener

Listener to be notified about changes of threads in guest language application.

Use Instrumenter.attachThreadsListener(com.oracle.truffle.api.instrumentation.ThreadsListener, boolean) to register an implementation of this listener. Use EventBinding.dispose() to unregister.

The listener gets called when a thread is initialized for use in a context or thread-related resources are disposed in a context. The notification calls do not say anything about the actual life-time of the thread as such, which may live before the initialization and may continue to live after the disposal.

Since:

0.30

See Also:

Instrumenter.attachThreadsListener(com.oracle.truffle.api.instrumentation.ThreadsListener, boolean)

Method Summary

Modifier and Type	Method and Description
void	onThreadDisposed(TruffleContext context, Thread thread) Notifies about disposal of thread-related resources that were used for a guest language execution in a TruffleContext.
void	onThreadInitialized(TruffleContext context, Thread thread) Notifies about initialization of a thread to be used for a guest language execution in a TruffleContext.

Method Detail

onThreadInitialized

void onThreadInitialized(TruffleContext context,
                         Thread thread)

Notifies about initialization of a thread to be used for a guest language execution in a TruffleContext. If this method throws an AbstractTruffleException the exception interop messages may be executed without a context being entered.

Parameters:

context - the context the thread is initialized in

thread - the initialized thread

Since:

0.30

onThreadDisposed

void onThreadDisposed(TruffleContext context,
                      Thread thread)

Notifies about disposal of thread-related resources that were used for a guest language execution in a TruffleContext.

Parameters:

context - the context the thread is disposed from

thread - the thread

Since:

0.30