Class JNICalls

java.lang.Object

org.graalvm.jniutils.JNICalls

public final class JNICalls
extends Object

Support for calling into HotSpot using JNI. In addition to calling a method using JNI, the JNICalls also perform JNI call tracing and exception handling. All JNI calls into HotSpot must use this support to correctly merge HotSpot and native image stack traces.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	JNICalls.JNIMethod	Represents a JNI method.

Method Summary

Modifier and Type	Method	Description
boolean	callBoolean(JNI.JNIEnv env, JNI.JObject object, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a method returning boolean.
byte	callByte(JNI.JNIEnv env, JNI.JObject object, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a method returning byte.
char	callChar(JNI.JNIEnv env, JNI.JObject object, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a method returning char.
double	callDouble(JNI.JNIEnv env, JNI.JObject object, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a method returning double.
float	callFloat(JNI.JNIEnv env, JNI.JObject object, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a method returning float.
int	callInt(JNI.JNIEnv env, JNI.JObject object, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a method returning int.
<R extends JNI.JObject> R	callJObject(JNI.JNIEnv env, JNI.JObject object, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a method returning Object.
long	callLong(JNI.JNIEnv env, JNI.JObject object, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a method returning long.
<R extends JNI.JObject> R	callNewObject(JNI.JNIEnv env, JNI.JClass clazz, JNICalls.JNIMethod constructor, JNI.JValue args)	Creates a new object instance using a given constructor.
short	callShort(JNI.JNIEnv env, JNI.JObject object, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a method returning short.
boolean	callStaticBoolean(JNI.JNIEnv env, JNI.JClass clazz, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a static method returning boolean.
int	callStaticInt(JNI.JNIEnv env, JNI.JClass clazz, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a static method returning int.
<R extends JNI.JObject> R	callStaticJObject(JNI.JNIEnv env, JNI.JClass clazz, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a static method returning Object.
long	callStaticLong(JNI.JNIEnv env, JNI.JClass clazz, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a static method returning long.
void	callStaticVoid(JNI.JNIEnv env, JNI.JClass clazz, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a static void method.
void	callVoid(JNI.JNIEnv env, JNI.JObject object, JNICalls.JNIMethod method, JNI.JValue args)	Performs a JNI call of a void method.
static JNICalls	createWithExceptionHandler(JNIExceptionWrapper.ExceptionHandler handler)	Creates a new JNICalls instance with a custom exception handler.
static JNICalls	getDefault()	Returns a JNICalls instance with a default exception handler.

Methods inherited from class Object

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

Method Details

getDefault

public static JNICalls getDefault()

Returns a JNICalls instance with a default exception handler. The default exception handler rethrows any pending JNI exception as a JNIExceptionWrapper.

createWithExceptionHandler

public static JNICalls createWithExceptionHandler(JNIExceptionWrapper.ExceptionHandler handler)

Creates a new JNICalls instance with a custom exception handler. The given exception handler is used to handle pending JNI exceptions.

callStaticVoid

public void callStaticVoid(JNI.JNIEnv env,
 JNI.JClass clazz,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a static void method.

callStaticBoolean

public boolean callStaticBoolean(JNI.JNIEnv env,
 JNI.JClass clazz,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a static method returning boolean.

callStaticLong

public long callStaticLong(JNI.JNIEnv env,
 JNI.JClass clazz,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a static method returning long.

callStaticInt

public int callStaticInt(JNI.JNIEnv env,
 JNI.JClass clazz,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a static method returning int.

callStaticJObject

public <R extends JNI.JObject> R callStaticJObject(JNI.JNIEnv env,
 JNI.JClass clazz,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a static method returning Object.

callNewObject

public <R extends JNI.JObject> R callNewObject(JNI.JNIEnv env,
 JNI.JClass clazz,
 JNICalls.JNIMethod constructor,
 JNI.JValue args)

Creates a new object instance using a given constructor.

callVoid

public void callVoid(JNI.JNIEnv env,
 JNI.JObject object,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a void method.

callJObject

public <R extends JNI.JObject> R callJObject(JNI.JNIEnv env,
 JNI.JObject object,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a method returning Object.

callBoolean

public boolean callBoolean(JNI.JNIEnv env,
 JNI.JObject object,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a method returning boolean.

callShort

public short callShort(JNI.JNIEnv env,
 JNI.JObject object,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a method returning short.

callInt

public int callInt(JNI.JNIEnv env,
 JNI.JObject object,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a method returning int.

callLong

public long callLong(JNI.JNIEnv env,
 JNI.JObject object,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a method returning long.

callDouble

public double callDouble(JNI.JNIEnv env,
 JNI.JObject object,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a method returning double.

callFloat

public float callFloat(JNI.JNIEnv env,
 JNI.JObject object,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a method returning float.

callByte

public byte callByte(JNI.JNIEnv env,
 JNI.JObject object,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a method returning byte.

callChar

public char callChar(JNI.JNIEnv env,
 JNI.JObject object,
 JNICalls.JNIMethod method,
 JNI.JValue args)

Performs a JNI call of a method returning char.