Android JNI参数传递

来源:互联网 发布:收集类单机游戏知乎 编辑:程序博客网 时间:2024/05/22 03:05

Java中调用native函数传递的参数是Java数据类型,到了JNI层需进行数据类型转换,基本数据类型是在前面加个j,如int——>jint,应用数据类型除了基本数据类型的数据、Class、String和Throwable外,其余所有Java对象的数据类型在JNI中都用jobject表示。

//Java层com.xxx.yyy包MyJni.java中的jnitest有三个参数jnitest(String path, String name, MyJni mj);//JNI层对应的函数的后三个参数与jnitest的参数对应com_xxx_yyy_MyJni_jnitest(JNIEnv *env, jobject thiz, jstring path, jstring name, jobject mj);

若对象类型都用就object表示,就好比是native层的void* 类型一样。第二个参数就object代表Java层的实例对象,如果Java层是static函数,则这个参数将是jclass,表示在调用哪个Java Class的静态函数。

JNIEnv介绍

JNIEnv是一个与线程相关的代表JNI环境的结构体,内部结构如图:

这里写图片描述

从上图可知JNIEnv提供了一些JNI系统函数:

  • 调用Java的函数
  • 操作jobejct对象等很多事情

每个线程都有一个JNIEnv,由于线程相关,所以一个线程不能使用另一个线程的JNIEnv结构体。JNIEnv是native函数转换成JNI层函数后有虚拟机传进来的,但当后台线程收到一个网络消息,且需有native层函数主动回调Java层函数时,JNIEnv如何传递?

这就要用到JavaVM,它是虚拟机在JNI层的代表,如下:

//全进程只有一个JavaVM对象,可保存且在任何地方都可使用jint JNI_OnLoad(JavaVM* vm, void* reserved);

而JavaVM 和 JNIEnv的关系如下:

  • 调用JavaVM的AttachCurrentThread函数,就可得到这个线程的JNIEnv结构体,即可在后台回调Java函数。
  • 在后台线程退出前,需调用JavaVM的DetachCurrentThread函数释放对应的资源。

通过JNIEnv操作jobject

Java引用类型除了少数几个外,其余在JNI层都会用jobject来表示对象的数据类型,操作jobject的本质是操作Java对象的成员变量和成员函数。
jfieldID 和 jmethodID 介绍
JNI规则中用jfieldID 和 jmethodID表示Java类的成员变量和成员函数,可通过JNIEnv的函数得到:
jfieldID GetFieldID(jclass clazz, const char *name, const char *sig);jmethodID GetMethodID(jclass clazz, const char *name, const char *sig);
其中,jclass表示Java类,name表示成员函数或成员变量的名字,sig为这个函数和变量的签名信息。使用方法如下:
MyJni(JNIEnv *env, jobject mj)......{  //先找到com.xxx.yyy.MyJni类在JNI层中对应的jclass实例。  jclass myJniInterface = env->FindClass("com.xxx.yyy.MyJni");  //取出MyJni类中函数jnitest的jMethodID。  mMyJniMethodID = env->GetMethodID(myJniInterface, "jnitest", "(Ljava/lang/String;JJ)V");  //取出MyJni类中函数jnitest1的jMethodID。  mJniTestMethodID = env->GetMethodID(myJniInterface, "jnitest1",   "(Ljava/lang/String;Ljava/lang/String;)V");
如果每次操作jobject前都去查询jmethodID或jfieldID,将会影响程序的运行效率,故在初始化时可取出ID并保存起来供后续使用。

使用jfieldID 和 jmethodID

实例代码如下:
virtual bool myjni(const char* path, long long lastModified, long long fileSize){  jstring pathstr;  if ((pathStr = mEnv->NewStringUTF(path)) == NULL)      return;  /*  调用JNIEnv的CallVoidMethod函数,注意CallVoidMethod的参数:  第一个是MyJni的jobject对象,  第二个是函数myjni的jmethodID,后面是Java中myjni的参数  */  mEnv->CallVoidMethod(mClient, mMyJniMethodID, pathStr, lastModified, fileSize);  mEnv->DeleteLocalRef(pathStr);  return (!mEnv->ExceptionCheck());
通过JNIEnv输出CallVoidMethod,再把jobject、jMethodID和对应的参数传进去,JNI层就能调用Java对象的函数。
实际上JNIEnv输出一系列类似CallVoidMethod的函数,形式如下:
NativeType Call<type>Method(JNIEnv *env, jobject obj, jmethodID methodID, ...)
其中type对应Java函数的返回值类型,例如CallIntMethod、CallVoidMethod等。
上面是针对非static函数,如果调用Java的static函数,则用JNIEnv输出的CallStatic< Type>Method系列函数。
通过jfieldID操作jobject的成员变量,如下:
//获得filedID可调用Get<type>Field系列函数获取jobject对应的成员变量值nativeType Get<type>Field(JNIEnv *env, jobject obj, jfieldID fieldID)//或调用Set<type>Field系列函数设置jobject对应的成员变量值void Set<type>Field(JNIEnv *env, jobject obj, jfield fieldID, NativeType value)

JNI类型签名介绍

static JNINativeMethod gMethods[] = {    ......    {    "processFile"    "(Ljava/lang/String;Ljava/lang/String;Landroid/media/MyJni;)V",     (void*)com_xxx_yyy_MyJni    },    ......    }
代码中字符串”(Ljava/lang/String;Ljava/lang/String;Landroid/media/MyJni;)V”是Java中对应函数的签名信息,有参数类型和返回值类型共同组成。Java支持函数重载,可定义同名但不同参数的函数,进根据函数名无法找到具体函数,故JNI技术中将参数类型和返回值类型作为函数的签名信息。
JNI规范定义的函数签名信息格式:
(参数1类型标示参数2类型标示...参数n类型标示)返回值类型标示
“(Ljava/lang/String;Ljava/lang/String;Landroid/media/MyJni;)V”,其中括号内是参数类型的标识,最右边是返回值类型的标识,void类型对应的标识是V。当参数的类型是引用类型时,其格式是“L包名;”,其中包名中的“.”换成“/”。Ljava/lang/String表示是一个Java的String类型。
1 0