org.graalvm.libgraal

Class LibGraalScope

java.lang.Object

org.graalvm.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 and Description
static class	LibGraalScope.DetachAction Denotes the detach action to perform when closing a LibGraalScope.

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
void	close()
static LibGraalScope	current() Gets the current scope.
int	getDepth() Returns the nesting depth of this LibGraalScope object.
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, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

LibGraalScope

public LibGraalScope()

Shortcut for calling LibGraalScope.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

LibGraalScope

public LibGraalScope(long isolateAddress)

Enters a scope for making calls into an existing libgraal isolate. 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 Detail

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.

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

getDepth

public int getDepth()

Returns the nesting depth of this LibGraalScope object.