org.graalvm.jniutils

Class JNIExceptionWrapper

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.graalvm.jniutils.JNIExceptionWrapper

All Implemented Interfaces:

Serializable

public final class JNIExceptionWrapper
extends RuntimeException

Wraps an exception thrown by a JNI call into HotSpot. If the exception propagates up to an native image entry point, the exception is re-thrown in HotSpot.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	JNIExceptionWrapper.ExceptionHandler
static class	JNIExceptionWrapper.ExceptionHandlerContext Context for JNIExceptionWrapper.ExceptionHandler.

Method Summary

Modifier and Type	Method and Description
static JNI.JThrowable	createHSException(JNI.JNIEnv env, Throwable original) Crates an exception in HotSpot representing the given original exception.
static JNIExceptionWrapper	forHSException(JNI.JNIEnv env, JNI.JThrowable jThrowable) Creates a new JNIExceptionWrapper for given HotSpot exception.
static StackTraceElement[]	mergeStackTraces(StackTraceElement[] hotSpotStackTrace, StackTraceElement[] nativeStackTrace, boolean originatedInHotSpot)
static void	throwInHotSpot(JNI.JNIEnv env, Throwable original) Throws an exception into HotSpot.
static void	wrapAndThrowPendingJNIException(JNI.JNIEnv env) If there is a pending JNI exception, this method wraps it in a JNIExceptionWrapper, clears the pending exception and throws the JNIExceptionWrapper wrapper.
static void	wrapAndThrowPendingJNIException(JNI.JNIEnv env, JNIExceptionWrapper.ExceptionHandler exceptionHandler) If there is a pending JNI exception, this method wraps it in a JNIExceptionWrapper, clears the pending exception and throws the JNIExceptionWrapper wrapper.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Method Detail

wrapAndThrowPendingJNIException

public static void wrapAndThrowPendingJNIException(JNI.JNIEnv env)

If there is a pending JNI exception, this method wraps it in a JNIExceptionWrapper, clears the pending exception and throws the JNIExceptionWrapper wrapper. The JNIExceptionWrapper message is composed of the JNI exception class name and the JNI exception message. For exception filtering or custom handling of JNI exceptions see #wrapAndThrowPendingJNIException(JNIEnv, ExceptionHandler).

wrapAndThrowPendingJNIException

public static void wrapAndThrowPendingJNIException(JNI.JNIEnv env,
                                                   JNIExceptionWrapper.ExceptionHandler exceptionHandler)

If there is a pending JNI exception, this method wraps it in a JNIExceptionWrapper, clears the pending exception and throws the JNIExceptionWrapper wrapper. The JNIExceptionWrapper message is composed of the JNI exception class name and the JNI exception message.

See Also:

JNIExceptionWrapper.ExceptionHandler

throwInHotSpot

public static void throwInHotSpot(JNI.JNIEnv env,
                                  Throwable original)

Throws an exception into HotSpot. If original is a JNIExceptionWrapper the wrapped JNI exception is thrown. Otherwise a new RuntimeException is thrown. The RuntimeException message is composed of original.getClass().getName() and original.getMessage(). The stack trace is result of merging the original.getStackTrace() with the current execution stack in HotSpot.

Parameters:

env - the JNI.JNIEnv

original - an exception to be thrown in HotSpot

createHSException

public static JNI.JThrowable createHSException(JNI.JNIEnv env,
                                               Throwable original)

Crates an exception in HotSpot representing the given original exception.

Parameters:

env - the JNI.JNIEnv

original - an exception to be created in HotSpot

forHSException

public static JNIExceptionWrapper forHSException(JNI.JNIEnv env,
                                                 JNI.JThrowable jThrowable)

Creates a new JNIExceptionWrapper for given HotSpot exception.

mergeStackTraces

public static StackTraceElement[] mergeStackTraces(StackTraceElement[] hotSpotStackTrace,
                                                   StackTraceElement[] nativeStackTrace,
                                                   boolean originatedInHotSpot)