Modifier and Type	Class and Description
public static interface	JNIExceptionWrapper.ExceptionHandler
public static class	JNIExceptionWrapper.ExceptionHandlerContext Context for `ExceptionHandler`.
private static class	JNIExceptionWrapper.JNIMethodResolver

Modifier and Type	Field and Description
private static final JNIExceptionWrapper.JNIMethodResolver	CreateException
private static volatile JNI.JClass	entryPointsClass
private static final JNIExceptionWrapper.JNIMethodResolver	GetClassName
private static final JNIExceptionWrapper.JNIMethodResolver	GetStackTrace
private static final JNIExceptionWrapper.JNIMethodResolver	GetThrowableMessage
private static final String	HS_ENTRYPOINTS_CLASS
private static final String	JNI_TRANSITION_CLASS
private static final Set<String>	JNI_TRANSITION_METHODS Names of the methods in the `JNICalls` class annotated by the `JNICall`.
private static final long	serialVersionUID Hides java.lang.RuntimeException.serialVersionUID.
private final JNI.JThrowable	throwableHandle
private final boolean	throwableRequiresStackTraceUpdate
private static final JNIExceptionWrapper.JNIMethodResolver	UpdateStackTrace

Access	Constructor and Description
private	JNIExceptionWrapper(JNI.JNIEnv env, JNI.JThrowable throwableHandle)

Method Summary

Modifier and Type	Method and Description
private static JNI.JThrowable	callCreateException(JNI.JNIEnv env, JNI.JObject p0)
pack-priv static <T extends JNI.JObject> T	callGetClassName(JNI.JNIEnv env, JNI.JObject p0)
private static <T extends JNI.JObject> T	callGetStackTrace(JNI.JNIEnv env, JNI.JObject p0)
private static <T extends JNI.JObject> T	callGetThrowableMessage(JNI.JNIEnv env, JNI.JObject p0)
private static <T extends JNI.JObject> T	callUpdateStackTrace(JNI.JNIEnv env, JNI.JObject p0, JNI.JByteArray p1)
private static boolean	containsJNIHostCall(StackTraceElement[] stackTrace) Determines if `stackTrace` contains a frame denoting a call into HotSpot.
public static JNI.JThrowable	createHSException(JNI.JNIEnv the `JNIEnv` env, Throwable an exception to be created in HotSpot original) Crates an exception in HotSpot representing the given `original` exception.
private boolean	Returns: true if the stack trace needed a merge createMergedStackTrace(JNI.JNIEnv env) Creates a merged native image and HotSpot stack trace and updates this `JNIExceptionWrapper` stack trace to it.
private static String	formatExceptionMessage(String className, String message)
private static String	getClassName(JNI.JNIEnv env, JNI.JThrowable throwableHandle)
private static JNI.JClass	getEntryPoints(JNI.JNIEnv env)
private static int	Returns: `0` if no caller found getIndexOfPropagateJNIExceptionFrame(StackTraceElement[] stackTrace) Gets the index of the first frame denoting the caller of `wrapAndThrowPendingJNIException(JNI.JNIEnv)` or `wrapAndThrowPendingJNIException(JNI.JNIEnv, ExceptionHandler)` in `stackTrace`.
private static int	Returns: `0` if no caller found getIndexOfTransitionToNativeFrame(StackTraceElement[] stackTrace) Gets the index of the first frame denoting the native method call.
private static StackTraceElement[]	Returns: the stack trace getJNIExceptionStackTrace(JNI.JNIEnv the `JNIEnv` env, JNI.JObject the JNI exception to get the stack trace from. throwableHandle) Gets the stack trace from a JNI exception.
private static String	getMessage(JNI.JNIEnv env, JNI.JThrowable throwableHandle)
private static boolean	isJNIHostCall(StackTraceElement frame) Determines if `frame` is for a method denoting a call into HotSpot.
private static boolean	isStackFrame(StackTraceElement stackTraceElement, Class<?> clazz, String methodName)
public static StackTraceElement[]	mergeStackTraces(StackTraceElement[] hotSpotStackTrace, StackTraceElement[] nativeStackTrace, boolean originatedInHotSpot)
private static StackTraceElement[]	mergeStackTraces(StackTraceElement[] hotSpotStackTrace, StackTraceElement[] nativeStackTrace, int hotSpotStackStartIndex, int nativeStackStartIndex, boolean originatedInHotSpot) Merges `hotSpotStackTrace` with `nativeStackTrace`.
private void	throwInHotSpot(JNI.JNIEnv env) Re-throws this JNI exception in HotSpot after updating the stack trace to include the native image frames between the native image entry point and the call back to HotSpot that threw the original JNI exception.
public static void	throwInHotSpot(JNI.JNIEnv the `JNIEnv` env, Throwable an exception to be thrown in HotSpot original) Throws an exception into HotSpot.
private static JNI.JThrowable	updateStackTrace(JNI.JNIEnv env, JNI.JThrowable throwableHandle, StackTraceElement[] mergedStackTrace)
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.
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.

Field Detail

CreateException	back to summary
private static final JNIExceptionWrapper.JNIMethodResolver CreateException

entryPointsClass	back to summary
private static volatile JNI.JClass entryPointsClass

GetClassName	back to summary
private static final JNIExceptionWrapper.JNIMethodResolver GetClassName

GetStackTrace	back to summary
private static final JNIExceptionWrapper.JNIMethodResolver GetStackTrace

GetThrowableMessage	back to summary
private static final JNIExceptionWrapper.JNIMethodResolver GetThrowableMessage

HS_ENTRYPOINTS_CLASS	back to summary
private static final String HS_ENTRYPOINTS_CLASS

JNI_TRANSITION_CLASS	back to summary
private static final String JNI_TRANSITION_CLASS

JNI_TRANSITION_METHODS	back to summary
private static final Set<String> JNI_TRANSITION_METHODS Names of the methods in the `JNICalls` class annotated by the `JNICall`.

serialVersionUID	back to summary
private static final long serialVersionUID Hides java.lang.RuntimeException.serialVersionUID.

throwableHandle	back to summary
private final JNI.JThrowable throwableHandle

throwableRequiresStackTraceUpdate	back to summary
private final boolean throwableRequiresStackTraceUpdate

UpdateStackTrace	back to summary
private static final JNIExceptionWrapper.JNIMethodResolver UpdateStackTrace

Constructor Detail

JNIExceptionWrapper	back to summary
private JNIExceptionWrapper(JNI.JNIEnv env, JNI.JThrowable throwableHandle)

Method Detail

callCreateException	back to summary
private static JNI.JThrowable callCreateException(JNI.JNIEnv env, JNI.JObject p0)

callGetClassName	back to summary
pack-priv static <T extends JNI.JObject> T callGetClassName(JNI.JNIEnv env, JNI.JObject p0) Annotations @SuppressWarnings:unchecked

callGetStackTrace	back to summary
private static <T extends JNI.JObject> T callGetStackTrace(JNI.JNIEnv env, JNI.JObject p0) Annotations @SuppressWarnings:unchecked

callGetThrowableMessage	back to summary
private static <T extends JNI.JObject> T callGetThrowableMessage(JNI.JNIEnv env, JNI.JObject p0) Annotations @SuppressWarnings:unchecked

callUpdateStackTrace	back to summary
private static <T extends JNI.JObject> T callUpdateStackTrace(JNI.JNIEnv env, JNI.JObject p0, JNI.JByteArray p1)

containsJNIHostCall	back to summary
private static boolean containsJNIHostCall(StackTraceElement[] stackTrace) Determines if `stackTrace` contains a frame denoting a call into HotSpot.

createHSException back to summary

createHSException	back to summary
public static JNI.JThrowable createHSException(JNI.JNIEnv env, Throwable original) Crates an exception in HotSpot representing the given `original` exception. Parameters env:JNI.JNIEnv the `JNIEnv` original:Throwable an exception to be created in HotSpot

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

Crates an exception in HotSpot representing the given original exception.

Parameters

env:JNI.JNIEnv: the JNIEnv
original:Throwable: an exception to be created in HotSpot

createMergedStackTrace back to summary

createMergedStackTrace	back to summary
private boolean createMergedStackTrace(JNI.JNIEnv env) Creates a merged native image and HotSpot stack trace and updates this `JNIExceptionWrapper` stack trace to it. Returns:boolean true if the stack trace needed a merge

private boolean createMergedStackTrace(JNI.JNIEnv env)

Creates a merged native image and HotSpot stack trace and updates this JNIExceptionWrapper stack trace to it.

Returns:boolean: true if the stack trace needed a merge

formatExceptionMessage	back to summary
private static String formatExceptionMessage(String className, String message)

getClassName	back to summary
private static String getClassName(JNI.JNIEnv env, JNI.JThrowable throwableHandle)

getEntryPoints	back to summary
private static JNI.JClass getEntryPoints(JNI.JNIEnv env)

getIndexOfPropagateJNIExceptionFrame back to summary

getIndexOfPropagateJNIExceptionFrame	back to summary
private static int getIndexOfPropagateJNIExceptionFrame(StackTraceElement[] stackTrace) Gets the index of the first frame denoting the caller of `wrapAndThrowPendingJNIException(JNI.JNIEnv)` or `wrapAndThrowPendingJNIException(JNI.JNIEnv, ExceptionHandler)` in `stackTrace`. Returns:int `0` if no caller found

private static int getIndexOfPropagateJNIExceptionFrame(StackTraceElement[] stackTrace)

Gets the index of the first frame denoting the caller of wrapAndThrowPendingJNIException(JNI.JNIEnv) or wrapAndThrowPendingJNIException(JNI.JNIEnv, ExceptionHandler) in stackTrace.

Returns:int: 0 if no caller found

getIndexOfTransitionToNativeFrame back to summary

getIndexOfTransitionToNativeFrame	back to summary
private static int getIndexOfTransitionToNativeFrame(StackTraceElement[] stackTrace) Gets the index of the first frame denoting the native method call. Returns:int `0` if no caller found

private static int getIndexOfTransitionToNativeFrame(StackTraceElement[] stackTrace)

Gets the index of the first frame denoting the native method call.

Returns:int: 0 if no caller found

getJNIExceptionStackTrace back to summary

getJNIExceptionStackTrace	back to summary
private static StackTraceElement[] getJNIExceptionStackTrace(JNI.JNIEnv env, JNI.JObject throwableHandle) Gets the stack trace from a JNI exception. Parameters env:JNI.JNIEnv the `JNIEnv` throwableHandle:JNI.JObject the JNI exception to get the stack trace from. Returns:StackTraceElement[] the stack trace

private static StackTraceElement[] getJNIExceptionStackTrace(JNI.JNIEnv env, JNI.JObject throwableHandle)

Gets the stack trace from a JNI exception.

Parameters

env:JNI.JNIEnv: the JNIEnv
throwableHandle:JNI.JObject: the JNI exception to get the stack trace from.

Returns:StackTraceElement[]

the stack trace

getMessage	back to summary
private static String getMessage(JNI.JNIEnv env, JNI.JThrowable throwableHandle)

isJNIHostCall	back to summary
private static boolean isJNIHostCall(StackTraceElement frame) Determines if `frame` is for a method denoting a call into HotSpot.

isStackFrame	back to summary
private static boolean isStackFrame(StackTraceElement stackTraceElement, Class<?> clazz, String methodName)

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

mergeStackTraces	back to summary
private static StackTraceElement[] mergeStackTraces(StackTraceElement[] hotSpotStackTrace, StackTraceElement[] nativeStackTrace, int hotSpotStackStartIndex, int nativeStackStartIndex, boolean originatedInHotSpot) Merges `hotSpotStackTrace` with `nativeStackTrace`.

throwInHotSpot	back to summary
private void throwInHotSpot(JNI.JNIEnv env) Re-throws this JNI exception in HotSpot after updating the stack trace to include the native image frames between the native image entry point and the call back to HotSpot that threw the original JNI exception.

throwInHotSpot back to summary

throwInHotSpot	back to summary
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:JNI.JNIEnv the `JNIEnv` original:Throwable an exception to be thrown in HotSpot

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:JNI.JNIEnv: the JNIEnv
original:Throwable: an exception to be thrown in HotSpot

updateStackTrace	back to summary
private static JNI.JThrowable updateStackTrace(JNI.JNIEnv env, JNI.JThrowable throwableHandle, StackTraceElement[] mergedStackTrace)

wrapAndThrowPendingJNIException back to summary

wrapAndThrowPendingJNIException	back to summary
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)`.

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 back to summary

wrapAndThrowPendingJNIException	back to summary
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 `ExceptionHandler`

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

See Also: ExceptionHandler

org.graalvm.jniutils back to summary

public Interface JNIExceptionWrapper.ExceptionHandler

Field Summary

Modifier and Type	Field and Description
public static final JNIExceptionWrapper.ExceptionHandler	DEFAULT Default handler throwing `JNIExceptionWrapper` for the pending JNI exception.

Method Summary

Modifier and Type	Method and Description
public static JNIExceptionWrapper.ExceptionHandler	allowExceptions(Class<? extends Throwable>... allowedExceptions) Creates an exception handler suppressing `allowedExceptions`.
public void	handleException(JNIExceptionWrapper.ExceptionHandlerContext context) Handles the JNI pending exception.

Field Detail

DEFAULT	back to summary
public static final JNIExceptionWrapper.ExceptionHandler DEFAULT Default handler throwing `JNIExceptionWrapper` for the pending JNI exception.

Method Detail

allowExceptions back to summary

allowExceptions	back to summary
public static JNIExceptionWrapper.ExceptionHandler allowExceptions(Class<? extends Throwable>... allowedExceptions) Creates an exception handler suppressing `allowedExceptions`. Other JNI exceptions are rethrown as `JNIExceptionWrapper`. Annotations @SafeVarargs

public static JNIExceptionWrapper.ExceptionHandler allowExceptions(Class<? extends Throwable>... allowedExceptions)

Creates an exception handler suppressing allowedExceptions. Other JNI exceptions are rethrown as JNIExceptionWrapper.

Annotations

@SafeVarargs

handleException	back to summary
public void handleException(JNIExceptionWrapper.ExceptionHandlerContext context) Handles the JNI pending exception.

org.graalvm.jniutils back to summary

public final Class JNIExceptionWrapper.ExceptionHandlerContext

Class Inheritance

extends Object

java.lang.Object
org.graalvm.jniutils.JNIExceptionWrapper.ExceptionHandlerContext

Context for ExceptionHandler.

Field Summary

Modifier and Type	Field and Description
private final JNI.JNIEnv	env
private final JNI.JThrowable	throwable

Constructor Summary

Access	Constructor and Description
pack-priv	ExceptionHandlerContext(JNI.JNIEnv env, JNI.JThrowable throwable)

Method Summary

Modifier and Type	Method and Description
public JNI.JNIEnv	getEnv() Returns current thread JNIEnv.
public JNI.JThrowable	getThrowable() Returns pending JNI exception.
public String	getThrowableClassName() Returns pending JNI exception class name.
public void	throwJNIExceptionWrapper() Throws `JNIExceptionWrapper` for the pending JNI exception.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

env	back to summary
private final JNI.JNIEnv env

throwable	back to summary
private final JNI.JThrowable throwable

Constructor Detail

ExceptionHandlerContext	back to summary
pack-priv ExceptionHandlerContext(JNI.JNIEnv env, JNI.JThrowable throwable)

Method Detail

getEnv	back to summary
public JNI.JNIEnv getEnv() Returns current thread JNIEnv.

getThrowable	back to summary
public JNI.JThrowable getThrowable() Returns pending JNI exception.

getThrowableClassName	back to summary
public String getThrowableClassName() Returns pending JNI exception class name.

throwJNIExceptionWrapper	back to summary
public void throwJNIExceptionWrapper() Throws `JNIExceptionWrapper` for the pending JNI exception.

org.graalvm.jniutils back to summary

private final Class JNIExceptionWrapper.JNIMethodResolver

Class Inheritance

extends Object
implements JNIMethod

java.lang.Object
org.graalvm.jniutils.JNIExceptionWrapper.JNIMethodResolver

All Implemented Interfaces

org.graalvm.jniutils.JNICalls.JNIMethod

Field Summary

Modifier and Type	Field and Description
private volatile JNI.JMethodID	methodId
private final String	methodName
private final String	methodSignature

Constructor Summary

Access	Constructor and Description
private	JNIMethodResolver(String methodName, String methodSignature)

Method Summary

Modifier and Type	Method and Description
pack-priv static JNIExceptionWrapper.JNIMethodResolver	create(String methodName, Class<?> returnType, Class<?>... parameterTypes)
public String	getDisplayName() Implements org.graalvm.jniutils.JNICalls.JNIMethod.getDisplayName. Returns a method display name used for logging.
public JNI.JMethodID	getJMethodID() Implements org.graalvm.jniutils.JNICalls.JNIMethod.getJMethodID. Returns a method JNI `JMethodID`.
pack-priv JNIExceptionWrapper.JNIMethodResolver	resolve(JNI.JNIEnv jniEnv)