在android的JNIHelp.h文件中声明四种可以向JVM抛异常的函数:
int jniThrowException(JNIEnv* env,
const char* className,
const char* msg)
int jniThrowNullPointerException(JNIEnv* env,
char* msg)
int jniThrowIOException(JNIEnv* env,
int errnum)
int jniThrowRuntimeException(JNIEnv* env,
const char* msg)
注意:虽然
const char* className
它是字符串,但是它是要传到中使用,所以它必须和某个类相对应的。
以上4个函数的定义是JNIHelp.c文件中进行的。查看源码你会发现
jniThrowNullPointerException
、
jniThrowRuntimeException
、
jniThrowIOException
其实就是个特殊的jniThrowException。
其实它们是const char*
className
参数分别为"
java/lang/NullPointerException
"、
"java/lang/RuntimeException
"、"
java/IO/IOException
"的jniThrowException。
它们的使用也很简单,具体可以参照下面的示例代码。
另外注意,这里的抛异常函数并不是在抛异常的同时退出当前函数,而是在函数最终返回时,才真正的抛出异常。
示例1
android_database_SQLiteQuery.cpp文件中的native_fill_window函数
static jint
native_fill_window(JNIEnv* env, jobject object, jobject javaWindow,
jint
startPos,
jint
offsetParam)
{
//略
if (statement == NULL) {
LOGE("Invalid statement in fillWindow()");
jniThrowException(env, "java/lang/IllegalStateException",
"Attempting to access a deactivated, closed, or empty cursor");
return
0;
}
// Only do the binding if there is a valid offsetParam. If no binding needs to be done
// offsetParam will be set to 0, an invliad value.
if
(offsetParam > 0) {
// Bind the offset parameter, telling the program which row to start with
err = sqlite3_bind_int(statement, offsetParam, startPos);
if
(err != SQLITE_OK) {
LOGE("Unable to bind offset position, offsetParam = %d", offsetParam);
jniThrowException(env, "java/lang/IllegalArgumentException",
sqlite3_errmsg(GET_HANDLE(env, object)));
return
0;
}
LOG_WINDOW("Bound to startPos %d", startPos);
} else {
LOG_WINDOW("Not binding to startPos %d", startPos);
}
// Get the native window
window = get_window_from_object(env, javaWindow);
if (!window) {
LOGE("Invalid CursorWindow");
jniThrowException(env, "java/lang/IllegalArgumentException","Bad CursorWindow");
return
0;
}
LOG_WINDOW("Window: numRows = %d, size = %d, freeSpace = %d", window->getNumRows(), window->size(), window->freeSpace());
numColumns = sqlite3_column_count(statement);
if (!window->setNumColumns(numColumns)) {
LOGE("Failed to change column count from %d to %d", window->getNumColumns(), numColumns);
jniThrowException(env, "java/lang/IllegalStateException", "numColumns mismatch");
return
0;
}
//略
}
示例2
android_util_EventLog.cpp中的android_util_EventLog_readEvents函数
static void android_util_EventLog_readEvents(JNIEnv* env, jobject clazz,
jintArray tags,
jobject out) {
if (tags == NULL || out == NULL) {
jniThrowException(env, "java/lang/NullPointerException", NULL);
return;
}
int fd = open("/dev/" LOGGER_LOG_EVENTS, O_RDONLY | O_NONBLOCK);
if (fd < 0) {
jniThrowIOException(env, errno);
return;
}
jsize tagLength = env->GetArrayLength(tags);
jint *tagValues = env->GetIntArrayElements(tags, NULL);
uint8_t buf[LOGGER_ENTRY_MAX_LEN];
struct timeval timeout = {0, 0};
fd_set readset;
FD_ZERO(&readset);
for (;;) {
// Use a short select() to try to avoid problems hanging on read().
// This means we block for 5ms at the end of the log -- oh well.
timeout.tv_usec = 5000;
FD_SET(fd, &readset);
int r = select(fd + 1, &readset, NULL, NULL, &timeout);
if (r == 0) {
break; // no more events
} else if (r < 0 && errno == EINTR) {
continue; // interrupted by signal, try again
} else if (r < 0) {
jniThrowIOException(env, errno); // Will throw on return
break;
}
int len = read(fd, buf, sizeof(buf));
if (len == 0 || (len < 0 && errno == EAGAIN)) {
break; // no more events
} else if (len < 0 && errno == EINTR) {
continue; // interrupted by signal, try again
} else if (len < 0) {
jniThrowIOException(env, errno); // Will throw on return
break;
} else if ((size_t) len < sizeof(logger_entry) + sizeof(int32_t)) {
jniThrowException(env, "java/io/IOException", "Event too short");
break;
}
//略
}
close(fd);
env->ReleaseIntArrayElements(tags, tagValues, 0);
}