com.oracle.truffle.api.instrumentation

Interface ContextsListener

public interface ContextsListener

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

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

The listener gets called when a new context is created or disposed and when individual languages are initialized or disposed in that context.

Since:

0.30

See Also:

Instrumenter.attachContextsListener(com.oracle.truffle.api.instrumentation.ContextsListener, boolean)

Method Summary

Modifier and Type	Method and Description
void	onContextClosed(TruffleContext context) Notifies about close of a polyglot context.
void	onContextCreated(TruffleContext context) Notifies about creation of a new polyglot context.
void	onLanguageContextCreated(TruffleContext context, LanguageInfo language) Notifies about creation of a language-specific context in an existing polyglot context.
void	onLanguageContextDisposed(TruffleContext context, LanguageInfo language) Notifies about disposal of a language-specific context in an existing polyglot context.
void	onLanguageContextFinalized(TruffleContext context, LanguageInfo language) Notifies about finalization of a language-specific context in an existing polyglot context.
void	onLanguageContextInitialized(TruffleContext context, LanguageInfo language) Notifies about initialization of a language-specific context in an existing polyglot context.

Method Detail

onContextCreated

void onContextCreated(TruffleContext context)

Notifies about creation of a new polyglot context.

Since:

0.30

onLanguageContextCreated

void onLanguageContextCreated(TruffleContext context,
                              LanguageInfo language)

Notifies about creation of a language-specific context in an existing polyglot context.

Parameters:

context - the polyglot context

language - the language for which a language-specific context was created

Since:

0.30

onLanguageContextInitialized

void onLanguageContextInitialized(TruffleContext context,
                                  LanguageInfo language)

Notifies about initialization of a language-specific context in an existing polyglot context.

Parameters:

context - the polyglot context

language - the language for which a language-specific context was initialized

Since:

0.30

onLanguageContextFinalized

void onLanguageContextFinalized(TruffleContext context,
                                LanguageInfo language)

Notifies about finalization of a language-specific context in an existing polyglot context.

Parameters:

context - the polyglot context

language - the language for which a language-specific context was finalized

Since:

0.30

onLanguageContextDisposed

void onLanguageContextDisposed(TruffleContext context,
                               LanguageInfo language)

Notifies about disposal of a language-specific context in an existing polyglot context.

Parameters:

context - the polyglot context

language - the language for which a language-specific context was disposed

Since:

0.30

onContextClosed

void onContextClosed(TruffleContext context)

Notifies about close of a polyglot context.

Since:

0.30