6311046: -Xcheck:jni should support checking of GetPrimitiveArrayCritical.
Summary: Wrapped memory with standard bounds checking "GuardedMemory".
Reviewed-by: zgu, fparain, dcubed
/* * Copyright (c) 1997, 2013, 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. */#ifndef JNI_UTIL_H#define JNI_UTIL_H#include "jni.h"#include "jlong.h"#ifdef __cplusplusextern "C" {#endif/* * This file contains utility functions that can be implemented in pure JNI. * * Caution: Callers of functions declared in this file should be * particularly aware of the fact that these functions are convenience * functions, and as such are often compound operations, each one of * which may throw an exception. Therefore, the functions this file * will often return silently if an exception has occurred, and callers * must check for exception themselves. *//* Throw a Java exception by name. Similar to SignalError. */JNIEXPORT void JNICALLJNU_ThrowByName(JNIEnv *env, const char *name, const char *msg);/* Throw common exceptions */JNIEXPORT void JNICALLJNU_ThrowNullPointerException(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowArrayIndexOutOfBoundsException(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowOutOfMemoryError(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowIllegalArgumentException(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowIllegalAccessError(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowIllegalAccessException(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowInternalError(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowIOException(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowNoSuchFieldException(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowNoSuchMethodException(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowClassNotFoundException(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowNumberFormatException(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowNoSuchFieldError(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowNoSuchMethodError(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowStringIndexOutOfBoundsException(JNIEnv *env, const char *msg);JNIEXPORT void JNICALLJNU_ThrowInstantiationException(JNIEnv *env, const char *msg);/* Throw an exception by name, using the string returned by * JVM_LastErrorString for the detail string. If the last-error * string is NULL, use the given default detail string. */JNIEXPORT void JNICALLJNU_ThrowByNameWithLastError(JNIEnv *env, const char *name, const char *defaultMessage);/* Throw an IOException, using the last-error string for the detail * string. If the last-error string is NULL, use the given default * detail string. */JNIEXPORT void JNICALLJNU_ThrowIOExceptionWithLastError(JNIEnv *env, const char *defaultDetail);/* Convert between Java strings and i18n C strings */JNIEXPORT jstringNewStringPlatform(JNIEnv *env, const char *str);JNIEXPORT const char *GetStringPlatformChars(JNIEnv *env, jstring jstr, jboolean *isCopy);JNIEXPORT jstring JNICALLJNU_NewStringPlatform(JNIEnv *env, const char *str);JNIEXPORT const char * JNICALLJNU_GetStringPlatformChars(JNIEnv *env, jstring jstr, jboolean *isCopy);JNIEXPORT void JNICALLJNU_ReleaseStringPlatformChars(JNIEnv *env, jstring jstr, const char *str);/* Class constants */JNIEXPORT jclass JNICALLJNU_ClassString(JNIEnv *env);JNIEXPORT jclass JNICALLJNU_ClassClass(JNIEnv *env);JNIEXPORT jclass JNICALLJNU_ClassObject(JNIEnv *env);JNIEXPORT jclass JNICALLJNU_ClassThrowable(JNIEnv *env);/* Copy count number of arguments from src to dst. Array bounds * and ArrayStoreException are checked. */JNIEXPORT jint JNICALLJNU_CopyObjectArray(JNIEnv *env, jobjectArray dst, jobjectArray src, jint count);/* Invoke a object-returning static method, based on class name, * method name, and signature string. * * The caller should check for exceptions by setting hasException * argument. If the caller is not interested in whether an exception * has occurred, pass in NULL. */JNIEXPORT jvalue JNICALLJNU_CallStaticMethodByName(JNIEnv *env, jboolean *hasException, const char *class_name, const char *name, const char *signature, ...);/* Invoke an instance method by name. */JNIEXPORT jvalue JNICALLJNU_CallMethodByName(JNIEnv *env, jboolean *hasException, jobject obj, const char *name, const char *signature, ...);JNIEXPORT jvalue JNICALLJNU_CallMethodByNameV(JNIEnv *env, jboolean *hasException, jobject obj, const char *name, const char *signature, va_list args);/* Construct a new object of class, specifying the class by name, * and specififying which constructor to run and what arguments to * pass to it. * * The method will return an initialized instance if successful. * It will return NULL if an error has occurred (for example if * it ran out of memory) and the appropriate Java exception will * have been thrown. */JNIEXPORT jobject JNICALLJNU_NewObjectByName(JNIEnv *env, const char *class_name, const char *constructor_sig, ...);/* returns: * 0: object is not an instance of the class named by classname. * 1: object is an instance of the class named by classname. * -1: the class named by classname cannot be found. An exception * has been thrown. */JNIEXPORT jint JNICALLJNU_IsInstanceOfByName(JNIEnv *env, jobject object, char *classname);/* Get or set class and instance fields. * Note that set functions take a variable number of arguments, * but only one argument of the appropriate type can be passed. * For example, to set an integer field i to 100: * * JNU_SetFieldByName(env, &exc, obj, "i", "I", 100); * * To set a float field f to 12.3: * * JNU_SetFieldByName(env, &exc, obj, "f", "F", 12.3); * * The caller should check for exceptions by setting hasException * argument. If the caller is not interested in whether an exception * has occurred, pass in NULL. */JNIEXPORT jvalue JNICALLJNU_GetFieldByName(JNIEnv *env, jboolean *hasException, jobject obj, const char *name, const char *sig);JNIEXPORT void JNICALLJNU_SetFieldByName(JNIEnv *env, jboolean *hasException, jobject obj, const char *name, const char *sig, ...);JNIEXPORT jvalue JNICALLJNU_GetStaticFieldByName(JNIEnv *env, jboolean *hasException, const char *classname, const char *name, const char *sig);JNIEXPORT void JNICALLJNU_SetStaticFieldByName(JNIEnv *env, jboolean *hasException, const char *classname, const char *name, const char *sig, ...);/* * Calls the .equals method. */JNIEXPORT jboolean JNICALLJNU_Equals(JNIEnv *env, jobject object1, jobject object2);/************************************************************************ * Thread calls * * Convenience thread-related calls on the java.lang.Object class. */JNIEXPORT void JNICALLJNU_MonitorWait(JNIEnv *env, jobject object, jlong timeout);JNIEXPORT void JNICALLJNU_Notify(JNIEnv *env, jobject object);JNIEXPORT void JNICALLJNU_NotifyAll(JNIEnv *env, jobject object);/************************************************************************ * Miscellaneous utilities used by the class libraries */#define IS_NULL(obj) ((obj) == NULL)#define JNU_IsNull(env,obj) ((obj) == NULL)/************************************************************************ * Miscellaneous utilities used by the class libraries to return from * a function if a value is NULL or an exception is pending. */#define CHECK_NULL(x) \ do { \ if ((x) == NULL) { \ return; \ } \ } while (0) \#define CHECK_NULL_RETURN(x, y) \ do { \ if ((x) == NULL) { \ return (y); \ } \ } while (0) \#ifdef __cplusplus#define JNU_CHECK_EXCEPTION(env) \ do { \ if ((env)->ExceptionCheck()) { \ return; \ } \ } while (0) \#define JNU_CHECK_EXCEPTION_RETURN(env, y) \ do { \ if ((env)->ExceptionCheck()) { \ return (y); \ } \ } while (0)#else#define JNU_CHECK_EXCEPTION(env) \ do { \ if ((*env)->ExceptionCheck(env)) { \ return; \ } \ } while (0) \#define JNU_CHECK_EXCEPTION_RETURN(env, y) \ do { \ if ((*env)->ExceptionCheck(env)) { \ return (y); \ } \ } while (0)#endif /* __cplusplus *//************************************************************************ * Debugging utilities */JNIEXPORT void JNICALLJNU_PrintString(JNIEnv *env, char *hdr, jstring string);JNIEXPORT void JNICALLJNU_PrintClass(JNIEnv *env, char *hdr, jobject object);JNIEXPORT jstring JNICALLJNU_ToString(JNIEnv *env, jobject object);/* * Package shorthand for use by native libraries */#define JNU_JAVAPKG "java/lang/"#define JNU_JAVAIOPKG "java/io/"#define JNU_JAVANETPKG "java/net/"/* * Check if the current thread is attached to the VM, and returns * the JNIEnv of the specified version if the thread is attached. * * If the current thread is not attached, this function returns 0. * * If the current thread is attached, this function returns the * JNI environment, or returns (void *)JNI_ERR if the specified * version is not supported. */JNIEXPORT void * JNICALLJNU_GetEnv(JavaVM *vm, jint version);/* * Warning free access to pointers stored in Java long fields. */#define JNU_GetLongFieldAsPtr(env,obj,id) \ (jlong_to_ptr((*(env))->GetLongField((env),(obj),(id))))#define JNU_SetLongFieldFromPtr(env,obj,id,val) \ (*(env))->SetLongField((env),(obj),(id),ptr_to_jlong(val))/* * Internal use only. */enum { NO_ENCODING_YET = 0, /* "sun.jnu.encoding" not yet set */ NO_FAST_ENCODING, /* Platform encoding is not fast */ FAST_8859_1, /* ISO-8859-1 */ FAST_CP1252, /* MS-DOS Cp1252 */ FAST_646_US /* US-ASCII : ISO646-US */};int getFastEncoding();void initializeEncoding();void* getProcessHandle();void buildJniFunctionName(const char *sym, const char *cname, char *jniEntryName);#ifdef __cplusplus} /* extern "C" */#endif /* __cplusplus */#endif /* JNI_UTIL_H */