一、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;)如果内部类则使用$连接内部类 |