首页 > 代码库 > android — JNI注册方法说明
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文件一样。
android — JNI注册方法说明