JNI在Android源码中的使用案例

什么是JNI，怎么使用

JNI——Java Native Interface，它是Java平台的一个特性(并不是Android系统特有的)。其实主要是定义了一些JNI函数，让开发者可以通过调用这些函数实现Java代码调用C/C++的代码，C/C++的代码也可以调用Java的代码，这样就可以发挥各个语言的特点了。那么怎么使用JNI呢，一般情况下我们首先是将写好的C/C++代码编译成对应平台的动态库(windows一般是dll文件，linux一般是so文件等)，这里我们是针对Android平台，所以只讨论so库。由于JNI编程支持C和C++编程，这里我们的栗子都是使用C++，对于C的版本可能会有些差异，但是主要的内容还是一致的，大家可以触类旁通。

接下来以源码中使用的一个JNI案例来讲解一下：

在做SoundRecord项目的时候MediaPlayer有个方法，如下：

/**
 * Gets the current playback position.
 *
 * @return the current position in milliseconds
 */
public native int getCurrentPosition();

这个带有native的关键字的方法说明这个方法是通过JNI调用C/C++的代码。

于是在这个类中搜索到了如下的代码

static {
    System.loadLibrary("media_jni");
    native_init();
}

在该静态区域类加载名为libmedia_jni.so的库，这里我们说是libmedia_jni.so库，但是加载的时候却只写了“media_jni”，其实大家只要知道这是约定的就可以了。

此时我在framework/base目录下通过：grep -rw "libmedia_jni" . 搜索到了

./media/jni/Android.mk:LOCAL_MODULE:= libmedia_jni

这个说明如果需要编译生成对应的so库的话我们是要在对应的mk文件中添加说明的。

由于之前对JNI了解（java文件中的方法的字符和c++中的方法字符最后一部分是相同的）一点所以我就搜索了：grep -r "getCurrentPosition" .  于是搜索到了

./media/jni/android_media_MediaPlayer.cpp:android_media_MediaPlayer_getCurrentPosition(JNIEnv *env, jobject thiz)

C++的文件名字是“android_media_MediaPlayer.cpp”，C++中的方法的名字是“android_media_MediaPlayer_getCurrentPosition”，而java中MediaPlayer的全称文件名是：“android/media/MediaPlayer.java”，这个不是巧合而是约定俗成的。

接下来看一下C++中的主要代码：

jint JNI_OnLoad(JavaVM* vm, void* /* reserved */)

static jint
android_media_MediaPlayer_getCurrentPosition(JNIEnv *env, jobject thiz)
{
    sp<MediaPlayer> mp = getMediaPlayer(env, thiz);
    if (mp == NULL ) {
        jniThrowException(env, "java/lang/IllegalStateException", NULL);
        return 0;
    }
    int msec;
    process_media_player_call( env, thiz, mp->getCurrentPosition(&msec), NULL, NULL );
    ALOGV("getCurrentPosition: %d (msec)", msec);
    return (jint) msec;
}

static JNINativeMethod gMethods[] = {
    {
        "nativeSetDataSource",
        "(Landroid/os/IBinder;Ljava/lang/String;[Ljava/lang/String;"
        "[Ljava/lang/String;)V",
        (void *)android_media_MediaPlayer_setDataSourceAndHeaders
    },

{"seekTo",              "(I)V",                             (void *)android_media_MediaPlayer_seekTo},
{"_pause",              "()V",                              (void *)android_media_MediaPlayer_pause},
{"isPlaying",           "()Z",                              (void *)android_media_MediaPlayer_isPlaying},
{"getCurrentPosition",  "()I",                              (void *)android_media_MediaPlayer_getCurrentPosition},

JNI C/C++代码说明：

1）JNI_OnLoad()函数。该函数在Java程序调用System.loadLibrary()时，被调用执行，用于向JavaVM注册JNI函数等。在本例中首先通过参数JavaVM（Java虚拟机指针）获取当前应用程序所在的线程，即：JNIEnv。再通过调用 android::AndroidRuntime::registerNativeMethods()注册native实现的函数指针。

2）JNI函数和Java调用函数的映射关系。使用JNINativeMethod将java调用的函数名与JNI实现的函数名联系在一起；

3）JNI函数实现；