Android JNI开发摘录（三）之JNI中的Java对象

     四 JNI中的Java对象

    Java本机接口提供了一个函数集来处理Java对象（使用方法/域）、句柄异常和用于线程的数据同步。这些函数在本机提供更好的访问Java对象的能力，允许用于更复杂的应用程序。这些函数的用法之一是被用来产生一个Java方法的回调，或者产生通信信息的回调。

     1.访问JNI中的域

     在Java类中有两种成员变量类型：静态域，它们属于类；非静态域，它们属于单个对象。为了可以访问一个域，必须向GetFieldID或GetStaticFieldID传递一个域描述符以及域的名称。域描述符是完整描述域类型的一个或多个字符。例如，域int的域描述符是I。用于数组的域描述符是以字符 [ 为前缀，用于数组的每一维。例如，int[]的域描述符是[I，int[][]的域描述符是[[I。对于引用类型，使用了类的完整限制符名称，但是点号被正斜杠替换，描述符将在开始被一个L，在结尾被一个分号所包围。例如，类型java.lang.Integer的域描述符是Ljava/lang/Integer。基本类型域描述符如下表：

基本类型	域描述符
boolean	Z
byte	B
char	C
short	S
int	I
long	J
float	F
double	D

       2.访问域的函数

       (1).下面的函数向指定域返回一个句柄，以便用于Get以及Set函数。GetObjectClass函数可以用来获取一个适合于该函数第一个参数的jclass。name是域的名称，sig是域描述符。如果函数失败，返回NULL：

jfieldID GetFieldID(jclass clazz, const char *name, const char *sig);

     

      (2).下面的函数返回属于Java对象obj的，被fieldID指定的一个特定域：

[NativeType] Get[Type]Field(jobject obj, jfieldID fieldID);

     (3).SetField函数将属于Java对象obj的，被fieldID指定的一个特定域的值设置为val：

void Set[Type]Field(jobject obj,jfieldID fieldID, [NativeType] val);

    (4)GetStaticFieldID函数同GetFieldID函数功能相同，但它用于获取一个静态域的句柄：

jfieldID GetStaticFieldID(jclass clazz,const char *name, const char *sig);

    (5)GetStaticField函数返回属于clazz描述的类，fieldID指定的一个静态域的值：

[NativeType] GetStatic[Type]Field(jclass clazz,jfieldID fieldID);

    (6).SetStaticField函数设置属于clazz描述的类，fieldID指定一个静态域的值：

void SetStatic[Type]Field(jclass clazz, jfieldID fieldID, [NativeType] value);

    3.使用JNI调用Java方法

    使用JNI可以调用Java中的静态及非静态方法，这时需要使用方法的名称和方法描述符来获得特定Java方法的句柄，然后才能通过CallMethod函数调用该Java方法。

    方法描述符通过将所有方法的参数类型放置到一个单一圆括号集中，然后在圆括号之后指定返回类型而形成。用于参数的类型以及返回类型使用在前面描述过的域描述符。如果方法返回void，则描述符就是V。若方法没有任何参数，则圆括号中为空。用于熟悉的main方法的方法描述符是([Ljava/lang/String;)V。如果希望调用构造函数，使用方法名<init>，对于静态构造函数，则使用<clinit>。

    JNI调用Java方法的步骤：

     获取方法和变量描述符的编译命令：javap -s -classpath . [PacketName+"."+Library Name]  如：javap -s -classpath . com.example.MyProject.MyLibrary

    (1).获取要调用方法所在的类：

jclass GetObjectClass(jobject obj);

   (2).通过jclass获取要调用的方法的methodID，即方法句柄：

/**

*使用步骤(1)获取的jclass

*方法名称

*方法描述符

*/

jmethod GetMethodID(jclass clazz,const char *name,const char *sig);

jmethod GetStaticMethodID(jclass clazz,const char* name,const char *sig);

    (3).通过方法句柄调用方法，注意：如果希望调用一个构造函数或一个私有方法，方法ID将会基于实际对象的类获得，而不是基于对象的一个超类。

    

/**

*java环境传入的jobject

*方法句柄

*/参数:接受大量参数，并将这些参数直接传送到Java方法中

[NativeType] Call[Type]Method(jobject obj, jmethodID methodID,…);

/**

*该方法将参数列表作为一个va_list结构接受，该结构是随同参数列

*表预包装的。

*/

[NativeType] Call[Type]MethodV(jobject obj,jmethodID methodID，va_list args);

/**

*该方法将参数作为一个jvalue数组接受，它是可以使用任意本机数据*类型版本的Java数据类型形式的一个联合(union)，包括jobject。

*/

[NativeType] Call[Type]MethodA(jobject obj, jmethodID methodID, const jvalue *args);

 

/**

*下面三个方法也调用对象方法的一个实例，但是调用的Java方法是

*基于jclass数的。这些函数可以在对象的层次结构中调用一个指定的方法，而不是仅仅基于对象的类调用一个方法。

*jclass应通过传入要调用的方法所在的类的实例来获得。

*/

[NativeType] CallNonvirtual[Type]Method(jobject obj, jclass clazz, jmethodID methodID, …);

 

[NativeType]  CallNonvirtual[Type]MethodV(jobject obj, jclass clazz, jmethodID methodID, va_list args);

 

[NativeType]  CallNonvirtual[Type]MethodA(jobject obj, jclass clazz, jmethodID methodID, const jvalue *args);

 

 

/**

*下面的函数调用属于传入的clazz类的一个静态方法。使用Get

*StaticMethodID来获得方法句柄。

*/

[NativeType] CallStatic[Type]Method(jclass clazz, jmethodID methodID, …);

 

[NativeType]  CallStatic[Type]MethodV(jclass clazz, jmethodID methodID, va_list args);

 

[NativeType]  CallStatic[Type]MethodA(jclass clazz, jmethodID methodID, const jvalue *args);