Android NDK 學習之在C中拋出異常

本博客主要是在Ubuntu 下開發，且默認你已經安裝了Eclipse，Android SDK， Android NDK， CDT插件。

在Eclipse中添加配置NDK，路徑如下Eclipse->Window->Preferences->Android->NDK ，選擇NDK的路徑，然後Apply即可。

新建一個名爲AndroidJNI_CathcThrow的Android工程，新建一個jni的文件夾，其目錄下文件樹列表如下：

├── jni
│   ├── Android.mk
│   ├── Application.mk
│   └── catchthrow
│   　　 ├── Android.mk
│   　　 ├── catchthrow_jni.c
│   　　 └── logger.h

jni/Application.mk文件內容如下：

APP_ABI := all

jni/Android.mk，主要用來指定順序執行所有子文件夾下面的makefile文件，內容如下：

include $(call all-subdir-makefiles)

 

jni/catchthrow/Android.mk，主要用來指定需要編譯出的動態庫的名稱，以及需要編譯的源文件，內容如下：

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE     := catchthrow_jni
LOCAL_SRC_FILES := catchthrow_jni.c

LOCAL_LDLIBS := -llog

include $(BUILD_SHARED_LIBRARY)

 

jni/catchthrow/logger.h 主要用來在JNI層打印日誌，內容如下：

#include <jni.h>
#include <android/log.h>

/**
 * 定義log標籤
 */
#define TAG "jni_logger"

/**
 * 定義info信息
 */
#define LOGI(...) __android_log_print(ANDROID_LOG_INFO, TAG, __VA_ARGS__)

/**
 * 定義debug信息
 */
#define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG, TAG, __VA_ARGS__)

/**
 * 定義error信息
 */
#define LOGE(...) __android_log_print(ANDROID_LOG_ERROR, TAG, __VA_ARGS__)

 

jni/catchthrow/catchthrow_jni.c，主要用來註冊綁定java函數和native函數，以及java函數在c中相應函數的具體實現， 內容如下：

#include "logger.h"

#ifndef NULL
#define NULL   ((void *) 0)
#endif

/**
 * 獲取數組的大小
 */
#define NELEM(x) ((int) (sizeof(x) / sizeof((x)[0])))

/**
 * 指定要註冊的類，對應的完整的java類名
 */
#define JNIREG_CLASS "com/clarck/jni/CatchThrow"

/**
 * 返回成員實例域
 */
JNIEXPORT void JNICALL native_catchThrow_doit(JNIEnv *env, jobject obj) {
    jthrowable exc;
    jclass cls = (*env)->GetObjectClass(env, obj);
    jmethodID mid = (*env)->GetMethodID(env, cls, "callback", "()V");

    if (NULL == mid) {
        return ;
    }
    (*env)->CallVoidMethod(env, obj, mid);
    exc = (*env)->ExceptionOccurred(env);
    if (exc) {
        jclass newExcCls;
        (*env)->ExceptionDescribe(env);
        (*env)->ExceptionClear(env);
        newExcCls = (*env)->FindClass(env, "java/lang/IllegalArgumentException");
        if (newExcCls == NULL) {
            return ;
        }
        (*env)->ThrowNew(env, newExcCls, "thrown from C code");
    }
}

/**
 * Java和JNI函數綁定
 */
static JNINativeMethod method_table[] = {
        { "doit", "()V", (void*) native_catchThrow_doit },
};

/**
 * 註冊native方法到java中
 */
static int registerNativeMethods(JNIEnv* env, const char* className,
        JNINativeMethod* gMethods, int numMethods) {
    jclass clazz;
    clazz = (*env)->FindClass(env, className);
    if (clazz == NULL) {
        return JNI_FALSE;
    }

    if ((*env)->RegisterNatives(env, clazz, gMethods, numMethods) < 0) {
        return JNI_FALSE;
    }

    return JNI_TRUE;
}

/**
 * 調用註冊方法
 */
int register_ndk_load(JNIEnv* env) {
    return registerNativeMethods(env, JNIREG_CLASS, method_table,
            NELEM(method_table));
}

JNIEXPORT jint JNI_OnLoad(JavaVM* vm, void* reserved) {
    JNIEnv* env = NULL;
    jint result = -1;

    if ((*vm)->GetEnv(vm, (void**) &env, JNI_VERSION_1_4) != JNI_OK) {
        return result;
    }

    register_ndk_load(env);

    //返回jni的版本
    return JNI_VERSION_1_4;
}

 

接着在Project中右鍵Android Tools->Add Native Support，最後java層調用如下：

package com.clarck.jni;

public class CatchThrow {
    public native void doit() throws IllegalArgumentException;
    
    public void callback() throws NullPointerException {
        throw new NullPointerException("CathcThrow.callback");
    }
    
    static {
        System.loadLibrary("catchthrow_jni");
    }
}

package com.clarck.jni;

import android.app.Activity;
import android.os.Bundle;
import android.util.Log;

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        CatchThrow c = new CatchThrow();
        try {
            c.doit();
        } catch (Exception e) {
            Log.d("Test", "In Java: \n \t" + e);
        }
    }
}

 

執行Ctrl+B編譯，然後運行即可。