JNI规范定义了一系列在Native代码中访问Java对象及其成员与方法的API。下面我们还是通过示例来具体讲解。首先,新建一个SayHello 的类,代码如下:
package com.example.hellojni;
public class SayHello {
public String sayHelloFromJava(String nativeMsg) {
String str = nativeMsg + " But shown in Java!" ;
return str;
}
}
接下来要实现的就是在Native代码中调用这个
SayHello 类中的sayHelloFromJava方法。
一般来说,要在Native代码中访问Java对象,有如下几个步骤:
1.得到该Java对象的类定义。JNI定义了
jclass 这个类型来表示Java的类的定义,并提供了FindClass接口,根据类的完整的包路径即可得到其
jclass 。
2.根据
jclass 创建相应的对象实体,即
jobject 。在Java中,创建一个新对象只需要使用
new 关键字即可,但在Native代码中创建一个对象则需要两步:首先通过JNI接口GetMethodID得到该类的构造函数,然后利用NewObject接口构造出该类的一个实例对象。
3.访问
jobject 中的成员变量或方法。访问对象的方法是先得到方法的Method ID,然后使用Call<
Type>Method 接口调用,这里Type对应相应方法的返回值——返回值为基本类型的都有相对应的接口,如CallIntMethod;其他的返回值(包括String) 则为CallObjectMethod。可以看出,创建对象实质上是调用对象的一个特殊方法,即构造函数。访问成员变量的步骤一样:首先 GetFieldID得到成员变量的ID,然后Get/Set<
Type>Field读/写变量值。
上面概要介绍了从Native代码中访问Java对象的过程,下面我们结合示例来具体看一下。如下是调用sayHelloFromJava方法的Native代码:
jstring helloFromJava( JNIEnv* env ) {
jstring str = NULL;
jclass clz = (*env)->FindClass(env, "com/example/hellojni/SayHello" );
jmethodID ctor = (*env)->GetMethodID(env, clz, "<init>" , "()V" );
jobject obj = (*env)->NewObject(env, clz, ctor);
jmethodID mid = (*env)->GetMethodID(env, clz, "sayHelloFromJava" , "(Ljava/lang/String;)Ljava/lang/String;" );
if (mid) {
jstring jmsg = (*env)->NewStringUTF(env, "I'm born in native." );
str = (*env)->CallObjectMethod(env, obj, mid, jmsg);
}
return str;
}
可以看到,上述代码和前面讲到的步骤完全相符。这里提一下编程时要注意的要点:1、FindClass要写明Java类的完整包路径,并将 “.”以“/”替换;2、GetMethodID的第三个参数是方法名(对于构造函数一律用“<init>”表示),第四个参数是方法的“签 名”,需要用一个字符串序列表示方法的参数(依声明顺序)和返回值信息。由于篇幅所限,这里不再具体说明如何根据方法的声明构造相应的“签名”,请参考 JNI的相关文档。
关于上面谈到的步骤再补充说明一下:在JNI规范中,如上这种使用NewObject创建的对象实例被称为“Local Reference”,它仅在创建它的Native代码作用域内有效,因此应避免在作用域外使用该实例及任何指向它的指针。如果希望创建的对象实例在作用 域外也能使用,则需要使用NewGlobalRef接口将其提升为“Global Reference”——需要注意的是,当Global Reference不再使用后,需要显式的释放,以便通知JVM进行垃圾收集。