Class LibGraalScope

java.lang.Object

com.oracle.truffle.runtime.hotspot.libgraal.LibGraalScope

All Implemented Interfaces:

AutoCloseable

public final class LibGraalScope
extends Object
implements AutoCloseable

Scope for calling CEntryPoints in libgraal. Opening a scope ensures the current thread is attached to libgraal and closing the outer most scope detaches the current thread.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	LibGraalScope.DetachAction	Denotes the detach action to perform when closing a LibGraalScope.

Constructor Summary

Constructors

Constructor	Description
LibGraalScope()	Shortcut for calling LibGraalScope(DetachAction) with an argument of LibGraalScope.DetachAction.DETACH_RUNTIME.
LibGraalScope(LibGraalScope.DetachAction detachAction)	Enters a scope for making calls into libgraal.

Method Summary

Modifier and Type	Method	Description
void	close()
static LibGraalScope	current()	Gets the current scope.
LibGraalIsolate	getIsolate()	Gets the isolate associated with this scope.
static long	getIsolateThread()	Gets the isolate thread associated with the current thread.
long	getIsolateThreadAddress()	Gets the address of the isolate thread associated with this scope.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Details

LibGraalScope

public LibGraalScope()

Shortcut for calling LibGraalScope(DetachAction) with an argument of LibGraalScope.DetachAction.DETACH_RUNTIME.

LibGraalScope

public LibGraalScope(LibGraalScope.DetachAction detachAction)

Enters a scope for making calls into libgraal. If there is no existing libgraal scope for the current thread, the current thread is attached to libgraal. When the outer most scope is closed, the current thread is detached from libgraal. This must be used in a try-with-resources statement. This cannot be called from within libgraal.

Throws:

IllegalStateException - if libgraal is unavailable or LibGraal.inLibGraal() returns true

Method Details

current

public static LibGraalScope current()

Gets the current scope.

Throws:

IllegalStateException - if the current thread is not in an opened scope

getIsolateThread

public static long getIsolateThread()

Gets the isolate thread associated with the current thread. The current thread must be in an opened scope.

Returns:

a value that can be used for the IsolateThreadContext argument of a native method linked to a CEntryPoint function in libgraal

Throws:

IllegalStateException - if the current thread is not attached to libgraal

toString

public String toString()

Overrides:

toString in class Object

getIsolate

public LibGraalIsolate getIsolate()

Gets the isolate associated with this scope.

getIsolateThreadAddress

public long getIsolateThreadAddress()

Gets the address of the isolate thread associated with this scope.

close

public void close()

Specified by:

close in interface AutoCloseable