mirror of
https://github.com/openjdk/jdk.git
synced 2026-02-06 08:28:27 +00:00
163 lines
5.3 KiB
C
163 lines
5.3 KiB
C
/*
|
|
* Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved.
|
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
*
|
|
* This code is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License version 2 only, as
|
|
* published by the Free Software Foundation. Oracle designates this
|
|
* particular file as subject to the "Classpath" exception as provided
|
|
* by Oracle in the LICENSE file that accompanied this code.
|
|
*
|
|
* This code is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
* version 2 for more details (a copy is included in the LICENSE file that
|
|
* accompanied this code).
|
|
*
|
|
* You should have received a copy of the GNU General Public License version
|
|
* 2 along with this work; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
|
* or visit www.oracle.com if you need additional information or have any
|
|
* questions.
|
|
*/
|
|
|
|
/*
|
|
* Copyright 2003 Wily Technology, Inc.
|
|
*/
|
|
|
|
#ifndef _JAVAEXCEPTIONS_H_
|
|
#define _JAVAEXCEPTIONS_H_
|
|
|
|
#include <jni.h>
|
|
#include <jvmti.h>
|
|
|
|
/**
|
|
* This module contains utility routines for manipulating Java throwables
|
|
* and JNIEnv throwable state from native code.
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*
|
|
* Set up static state. Needs java, must be called at or after VMInit.
|
|
* Returns true if it succeeds, false if it fails.
|
|
*/
|
|
extern jboolean
|
|
initializeFallbackError(JNIEnv* jnienv);
|
|
|
|
/*
|
|
* Mapping support. Allows different clients to map checked exceptions in different ways.
|
|
*/
|
|
typedef jthrowable (*CheckedExceptionMapper)
|
|
( JNIEnv * jnienv,
|
|
jthrowable throwableToMap);
|
|
|
|
/* Default mapper. Map everything checked to InternalError; can return null if error */
|
|
extern jthrowable
|
|
mapAllCheckedToInternalErrorMapper( JNIEnv * jnienv,
|
|
jthrowable throwableToMap);
|
|
|
|
|
|
|
|
/*
|
|
* Exception-helper routines that do not modify the JNIEnv.
|
|
* They require a clean JNIEnv on entry, and they guarantee a clean JNIEnv on exit.
|
|
*/
|
|
|
|
/* creates a throwable from the supplied parameters; can return null if error */
|
|
extern jthrowable
|
|
createThrowable( JNIEnv* jnienv,
|
|
const char* className,
|
|
jstring message);
|
|
|
|
/* creates a java.lang.InternalError; can return null if error */
|
|
extern jthrowable
|
|
createInternalError(JNIEnv * jnienv, jstring message);
|
|
|
|
/* creates the appropriate java Throwable based on the error code; can return null if error */
|
|
extern jthrowable
|
|
createThrowableFromJVMTIErrorCode(JNIEnv * jnienv, jvmtiError errorCode);
|
|
|
|
/* fetches the message string out of the supplied throwable, null if there is none, null if error */
|
|
extern jstring
|
|
getMessageFromThrowable( JNIEnv* jnienv,
|
|
jthrowable exception);
|
|
|
|
/* true if the supplied throwable is unchecked. null will return true. */
|
|
extern jboolean
|
|
isUnchecked( JNIEnv* jnienv,
|
|
jthrowable exception);
|
|
|
|
/* true if the env contains a thrown exception */
|
|
extern jboolean
|
|
checkForThrowable( JNIEnv* jnienv);
|
|
|
|
/* true if the env is clean for JNI calls */
|
|
extern jboolean
|
|
isSafeForJNICalls( JNIEnv * jnienv);
|
|
|
|
/*
|
|
* Logs the outstanding throwable, if one exists.
|
|
* This call assumes an outstanding exception, but does not
|
|
* modify the JNIEnv outstanding Throwable state.
|
|
*/
|
|
extern void
|
|
logThrowable( JNIEnv * jnienv);
|
|
|
|
|
|
/*
|
|
* These routines do modify the JNIEnv outstanding Throwable state.
|
|
*/
|
|
|
|
/* Throws the supplied throwable. always sets the JNIEnv throwable */
|
|
extern void
|
|
throwThrowable( JNIEnv * jnienv,
|
|
jthrowable exception);
|
|
|
|
/* returns current throwable. always clears the JNIEnv exception */
|
|
extern jthrowable
|
|
preserveThrowable(JNIEnv * jnienv);
|
|
|
|
/* undoes preserveThrowable (Throws the supplied throwable). always sets the JNIEnv throwable */
|
|
extern void
|
|
restoreThrowable( JNIEnv * jnienv,
|
|
jthrowable preservedException);
|
|
|
|
/* always clears the JNIEnv throwable. returns true if an exception was pending on entry. */
|
|
extern jboolean
|
|
checkForAndClearThrowable( JNIEnv * jnienv);
|
|
|
|
/* creates the appropriate java Throwable based on the error code
|
|
* does the very best it can to make sure an exception ends up installed; uses fallback if necessary
|
|
* always sets the JNIEnv exception
|
|
*/
|
|
extern void
|
|
createAndThrowThrowableFromJVMTIErrorCode(JNIEnv * jnienv, jvmtiError errorCode);
|
|
|
|
/* creates a java.lang.InternalError and installs it into the JNIEnv.
|
|
* does the very best it can to make sure an exception ends up installed; uses fallback if necessary
|
|
* always sets the JNIEnv exception
|
|
*/
|
|
extern void
|
|
createAndThrowInternalError(JNIEnv * jnienv);
|
|
|
|
/* If no throwable is outstanding, do nothing.
|
|
* If a throwable is outstanding, make sure it is of a legal type according to the supplied
|
|
* mapping function.
|
|
* Leaves the "thrown" state the same (none on exit if none on entry, thrown on exit if
|
|
* thrown on entry); may change the type of the thrown exception.
|
|
*/
|
|
extern void
|
|
mapThrownThrowableIfNecessary(JNIEnv * jnienv, CheckedExceptionMapper mapper);
|
|
|
|
#ifdef __cplusplus
|
|
} /* extern "C" */
|
|
#endif /* __cplusplus */
|
|
|
|
|
|
#endif
|