org.graalvm.nativebridge

Class JNIClassCache

java.lang.Object

org.graalvm.nativebridge.JNIClassCache

public final class JNIClassCache
extends Object

Support class for JNI.JClass lookup. JClass instances are cached as JNI globals. The cached JNI globals are disposed by JNIClassCache#dispose(JNIEnv).

Method Summary

Modifier and Type	Method and Description
static void	dispose(JNI.JNIEnv jniEnv) Disposes cached JNI objects and frees JNI globals.
static JNI.JClass	lookupClass(JNI.JNIEnv env, Class<?> clazz) Looks up JClass using a Class.
static JNI.JClass	lookupClass(JNI.JNIEnv env, String className) Looks up JClass using a fully qualified name.
static JNI.JClass	lookupOptionalClass(JNI.JNIEnv env, Class<?> clazz) Looks up JClass using a Class.
static JNI.JClass	lookupOptionalClass(JNI.JNIEnv env, String className) Looks up JClass using a fully qualified name.

Methods inherited from class java.lang.Object

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

Method Detail

lookupClass

public static JNI.JClass lookupClass(JNI.JNIEnv env,
                                     Class<?> clazz)
                              throws JNIExceptionWrapper

Looks up JClass using a Class.

Returns:

JNI global reference for JNI.JClass

Throws:

JNIExceptionWrapper - wrapping the HotSpot LinkageError is thrown when class is not found.

lookupClass

public static JNI.JClass lookupClass(JNI.JNIEnv env,
                                     String className)
                              throws JNIExceptionWrapper

Looks up JClass using a fully qualified name.

Returns:

JNI global reference for JNI.JClass

Throws:

JNIExceptionWrapper - wrapping the HotSpot LinkageError is thrown when class is not found.

lookupOptionalClass

public static JNI.JClass lookupOptionalClass(JNI.JNIEnv env,
                                             Class<?> clazz)

Looks up JClass using a Class.

Returns:

JNI global reference for JNI.JClass or NULL when class is not found.

lookupOptionalClass

public static JNI.JClass lookupOptionalClass(JNI.JNIEnv env,
                                             String className)

Looks up JClass using a fully qualified name.

Returns:

JNI global reference for JNI.JClass or NULL when class is not found.

dispose

public static void dispose(JNI.JNIEnv jniEnv)

Disposes cached JNI objects and frees JNI globals. The isolate should call this method before disposing to free host classes held by JNI global references.