Android JNI参数传递

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类型。