org.graalvm.jniutils

Class JNIMethodScope

java.lang.Object

org.graalvm.jniutils.JNIMethodScope

All Implemented Interfaces:

AutoCloseable

public class JNIMethodScope
extends Object
implements AutoCloseable

Scope of a call from HotSpot to native method. This also provides access to the JNI.JNIEnv value for the current thread within the native method call. If the native method call returns a non-primitive value, the return value must be set within the try-with-resources statement and then retrieved and returned outside the try-with-resources statement. This is necessary to support use of JNI local frames.

Constructor Summary

Constructors

Constructor and Description
JNIMethodScope(String scopeName, JNI.JNIEnv env) Enters the scope of an native method call.

Method Summary

Modifier and Type	Method and Description
void	close()
static JNI.JNIEnv	env() Gets the JNI.JNIEnv value for the current thread.
JNI.JNIEnv	getEnv()
<R extends JNI.JObject> R	getObjectResult()
static JNIMethodScope	scope() Gets the inner most JNIMethodScope value for the current thread.
static JNIMethodScope	scopeOrNull() Gets the inner most JNIMethodScope value for the current thread.
void	setObjectResult(JNI.JObject obj)
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

JNIMethodScope

public JNIMethodScope(String scopeName,
                      JNI.JNIEnv env)

Enters the scope of an native method call.

Method Detail

env

public static JNI.JNIEnv env()

Gets the JNI.JNIEnv value for the current thread.

getEnv

public JNI.JNIEnv getEnv()

scopeOrNull

public static JNIMethodScope scopeOrNull()

Gets the inner most JNIMethodScope value for the current thread.

scope

public static JNIMethodScope scope()

Gets the inner most JNIMethodScope value for the current thread.

setObjectResult

public void setObjectResult(JNI.JObject obj)

getObjectResult

public <R extends JNI.JObject> R getObjectResult()

close

public void close()

Specified by:

close in interface AutoCloseable

toString

public String toString()

Overrides:

toString in class Object