2.4.4 通过JNIEnv操作jobject

前面提到过一个问题，即Java的引用类型除了少数几个外，最终在JNI层都用jobject来表示对象的数据类型，那么该如何操作这个jobject呢？ 从另外一个角度来解释这个问题。一个Java对象是由什么组成的？当然是它的成员变量和成员函数了。那么，操作jobject的本质就应当是操作这些对象的成员变量和成员函数。所以应先来看与成员变量及成员函数有关的内容。 **（1）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为这个函数和变量的签名信息。如前所示，成员函数和成员变量都是类的信息，这两个函数的第一个参数都是jclass。 MS中是怎么使用它们的呢？来看代码，如下所示： **android_media_MediaScanner.cpp::MyMediaScannerClient构造函数** ~~~ MyMediaScannerClient(JNIEnv *env, jobjectclient)...... { //先找到android.media.MediaScannerClient类在JNI层中对应的jclass实例。 jclass mediaScannerClientInterface = env->FindClass("android/media/MediaScannerClient"); //取出MediaScannerClient类中函数scanFile的jMethodID。 mScanFileMethodID = env->GetMethodID( mediaScannerClientInterface, "scanFile", "(Ljava/lang/String;JJ)V"); //取出MediaScannerClient类中函数handleStringTag的jMethodID。 mHandleStringTagMethodID = env->GetMethodID( mediaScannerClientInterface,"handleStringTag", "(Ljava/lang/String;Ljava/lang/String;)V"); ...... } ~~~ 在上面代码中，将scanFile和handleStringTag函数的jmethodID保存为MyMediaScannerClient的成员变量。为什么这里要把它们保存起来呢？这个问题涉及一个事关程序运行效率的知识点： · 如果每次操作jobject前都去查询jmethoID或jfieldID的话将会影响程序运行的效率。所以我们在初始化的时候，就可以取出这些ID并保存起来以供后续使用。 取出jmethodID后，又该怎么用它呢？ **（2）使用jfieldID和jmethodID** 下面再看一个例子，其代码如下所示： ~~~ virtualbool scanFile(const char* path, long long lastModified, long long fileSize) { jstring pathStr; if((pathStr = mEnv->NewStringUTF(path)) == NULL) return false; /* 调用JNIEnv的CallVoidMethod函数，注意CallVoidMethod的参数： 第一个是代表MediaScannerClient的jobject对象， 第二个参数是函数scanFile的jmethodID，后面是Java中scanFile的参数。 */ mEnv->CallVoidMethod(mClient, mScanFileMethodID, pathStr, lastModified, fileSize); mEnv->DeleteLocalRef(pathStr); return (!mEnv->ExceptionCheck()); } ~~~ 明白了，通过JNIEnv输出的CallVoidMethod，再把jobject、jMethodID和对应参数传进去，JNI层就能够调用Java对象的函数了！ 实际上JNIEnv输出了一系列类似CallVoidMethod的函数，形式如下： ~~~ NativeType CallMethod(JNIEnv *env,jobject obj,jmethodID methodID, ...)。 ~~~ 其中type是对应Java函数的返回值类型，例如CallIntMethod、CallVoidMethod等。 上面是针对非static函数的，如果想调用Java中的static函数，则用JNIEnv输出的CallStaticMethod系列函数。 现在，我们已了解了如何通过JNIEnv操作jobject的成员函数，那么怎么通过jfieldID操作jobject的成员变量呢？这里，直接给出整体解决方案，如下所示： ~~~ //获得fieldID后，可调用GetField系列函数获取jobject对应成员变量的值。 NativeType GetField(JNIEnv *env,jobject obj,jfieldID fieldID) //或者调用SetField系列函数来设置jobject对应成员变量的值。 void SetField(JNIEnv *env,jobject obj,jfieldID fieldID,NativeType value) //下面我们列出一些参加的Get/Set函数。 GetObjectField() SetObjectField() GetBooleanField() SetBooleanField() GetByteField() SetByteField() GetCharField() SetCharField() GetShortField() SetShortField() GetIntField() SetIntField() GetLongField() SetLongField() GetFloatField() SetFloatField() GetDoubleField() SetDoubleField() ~~~ 通过本节的介绍，相信读者已了解jfieldID和jmethodID的作用，也知道如何通过JNIEnv的函数来操作jobject了。虽然jobject是透明的，但有了JNIEnv的帮助，还是能轻松操作jobject背后的实际对象了。