Android JNI和NDK学习(07)--JNI的常用API
1 版本和类操作API
2 对象域相关API
2.1 GetFieldID
jfieldID GetFieldID(JNIEnv *env, jclass clazz, const char *name, const char *sig);
函数作用：
返回类的实例(非静态)域的域 ID。
参数说明：
env:JNI 接口指针。
clazz:Java 类对象。
name: 0 终结的 UTF-8 字符串中的域名。
sig:0 终结的 UTF-8 字符串中的域签名。
2.2 Set<type>Field
void Set<type>Field(JNIEnv *env, jobject obj, jfieldID fieldID, NativeType value);
函数作用：
该访问器例程系列设置对象的实例(非静态)域的值。要访问的域由通过调用SetFieldID() 而得到的域 ID 指定。
参数说明：
env:JNI 接口指针。
obj:Java 对象(不能为 NULL)。
fieldID:有效的域 ID。
value:域的新值。
<type>可以是Boolean、Char等类型，所有的Set<type>Field参考下面的函数：
void (*SetObjectField)(JNIEnv*, jobject, jfieldID, jobject);
void (*SetBooleanField)(JNIEnv*, jobject, jfieldID, jboolean);
void (*SetByteField)(JNIEnv*, jobject, jfieldID, jbyte);
void (*SetCharField)(JNIEnv*, jobject, jfieldID, jchar);
void (*SetShortField)(JNIEnv*, jobject, jfieldID, jshort);
void (*SetIntField)(JNIEnv*, jobject, jfieldID, jint);
void (*SetLongField)(JNIEnv*, jobject, jfieldID, jlong);
void (*SetFloatField)(JNIEnv*, jobject, jfieldID, jfloat);
void (*SetDoubleField)(JNIEnv*, jobject, jfieldID, jdouble);
2.3 Get<type>Field
NativeType Get<type>Field(JNIEnv *env, jobject obj, jfieldID fieldID);
函数作用：
该访问器例程系列返回对象的实例(非静态)域的值。要访问的域由通过调用GetFieldID() 而得到的域 ID 指定。
参数说明：
env:JNI 接口指针。
obj:Java 对象(不能为 NULL)。
fieldID:有效的域 ID。
<type>可以是Boolean、Char等类型，所有的Get<type>Field参考下面的函数
jboolean (*GetBooleanField)(JNIEnv*, jobject, jfieldID); jbyte (*GetByteField)(JNIEnv*, jobject, jfieldID); jchar (*GetCharField)(JNIEnv*, jobject, jfieldID); jshort (*GetShortField)(JNIEnv*, jobject, jfieldID); jint (*GetIntField)(JNIEnv*, jobject, jfieldID); jlong (*GetLongField)(JNIEnv*, jobject, jfieldID); jfloat (*GetFloatField)(JNIEnv*, jobject, jfieldID); jdouble (*GetDoubleField)(JNIEnv*, jobject, jfieldID);
3 字符串操作API
4 数组常用API
4.1 GetArrayLength
jsize (*GetArrayLength)(JNIEnv*, jarray);
函数作用：返回数组中的元素数。
4.2 GetObjectArrayElement
jobject (*GetObjectArrayElement)(JNIEnv*, jobjectArray, jsize);
函数作用：返回 Object 数组的元素。
4.3 SetObjectArrayElement
void (*SetObjectArrayElement)(JNIEnv*, jobjectArray, jsize, jobject);
函数作用：设置 Object 数组的元素。
4.4 Get<PrimitiveType>ArrayRegion
void Get<PrimitiveType>ArrayRegion(JNIEnv *env, ArrayType array, jsize start, jsize len, NativeType *buf);
函数作用：
将基本类型数组某一区域复制到缓冲区中的一组函数。
参数说明：
env:JNI 接口指针。
array:Java 指针。
start:起始下标。
len:要复制的元素数。
buf:目的缓冲区。
<PrimitiveType>可以是Boolean、Char等类型，所有的Get<PrimitiveType>ArrayRegion参考下面的函数:
void (*GetBooleanArrayRegion)(JNIEnv*, jbooleanArray, jsize, jsize, jboolean*);
void (*GetByteArrayRegion)(JNIEnv*, jbyteArray, jsize, jsize, jbyte*);
void (*GetCharArrayRegion)(JNIEnv*, jcharArray, jsize, jsize, jchar*);
void (*GetShortArrayRegion)(JNIEnv*, jshortArray, jsize, jsize, jshort*);
void (*GetIntArrayRegion)(JNIEnv*, jintArray, jsize, jsize, jint*);
void (*GetLongArrayRegion)(JNIEnv*, jlongArray, jsize, jsize, jlong*);
void (*GetFloatArrayRegion)(JNIEnv*, jfloatArray, jsize, jsize, jfloat*);
void (*GetDoubleArrayRegion)(JNIEnv*, jdoubleArray, jsize, jsize, jdouble*);
4.5 Set<PrimitiveTyep>ArrayRegion
void Set<PrimitiveType>ArrayRegion(JNIEnv *env, ArrayType array, jsize start, jsize len, NativeType *buf);
函数作用：
将基本类型数组的某一区域从缓冲区中复制回来的一组函数。
参数说明：
Env:JNI 接口指针。
array:
Java 数组。
start:起始下标。
len:要复制的元素数。
buf:源缓冲区。
<PrimitiveType>可以是Boolean、Char等类型，所有的Set<PrimitiveType>ArrayRegion参考下面的函数:
void (*SetBooleanArrayRegion)(JNIEnv*, jbooleanArray, jsize, jsize, const jboolean*);
void (*SetByteArrayRegion)(JNIEnv*, jbyteArray, jsize, jsize, const jbyte*);
void (*SetCharArrayRegion)(JNIEnv*, jcharArray, jsize, jsize, const jchar*);
void (*SetShortArrayRegion)(JNIEnv*, jshortArray, jsize, jsize, const jshort*);
void (*SetIntArrayRegion)(JNIEnv*, jintArray, jsize, jsize, const jint*);
void (*SetLongArrayRegion)(JNIEnv*, jlongArray, jsize, jsize, const jlong*);
void (*SetFloatArrayRegion)(JNIEnv*, jfloatArray, jsize, jsize, const jfloat*);
void (*SetDoubleArrayRegion)(JNIEnv*, jdoubleArray, jsize, jsize, const jdouble*);
更详细内容，请参考“JNI完全手册”
