2.4.4　通过JNIEnv操作jobject

前面提到过一个问题，即Java的引用类型除了少数几个外，最终在JNI层都会用jobject来表示对象的数据类型，那么该如何操作这个jobject呢？

从另外一个角度来解释这个问题。一个Java对象是由什么组成的？当然是它的成员变量和成员函数了。那么，操作jobject的本质就应当是操作这些对象的成员变量和成员函数。所以应先来看与成员变量及成员函数有关的内容。

1.jfieldID和jmethodID介绍

我们知道，成员变量和成员函数都是由类定义的，它们是类的属性，所以在JNI规则中，用jfieldID和jmethodID来表示Java类的成员变量和成员函数，可通过JNIEnv的下面两个函数得到：

jfieldID GetFieldID（jclass clazz,const charname,const charsig）；

jmethodID GetMethodID（jclass clazz,const charname,const charsig）；

其中，jclass代表Java类，name表示成员函数或成员变量的名字，sig为这个函数和变量的签名信息。如前所示，成员函数和成员变量都是类的信息，这两个函数的第一个参数都是jclass。

在MS中是怎么使用它们的呢？来看代码，如下所示：

[—＞android_media_MediaScanner.cpp：MyMediaScannerClient构造函数]

MyMediaScannerClient（JNIEnv*env,jobject client）……

{

//先找到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前都去查询jmethodID或jfieldID，那么将会影响程序运行的效率，所以我们在初始化的时候可以取出这些ID并保存起来以供后续使用。

取出jmethodID后，又该怎么用它呢？

2.使用jfieldID和jmethodID

下面再看一个例子，其代码如下所示：

[—＞android_media_MediaScanner.cpp：MyMediaScannerClient的scanFile]

virtual bool 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 Call＜type＞Method（JNIEnv*env,jobject obj,jmethodID methodID，……）。

其中type对应Java函数的返回值类型，例如CallIntMethod、CallVoidMethod等。

上面是针对非static函数的，如果想调用Java中的static函数，则用JNIEnv输出的CallStatic＜Type＞Method系列函数。

现在，我们已了解了如何通过JNIEnv操作jobject的成员函数，那如何通过jfieldID操作jobject的成员变量呢？这里，直接给出整体解决方案，如下所示：

//获得fieldID后，可调用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,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背后的实际对象的。