概述
Java 层如何调用Native层函数,大家都应该知道使用JNI(Java 本地接口)。
通过在java层声明native方法,然后遵守JNI规范命名Native函数,即可建立Java层native声明函数与Native层实现函数的关联。
另一种就是采用函数注册方式,Android Frameword层多采用这种方式,执行效率更高。
以下详细说明,两种方式的实现。
第一种方式:函数命名规范
在Android Studio 工程中,New Project 新建一个项目,将include c++ support 勾上。
pic1.png
创建出来的工程中,默认会帮你生成一个java调用native函数的示例。
//MainActivity.java
public class MainActivity extends AppCompatActivity {
static { System.loadLibrary("native-lib");}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
final TextView tv = findViewById(R.id.sample_text);
tv.setText(stringFromJNI());
}
public native String stringFromJNI();
}
// native-lib.cpp
#include
#include
extern "C"
JNIEXPORT jstring JNICALL Java_com_felix_jnidemo_MainActivity_stringFromJNI(JNIEnv *env, jobject /* this */) {
std::string hello = "hello world from 函数命名规范方式";
return env->NewStringUTF(hello.c_str());
}
一目了然,java层 stringFromJNI 方法 与 native 层 Java_com_felix_jnidemo_MainActivity_stringFromJNI 方法,存在对应关系。
我们会发现,native层函数方法名的命名规范即是
"Java" ,包名,类名 , 方法名 以 "_" 相连
返回值 jstring 对应 java 中的String
JNICALL JNIEXPORT 表明是一个 对外暴露的JNI函数调用
特别留意一下 extern "C" ,必须加上。
如果不加上,由于C++编译器编译 cpp 文件会存在 Name Mangling (命名重整)的问题,Java_com_felix_jnidemo_MainActivity_stringFromJNI 会被C++编译器重整为另一个函数名 xxyyzzaabbcc (我随便起的名),以确保方法的独一无二性。所以java层通过调用 stringFromJNI 时,虚拟机按照默认的命名规范,找不到对应的 native实现函数,从而导致应用崩溃。
而加上 extern "C",则是通知C++编译器按照 C 的编译方式来生成函数名(即函数名保持不变)
第二种方式:函数注册方式
这种方式,写的代码稍微多点,但好处很明显,函数映射关系配置灵活,执行效率要比第一种方式高。
先要明白一个概念:
System.loadLibrary 加载动态库后,进入动态库后,会首先执行 JNI_OnLoad 这个方法,所以我们可以实现这个方法,在这个方法中注册java层与native层的函数对应关系。
具体实现流程
首先在java层中新增一个native 声明函数
public native String stringFromJNI2();
在native层提供对应的实现方法,这次我们不采用默认的命名方式
jstring stringFromJNI2(JNIEnv *env, jobject) {
std::string hello = "hello world from 函数注册方式";
return env->NewStringUTF(hello.c_str());
}
3.在Native层实现 JNI_OnLoad 方法,在这个方法中注册函数的对应关系
static int registerNativeMethods(JNIEnv *, const char *, JNINativeMethod *, int);
static int registerNatives(JNIEnv *);
jint JNI_OnLoad(JavaVM *vm, void *reserved) {
jint result = -1;
JNIEnv *env = NULL;
if (vm->GetEnv((void **) &env, JNI_VERSION_1_4)) {
goto fail;
}
// 在这里注册函数的对应关系
if (registerNatives(env) != JNI_TRUE) {
goto fail;
}
result = JNI_VERSION_1_4;
fail:
return result;
}
static JNINativeMethod gMethods[] = {{"stringFromJNI2", "()Ljava/lang/String;", (void *) stringFromJNI2}};
static int registerNativeMethods(JNIEnv *env, const char *className, JNINativeMethod *gMethods, int numMethods) {
jclass clazz;
clazz = env->FindClass(className);
if (clazz == NULL) {
return JNI_FALSE;
}
// 关键代码,在JNIEnv中 注册函数的对应关系
if (env->RegisterNatives(clazz, gMethods, numMethods) < 0) {
return JNI_FALSE;
}
return JNI_TRUE;
}
static int registerNatives(JNIEnv *env) {
if (!registerNativeMethods(env, "com/felix/jnidemo/MainActivity", gMethods, sizeof(gMethods) / sizeof(gMethods[0]))) {
return JNI_FALSE;
}
return JNI_TRUE;
}
上述代码实现中,核心代码就一句
env->RegisterNatives(clazz, gMethods, numMethods)
在这里注册了函数的对应关系,其它的都是围绕这句代码展开的。
//函数对应关系数组
static JNINativeMethod gMethods[] = {{"stringFromJNI2", "()Ljava/lang/String;", (void *) stringFromJNI2}};
JNINativeMethod 是存储映射关系的一个结构体,第一个元素是java的方法名,第二个元素是java方法对应的方法签名,第三个是native实现函数的函数指针。
下面附带一张 JNI类型签名规则表
Java类型
类型签名
boolean
Z
byte
B
char
C
long
J
float
F
double
D
short
S
int
I
类
L全限定类名;
数组
[元素类型签名
两种方式的比较
传统的JNI编程方式,符合JNI规范,但其缺点也明显:
方法名固定,不能灵活配置,稍不注意写错了便会出错,编译时无法发现错误
虚拟机在so库中搜索定位Native实现方法,效率有一定影响,通过注册函数可以回避这个问题