android — JNI注册方法说明

Jni中还可以采用RegisterNatives来注册jni的方法，注册以后的jni函数的命名可以不需要符合类似javah命令生成的函数的规则

RegisterNatives为JNIEnv的成员函数，声明为：
    jint (JNICALL *RegisterNatives) (JNIEnv *env, jclass clazz, const JNINativeMethod *methods,jint nMethods);

其对应的取消注册的函数为声明为：
    jint (JNICALL *UnregisterNatives) (JNIEnv *env, jclass clazz);

在java中调用System.loadLibrary("somelib");的时候，系统会自动调用jni的函数JNI_OnLoad，
在程序退出的时候，系统卸载“somelib”，会自动调用jni的函数JNI_OnUnload，
所以我们需要在jni的接口文件中重写这两个函数

以上一篇建立的HelloJni的例子来说明：
先定义一个字符串，内容为类名const char* JNIT_CLASS = "com/example/hellojni/HelloJni";

再定义一个函数的说明的数组

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

JNIEXPORT jint JNICALL
JNI_OnLoad(JavaVM *jvm, void *reserved)
{
    JNIEnv *env = NULL;
    if ((*jvm)->GetEnv(jvm, (void**)&env, JNI_VERSION_1_4)){
        return JNI_ERR;
    }

    jclass cls = (*env)->FindClass(env, JNIT_CLASS);
    if (cls == NULL)
    {
        return JNI_ERR;
    }
    jint nRes = (*env)->RegisterNatives(env, cls, gMethods, sizeof(gMethods)/sizeof(gMethods[0]));
    if (nRes < 0)
    {
        return JNI_ERR;
    }
    return JNI_VERSION_1_4;
}

JNIEXPORT void JNICALL
JNI_OnUnLoad(JavaVM *jvm, void *reserved)
{
    JNIEnv *env = NULL;
    if ((*jvm)->GetEnv(jvm, (void**)&env, JNI_VERSION_1_4)){
        return;
    }
    jclass cls = (*env)->FindClass(env, JNIT_CLASS);
    if (cls == NULL)
    {
        return;
    }
    jint nRes = (*env)->UnregisterNatives(env, cls);
    return;
}

其中JNIT_CLASS 表示的是要调用jni的java类的名称
gMethods[]为RegisterNatives的第三个函数，表示的是所有jni的函数的集合。


JNINativeMethod是表示jni方法的结构体，其结构如下：
typedef struct {
    
     char *name;
     char *signature;
      void *fnPtr;

} JNINativeMethod;

第一个变量name为java类中native函数的名称，
第二个变量signature为java类中native函数的java类型描述，
第三个变量fnPtr为jni中对应的函数名称，格式为类似(void*)MethodName，

函数和变量的java类型描述可以通过命令 javap -s -p classname来获得，classname与使用javah时写的名称一致，javah生成的头文件的每个函数的注释中也有这个描述

对于“()Ljava/lang/String;”一个描述，表示该函数没有参数，返回值为String。括号内的是参数列表，后面跟的是返回值

java中简单类型和jni中的描述的对应关系如下表所示：

Field Descriptor	Java Language Type
Z	boolean
B	byte
C	char
S	short
I	int
J	long
F	float
D	double

对于复杂类型，字符串描述以“L”开头，以“;”结束，例如java中的 String ，在jni中的描述为"Ljava/lang/String;"

对于数组，以“[”开头，接类型描述，例如int[ ]，在jni中的描述为“[I”；String[ ]， 对应为“[Ljava/lang/String;”；如果是数组维数增加一维，则"["增加一个，例如int[ ][ ]，对应为“[[I”;

以上内容具体参见《The Java™ Native  Interface   Programmer’s Guide and Specification》一书，JNI中使用的各类型参见第12章 JNI TYPE

在使用JNI_OnLoad之时，我们不能把classname传递给jni，所以const char* JNIT_CLASS 是一个固定的名称，我们在生成SO文件的同时这个classname就固定下来了，所以，当提供so文件的同时，需要提供一个调用该so文件的java文件，类似c++中提供dll时需要提供的.h文件一样。