JNI 静态注册与动态注册

一、JNI 注册方式

1.1 静态注册

原理：
根据函数名来建立 java 方法与 JNI 函数的一一对应关系；

实现流程：

• 编写 java 代码；

public class TestNdkTools {
  static {
    System.loadLibrary("ndkdemotest-jni");
  }

  //声明native方法，主要是native关键字
  public static native String getStringFromNdk();
}

• 利用 javah 指令生成对应的 .h 文件；
  找到对应的 class 文件，执行命令 javah -jni com.francis.testndkbuild.TestNdkTools ，会在同个目录下面生成 com_francis_testndkbuild_TestNdkTools.h 文件。
  然后将该文件复制到 jni 目录下，该文件内容如下：

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_francis_testndkbuild_TestNdkTools */

#ifndef _Included_com_francis_testndkbuild_TestNdkTools
#define _Included_com_francis_testndkbuild_TestNdkTools
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_francis_testndkbuild_TestNdkTools
 * Method:    getStringFromNdk
 * Signature: ()Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_francis_testndkbuild_TestNdkTools_getStringFromNdk
  (JNIEnv *, jclass);
#ifdef __cplusplus
}
#endif
#endif

• 对 .h 中的声明进行实现；
  创建一个 ndkdemotest.c 文件，代码如下：

#include "com_francis_testndkbuild_TestNdkTools.h"

JNIEXPORT jstring JNICALL Java_com_wangsu_testndkbuild_TestNdkTools_getStringFromNdk
  (JNIEnv *env, jobject obj){
     return (*env)->NewStringUTF(env,"Hellow World，from NDK");
  }

弊端：

• 编写不方便，JNI 方法名字必须遵循规则且名字很长；
• 编写过程步骤多，不方便；
• 程序运行效率低，因为初次调用native函数时需要根据根据函数名在 JNI 层中搜索对应的本地函数，然后建立对应关系，这个过程比较耗时；

1.2 动态注册

原理：
利用 RegisterNatives 方法来注册 java 方法与 JNI 函数的一一对应关系；

#include <jni.h>

jstring stringFromJNI(JNIEnv *env, jobject thiz){
    return env->NewStringUTF("Hello from C++");
}

static const JNINativeMethod gMethods[] = {
        {"getStringFromNdk", "()Ljava/lang/String;", (jstring*)stringFromJNI}
};

JNIEXPORT jint JNI_OnLoad(JavaVM* vm, void* reserved){

    JNIEnv* env = NULL;
    if(vm->GetEnv((void**)&env, JNI_VERSION_1_4) != JNI_OK) //从JavaVM获取JNIEnv，一般使用1.4的版本
        return -1;
    jclass clazz = env->FindClass("com/francis/testndkbuild/TestNdkTools");
    if (!clazz){
        return -1;
    }
    if(env->RegisterNatives(clazz, gMethods, sizeof(gMethods)/sizeof(gMethods[0])))
    {
        return -1;
    }
    return JNI_VERSION_1_4;
}

实现流程：

• 利用结构体 JNINativeMethod 数组记录 java 方法与 JNI 函数的对应关系；
• 实现 JNI_OnLoad 方法，在加载动态库后，执行动态注册；
• 调用 FindClass 方法，获取 java 对象；
• 调用 RegisterNatives 方法，传入 java 对象，以及 JNINativeMethod 数组，以及注册数目完成注册；

优点：

• 流程更加清晰可控；
• 效率更高；

JNINativeMethod

JNINativeMethod 结构体如下：

typedef struct {
    const char* name;
    const char* signature;
    void*       fnPtr;
} JNINativeMethod;

name：java的方法名

signature：用于描述方法的参数和返回值

fnPtr：函数指针，指向 jni 方法

二、JNI 数据类型

需要注意的是， JNI 也有自己的数据类型，signature 方法参数和返回值的写法，与 java 有所区别：

//java方法
private native static int init(int logLevel, String libPath, String filesPath);

//对应的JNINativeMethod
{ "init", "(ILjava/lang/String;Ljava/lang/String;)I", (void *) init }

可以看到差别还是挺大的，它们的映射关系如下：

1. 基本数据类型

java 类型	native 类型	域描述符
boolean	jboolean	Z
byte	jbyte	B
char	jchar	C
short	jshort	S
int	jint	I
long	jlong	J
float	jfloat	F
double	jdouble	D
void	void	V

2. 数组引用类型

如果是一维数组则遵循下表，如果是二维数组或更高维数组则对应的 native 类型为 jobjectArray，域描述符中使用 “[” 的个数表示维数。

java 类型	native 类型	域描述符
int[]	jintArray	[I
float[]	jfloatArray	[f
byte[]	jbyteArray	[B
char[]	jcharArray	[C
short[]	jshortArray	[S
double[]	jdoubleArray	[D
long[]	jlongArray	[F
boolean[]	jbooleanArray	[Z

3. 对象引用类型

对于其它引用类型，即 java 中的对象，其映射规则为：

java 类型	native 类型	域描述符
类名	通常是jobject，仅有一种例外，如果java类型是String，则对应的native类型是jstring	以“L”开头，以“;”结尾，中间是用“/” 隔开的包及类名（如Ljava/lang/String;）如果内部类则使用$连接内部类

参考：
JNI开发之 静态注册与动态注册（一）