黑夜汉化组奉子快递6:Android jni常用方法备忘

有关Android JNI开发中比较强大和有用的功能就是从JNI层创建、构造Java的类或执行Java层的方法获取属性等操作。
一、类的相关操作
1. jclass FindClass(JNIEnv *env, const char *name); 查找类
该函数可能做过Java开发的不会陌生，这个是JNI层的实现，需要注意的是第二个参数为const char*类型的，我们如果从Java从层传入unicode编码的jstring类型需要使用GetStringUTFChars函数转换成utf8的 const char*，如果成功返回这个Java类的对象jclass，相关的异常可能有(1. ClassFormatError 类的数据格式无效
(2. ClassCircularityError 该类或接口是自身的超类或超接口
(3. NoClassDefFoundError 没有找到指定名称的类或接口
(4. OOM内存不足错误，即OutOfMemoryError
2. jclass GetSuperclass(JNIEnv *env, jclass clazz); 获取父类或者说超类
该函数的第二个参数为jclass类，我们调用时传入的是子类，否则返回将是NULL
3. jboolean IsAssignableFrom(JNIEnv *env, jclass clazz1,jclass clazz2); 判断class1对象能否安全的强制转换为class2对象
如果可以将返回 JNI_TRUE，JNI_TRUE的定义值为1，否则返回JNI_FALSE即0 ，这里Android123详细说明下哪些情况可能返回真:
(1 这两个类参数引用同一个 Java 类
(2 第一个类是第二个类的子类
(3 第二个类是第一个类的某个接口
4. jclass GetObjectClass(JNIEnv *env, jobject obj); 通过对象获取这个类
该函数比较简单，唯一注意的是对象不能为NULL，否则获取的class肯定返回也为NULL。
5. jboolean IsInstanceOf(JNIEnv *env, jobject obj,jclass clazz); 判断对象是否为某个类的实例
这个函数是JNI层的实现，相信大家都不陌生，Android开发网提醒大家需要注意的是返回值可能产生异议，就是如果传入的第二个参数为NULL对象，NULL对象可以强制转换为各种类，所以这种情况也将会返回JNI_TRUE，所以一定判断传入的对象是否为空。
6. jboolean IsSameObject(JNIEnv *env, jobject ref1,jobject ref2); 判断两个对象是否引用同一个类
需要注意的是如果两个对象均为空，返回的值也会是JNI_TRUE所以使用时判断对象为空。
二、调用Java方法
首先说下有关签名sig相关的比如 “Ljava/lang/String;”
1. jmethodID GetMethodID(JNIEnv *env, jclass clazz,const char *name, const char *sig); 获取一个Java方法的ID
这个函数将返回非静态类或接口实例方法的方法 ID。这个方法可以是某个clazz 的超类中定义，也可从clazz 继承，最后一个参数为签名，最后两个参数是const char*类型，是utf8类型。需要注意的是Android123提醒大家执行GetMethodID()函数将导致未初始化的类初始化，如果要获得构造函数的方法ID，使用 作为方法名，同时将 void (V) 作为返回类型，如果找不到指定的ID将返回NULL，同时异常可能有:
(1 NoSuchMethodError 找不到指定的Java方法。
(2 ExceptionInInitializerError 如果由于异常而导致类初始化程序失败
(3 OutOfMemoryError 内存不足
2 . NativeType CallXXXMethod (JNIEnv *env, jobject obj,jmethodID methodID, va_list args); 调用XXX类型的Java方法
执行Java类中某个方法，需要注意的是这个里的java类是非静态的，由于Java的方法的类型比较多，所以该函数可能有以下几种形式，如 CallObjectMethod,CallBooleanMethod,CallByteMethod,CallCharMethod,CallShortMethod,CallIntMethod,CallLongMethod,CallFloatMethod,CallDoubleMethod 和CallVoidMethod,需要注意的是，该函数的第三个参数为通过GetMethodID函数获取的方法ID,最后一个参数为这个方法的参数表，最后的va_list宏可以通过搜索获取具体的使用方法，这里Android开发网不再赘述。
3.NativeType CallNonvirtualXXXMethod (JNIEnv *env, jobject obj,jclass clazz, jmethodID methodID, jvalue *args);
CallNonvirtualXXXMethod函数和上面的CallXXXMethod 不同之处是多了一个jclass参数，CallXXXMethod是根据对象来调用方法，而CallNonvirtualXXXMethod是根据类的实例调用，区别在这点。
上面的三个均为非静态类的获取，执行调用，需要实例化这个类才可以执行，下面的为静态调用。
4. jmethodID GetStaticMethodID(JNIEnv *env, jclass clazz,const char *name, const char *sig);
5. NativeType CallStaticXXXMethod(JNIEnv *env, jclass clazz,jmethodID methodID, …);
三、访问Java对象的域
Java对象的域或者说字段、属性(Field) 类似方法的执行
1. jfieldID GetFieldID(JNIEnv *env, jclass clazz,const char *name, const char *sig); 获取实例对象的域ID
需要注意的是，非静态的实例化后的对象，可能产生的异常有
(1 NoSuchFieldError 找不到指定的域
(2 ExceptionInInitializerError 因为异常而导致类初始化失败
(3 OutOfMemoryError内存不足。
2. NativeType GetXXXField(JNIEnv *env, jobject obj,jfieldID fieldID);
类似GetXXXMethod函数，可能有的类型有 GetObjectField,GetBooleanField,GetByteField,GetCharField,GetShortField,GetIntField,GetLongField,GetFloatField,GetDoubleField。
3. void SetXXXField(JNIEnv *env, jobject obj, jfieldID fieldID,NativeType value);
Java的域可以赋值的，可能有的类型有 SetObjectField,SetBooleanField,SetByteField,SetCharField,SetShortField,SetIntField,SetLongField,SetFloatField,SetDoubleField。
上面3种情况均为非静态对象的域，对于不需要实例化对象的域，可以直接使用下面的。
4. jfieldID GetStaticFieldID(JNIEnv *env, jclass clazz,const char *name, const char *sig);
5. NativeType GetStaticXXXField(JNIEnv *env, jclass clazz,jfieldID fieldID);
6. void SetStaticXXXField(JNIEnv *env, jclass clazz,jfieldID fieldID, NativeType value);