JNI学习积累之一 ---- 常用函数大全

花了几天时间研究了下JNI,基本上知道如何使用了。照我的观点JNI还是不难的,难得只是我们一份尝试的心。 学习过程中,
发现关于JNI函数资料真的很少,所谓“工欲善其事,便先利其器”,整理出了这份资料,希望能帮助你克服JNI学习的坎。

  主要资料来源: 百度文库的**《**[**JNI常用函数》**](http://wenku.baidu.com/view/2853bc262f60ddccda38a00d.html) 。
  同时对其加以了补充 。

要素 :1、 该函数大全是基于C语言方式的,对于C++方式可以直接转换 ,例如,对于生成一个jstring类型的方法转换分别如下:
C编程环境中使用方法为:(env) ->NewStringUTF(env , "123") ;*
C++编程环境中(例如,VC下)则是:** env ->NewStringUTF( "123") ; ** (使用起来更简单)

       2、关于下列有些函数中:*isCopy     的说明,例如,如下函数:                     
                        const char* **GetStringUTFChars**(JNIEnv*env, jstring string, jboolean *isCopy);  

    对第三个参数 jboolean *isCopy说明如下:
         当从JNI函数GetStringUTFChars函数中返回得到字符串B时,如果B是原始字符串[Java](http://lib.csdn.net/base/javase).lang.String的一份拷贝,
  则isCopy  被赋值为JNI_TRUE。如果B是和原始字符串指向的是JVM中的**同一份数据**,则isCopy  被赋值为JNI_FALSE。
 当isCopy  为JNI_FALSE时,本地代码绝不能修改字符串的内容,否则JVM中的原始字符串也会被修改,这会打破Java语言
  中字符串不可变的规则。
        通常,我们不必关心JVM是否会返回原始字符串的拷贝,只需要为isCopy传递NULL作为参数 。
                                                                                                       ----     以上内容来自 **《JNI编程指南》**

**一、类操作 **

jclass **DefineClass **(JNIEnv *env, jobject loader, const jbyte *buf , jsize bufLen);
功能:从原始类数据的缓冲区中加载类。
参数: env JNI 接口指针。
loader 分派给所定义的类的类加载器。
buf 包含 .class 文件数据的缓冲区。
bufLen 缓冲区长度。
返回值:返回 Java 类对象。如果出错则返回NULL。
抛出: ClassFormatError 如果类数据指定的类无效。
ClassCircularityError 如果类或接口是自身的超类或超接口。
OutOfMemoryError 如果系统内存不足。

jclass **FindClass **(JNIEnv *env, const char *name);
功能: 该函数用于加载本地定义的类。它将搜索由CLASSPATH 环境变量为具有指定名称的类所指定的目录和 zip文件。
参数:env JNI 接口指针。
name 类全名(即包名后跟类名,之间由"/"分隔).如果该名称以“[(数组签名字符)打头,则返回一个数组类。
返回值:返回类对象全名。如果找不到该类,则返回 NULL。
抛出: ClassFormatError 如果类数据指定的类无效。
ClassCircularityError 如果类或接口是自身的超类或超接口。
NoClassDefFoundError 如果找不到所请求的类或接口的定义。
OutOfMemoryError 如果系统内存不足。

jclass **GetObjectClass **(JNIEnv *env, jobject obj);
功能:通过对象获取这个类。该函数比较简单,唯一注意的是对象不能为NULL,否则获取的class肯定返回也为NULL。
参数: env JNI 接口指针。
obj Java 类对象实例。

jclass **GetSuperclass **(JNIEnv *env, jclass clazz);
功能:获取父类或者说超类 。 如果 clazz 代表类class而非类 object,则该函数返回由 clazz 所指定的类的超类。 如果 clazz
指定类 object 或代表某个接口,则该函数返回NULL。
参数: env JNI 接口指针。
clazz Java 类对象。
返回值: 由 clazz 所代表的类的超类或 NULL。

jboolean **IsAssignableFrom **(JNIEnv *env, jclass clazz1, jclass clazz2);
功能:确定 clazz1 的对象是否可安全地强制转换为clazz2。
参数: env JNI 接口指针。
clazz1 第一个类参数。
clazz2 第二个类参数。
返回值: 下列某个情况为真时返回 JNI_TRUE:
1、 第一及第二个类参数引用同一个 Java 类。
2、 第一个类是第二个类的子类。
3、 第二个类是第一个类的某个接口。

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

二**、异常操作 **

jint Throw(JNIEnv *env, jthrowable obj);
功能:抛出 java.lang.Throwable 对象。
参数: env JNI 接口指针。
obj java.lang.Throwable 对象。
返回值: 成功时返回 0,失败时返回负数。
抛出: java.lang.Throwable 对象 obj。

jint **ThrowNew **(JNIEnv *env , jclass clazz, const char *message);
功能:利用指定类的消息(由 message 指定)构造异常对象并抛出该异常。
参数: env JNI 接口指针。
clazz java.lang.Throwable 的子类。
message 用于构造java.lang.Throwable对象的消息。
返回值: 成功时返回 0,失败时返回负数。
抛出: 新构造的 java.lang.Throwable 对象。

jthrowable **ExceptionOccurred **(JNIEnv *env);
功能:确定是否某个异常正被抛出。在平台相关代码调用 ExceptionClear() 或 Java 代码处理该异常前,异常将始终保持
抛出状态。
参数: env JNI 接口指针。
返回值: 返回正被抛出的异常对象,如果当前无异常被抛出,则返回NULL。

void **ExceptionDescribe **(JNIEnv *env);
功能:将异常及堆栈的回溯输出到系统错误报告信道(例如 stderr)。该例程可便利调试操作。
参数:env JNI 接口指针。

void **ExceptionClear **(JNIEnv *env);
功能:清除当前抛出的任何异常。如果当前无异常,则此例程不产生任何效果。
参数: env JNI 接口指针。

void **FatalError **(JNIEnv *env, const char *msg);
功能:抛出致命错误并且不希望虚拟机进行修复。该函数无返回值。
参数: env JNI 接口指针。
msg 错误消息。

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

三、全局及局部引用

jobject **NewGlobalRef **(JNIEnv *env, jobject obj);
功能:创建 obj 参数所引用对象的新全局引用。obj 参数既可以是全局引用,也可以是局部引用。全局引用通过调用
DeleteGlobalRef() 来显式撤消。
参数:env JNI 接口指针。
obj 全局或局部引用。
返回值: 返回全局引用。如果系统内存不足则返回 NULL。

void **DeleteGlobalRef **(JNIEnv *env, jobject globalRef);
功能: 删除 globalRef 所指向的全局引用。
参数: env JNI 接口指针。
globalRef 全局引用。

void **DeleteLocalRef **(JNIEnv *env, jobject localRef);
功能: 删除 localRef所指向的局部引用。
参数: env JNI 接口指针。
localRef 局部引用。

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

**四、对象操作 **

jobject **AllocObject **(JNIEnv *env, jclass clazz);
功能:分配新 Java 对象而不调用该对象的任何构造函数。返回该对象的引用。clazz 参数务必不要引用数组类。
参数: env JNI 接口指针。
clazz Java 类对象。
返回值: 返回 Java 对象。如果无法构造该对象,则返回NULL。
抛出: InstantiationException:如果该类为一个接口或抽象类。
OutOfMemoryError:如果系统内存不足。

jobject **NewObject **(JNIEnv *env , jclass clazz, jmethodID methodID, ...); //参数附加在函数后面
jobject **NewObjectA **(JNIEnv env , jclassclazz, jmethodID methodID, jvalue args); //参数以指针形式附加
jobjec t
NewObjectV **(JNIEnv *env , jclassclazz, jmethodID methodID, va_list args); //参数以"链表"形式附加

功能:构造新 Java 对象。方法 ID指示应调用的构造函数方法。注意:该 ID特指该类class的构造函数ID , 必须通过调用
GetMethodID() 获得,且调用时的方法名必须为 <init>,而返回类型必须为 void (V)。clazz参数务必不要引用数组类。
参数: env JNI 接口指针。
clazz Java 类对象。
methodID 构造函数的方法 ID。
NewObject 的其它参数: 传给构造函数的参数,可以为空 。
NewObjectA 的其它参数: args:传给构造函数的参数数组。
NewObjectV 的其它参数: args:传给构造函数的参数 va_list。

返回值: 返回 Java 对象,如果无法构造该对象,则返回NULL。
抛出: InstantiationException 如果该类为接口或抽象类。
OutOfMemoryError 如果系统内存不足。
构造函数抛出的任何异常。

jclass **GetObjectClass **(JNIEnv *env, jobject obj);
功能:返回对象的类。
参数: env JNI 接口指针。
obj Java 对象(不能为 NULL)。
返回值: 返回 Java 类对象。

jboolean **IsInstanceOf **(JNIEnv *env, jobject obj, jclass clazz);
功能:测试对象是否为某个类的实例。
参数: env JNI 接口指针。
obj Java 对象。
clazz Java 类对象。
返回值:如果可将 obj 强制转换为 clazz,则返回 JNI_TRUE。否则返回 JNI_FALSE。NULL 对象可强制转换为任何类。

jboolean**IsSameObject **(JNIEnv *env, jobjectref1, jobject ref2);
功能:测试两个引用是否引用同一 Java 对象。
参数: env JNI 接口指针。
ref1 Java 对象。
ref2 Java 对象。
返回值: 如果 ref1 和 ref2 引用同一 Java 对象或均为 NULL,则返回 JNI_TRUE。否则返回 JNI_FALSE。

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

五、 字符串操作

jstring **NewString **(JNIEnv *env, const jchar *unicodeChars, jsize len);
功能:利用 Unicode 字符数组构造新的 java.lang.String 对象。
参数: env:JNI 接口指针。
unicodeChars:指向 Unicode 字符串的指针。
len:Unicode 字符串的长度。
返回值: Java 字符串对象。如果无法构造该字符串,则为NULL。
抛出: OutOfMemoryError:如果系统内存不足。

jsize **GetStringLength **(JNIEnv *env, jstring string);
功能:返回 Java 字符串的长度(Unicode 字符数)。
参数: env:JNI 接口指针。
string:Java 字符串对象。
返回值: Java 字符串的长度。

const jchar * **GetStringChars *(JNIEnvenv, jstring string, jboolean *isCopy);
功能:返回指向字符串的 Unicode 字符数组的指针。该指针在调用 ReleaseStringchars() 前一直有效。
如果 isCopy 非空,则在复制完成后将 *isCopy 设为 JNI_TRUE。如果没有复制,则设为JNI_FALSE。
参数: env:JNI 接口指针。
string:Java 字符串对象。
isCopy:指向布尔值的指针。
返回值: 指向 Unicode 字符串的指针,如果操作失败,则返回NULL。

void **ReleaseStringChars **(JNIEnv *env, jstring string, const jchar *chars);
功能:通知虚拟机平台相关代码无需再访问 chars。参数chars 是一个指针,可通过 GetStringChars() 从 string 获得。
参数: env:JNI 接口指针。
string:Java 字符串对象。
chars:指向 Unicode 字符串的指针。

jstring **NewStringUTF **(JNIEnv *env, const char *bytes);
功能:利用 UTF-8 字符数组构造新 java.lang.String 对象。
参数: env:JNI 接口指针。如果无法构造该字符串,则为 NULL。
bytes:指向 UTF-8 字符串的指针。
返回值:Java 字符串对象。如果无法构造该字符串,则为NULL。
抛出: OutOfMemoryError:如果系统内存不足。

jsize **GetStringUTFLength **(JNIEnv *env, jstring string);
功能:以字节为单位返回字符串的 UTF-8 长度。
参数: env:JNI 接口指针。
string:Java 字符串对象。
返回值: 返回字符串的 UTF-8

const char* **GetStringUTFChars *(JNIEnvenv, jstring string, jboolean isCopy);
功能:返回指向字符串的 UTF-8 字符数组的指针。该数组在被ReleaseStringUTFChars() 释放前将一直有效。 如果 isCopy
不是 NULL,
isCopy 在复制完成后即被设为 JNI_TRUE。如果未复制,则设为 JNI_FALSE。
参数: env:JNI 接口指针。
string:Java 字符串对象。
isCopy:指向布尔值的指针。
返回值: 指向 UTF-8 字符串的指针。如果操作失败,则为 NULL。

void **ReleaseStringUTFChars **(JNIEnv *env, jstring string, const char *utf);
功能:通知虚拟机平台相关代码无需再访问 utf。utf 参数是一个指针,可利用 GetStringUTFChars() 获得。
参数: env:JNI 接口指针。
string:Java 字符串对象。
utf:指向 UTF-8 字符串的指针。

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

**六、数组操作 **

jsize **GetArrayLength **(JNIEnv *env, jarray array);
功能:返回数组中的元素数。
参数: env:JNI 接口指针。
array:Java 数组对象。
返回值: 数组的长度。

jarray **NewObjectArray **(JNIEnv *env, jsize length, jclass elementClass, jobject initialElement);
功能:构造新的数组,它将保存类 elementClass 中的对象。所有元素初始值均设为 initialElement。
参数: env:JNI 接口指针。
length:数组大小。
elementClass:数组元素类。
initialElement:初始值。 可以为NULL 。
返回值:Java 数组对象。如果无法构造数组,则为 NULL。
抛出: OutOfMemoryError:如果系统内存不足。

说明: 使用该函数时,为了便于易操作性,我们一般可以用jobjectArray数组类型或得返回值,例如:
jobjectArray objArray = env->NewObjectArray ( );
//操作该对象
env->**GetObjectArrayElement **(objArray, 0);//获得该object数组在索引0处的值 ,(可以强制转换类型).


jobject **GetObjectArrayElement **(JNIEnv *env, jobjectArray array, jsize index);
功能:返回 Object 数组的元素。
参数: env:JNI 接口指针。
array:Java 数组。
index:数组下标。
返回值: Java 对象。
抛出: ArrayIndexOutOfBoundsException:如果 index 不是数组中的有效下标。

void **SetObjectArrayElement **(JNIEnv *env, jobjectArray array, jsize index, jobject value);
功能:设置 Object 数组的元素。
参数: env:JNI 接口指针。
array:Java 数组。
index:数组下标。
value:新值。
抛出: ArrayIndexOutOfBoundsException:如果 index 不是数组中的有效下标。
ArrayStoreException:如果 value 的类不是数组元素类的子类。


** New<PrimitiveType>Array方法类型**

NativeType **New<PrimitiveType>Array **(JNIEnv env, ArrayType array, jbooleanisCopy);

 说明: 用于构造新基本类型数组对象的一系列操作。下表说明了特定的基本类型数组构造函数。用户应把
New<PrimitiveType>Array 替换为某个实际的基本类型数组构造函数例程名(见下表),然后将 ArrayType替换为

该例程相应的数组类型。
参数: env : JNI 接口指针。
length:数组长度。
返回值: Java 数组。如果无法构造该数组,则为 NULL。
 
New<PrimitiveType>Array 方法组 数组类型
NewBooleanArray() jbooleanArray
NewByteArray() jbyteArray
NewCharArray() jcharArray
NewShortArray() jshortArray
NewIntArray() jintArray
NewLongArray() jlongArray
NewFloatArray() jfloatArray
NewDoubleArray() jdoubleArray

** Get<PrimitiveType>ArrayElements 方法类型 **


NativeType ***Get<PrimitiveType>ArrayElements *(JNIEnv env, ArrayType array, jbooleanisCopy);
说明:一组返回基本类型数组体的函数。结果在调用相应的 Release<PrimitiveType>ArrayElements()函数前将一直有效。
由于返回的数组可能是 Java 数组的副本,因此对返回数组的更改不必在基本类型数组中反映出来,直到调用了
Release<PrimitiveType>ArrayElements()。 如果 isCopy 不是 NULL,
isCopy 在复制完成后即被设为 JNI_TRUE。如果
未复制,则设为 JNI_FALSE。
   使用说明:
    将 Get<PrimitiveType>ArrayElements 替换为表中某个实际的基本类型元素访问器例程名。
   将 ArrayType 替换为对应的数组类型。
   将 NativeType 替换为该例程对应的本地类型。
参数: env:JNI 接口指针。
array:Java 字符串对象。
isCopy:指向布尔值的指针。
返回值: 返回指向数组元素的指针,如果操作失败,则为 NULL。

 不管布尔数组在 Java 虚拟机中如何表示,GetBooleanArrayElements() 将始终返回一个 jbooleans 类型的指针,其中每一

字节代表一个元素(开包表示)。内存中将确保所有其它类型。
   
Get<PrimitiveType>ArrayElements 例程 数组类型 本地类型
GetBooleanArrayElements() jbooleanArray jboolean
GetByteArrayElements() jbyteArray jbyte
GetCharArrayElements() jcharArray jchar
GetShortArrayElements() jshortArray jshort
GetIntArrayElements() jintArray jint
GetLongArrayElements() jlongArray jlong
GetFloatArrayElements() jfloatArray jfloat
GetDoubleArrayElements() jdoubleArray jdouble

** Release<PrimitiveType>ArrayElements 方法类型 **

void **Release<PrimitiveType>ArrayElements **(JNIEnv *env, ArrayType array, NativeType *elems,jint mode);
功能:通知虚拟机平台相关代码无需再访问 elems 的一组函数。elems 参数是一个通过使用对应的
Get<PrimitiveType>ArrayElements() 函数由 array 导出的指针。必要时,该函数将把对 elems 的修改复制回基本
类型数组。mode参数将提供有关如何释放数组缓冲区的信息。如果elems 不是 array 中数组元素的副本,mode将无效。
否则,mode 将具有下表所述的功能:
模式 动作
0 复制回内容并释放elems 缓冲区
JNI_COMMIT 复制回内容但不释放elems 缓冲区
JNI_ABORT 释放缓冲区但不复制回变化
多数情况下,编程人员将把“0”传给 mode 参数以确保固定的数组和复制的数组保持一致。其它选项可以使编程人员进一步
控制内存管理,但使用时务必慎重。
使用说明:
将 ArrayType 替换为对应的数组类型。
将 NativeType 替换为该例程对应的本地类型。

参数: env:JNI 接口指针。
array:Java 数组对象。
elems:指向数组元素的指针。
mode:释放模式。

     Release<PrimitiveType>ArrayElements 方法组         数组类型             本地类型
          ReleaseBooleanArrayElements()                      jbooleanArray       jboolean
          ReleaseByteArrayElements()                           jbyteArray              jbyte
          ReleaseCharArrayElements()                          jcharArray              jchar
          ReleaseShortArrayElements()                         jshortArray             jshort
          ReleaseIntArrayElements()                             jintArray                 jint
          ReleaseLongArrayElements()                       jlongArray             jlong
          ReleaseFloatArrayElements()                       jfloatArray            jfloat
          ReleaseDoubleArrayElements()                   jdoubleArray         jdouble

** Get<PrimitiveType>ArrayRegion 方法类型 **

void ** Get<PrimitiveType>ArrayRegion **(JNIEnv *env, ArrayType array, jsize start, jsize len, NativeType *buf);
功能:将基本类型数组某一区域复制到缓冲区中的一组函数。
使用说明:
将 Get<PrimitiveType>ArrayRegion 替换为下表的某个实际基本类型元素访问器例程名。
将 ArrayType 替换为对应的数组类型。
将 NativeType 替换为该例程对应的本地类型。
参数: env:JNI 接口指针。
array:Java 指针。
start:起始下标。
len:要复制的元素数。
buf:目的缓冲区。
抛出: ArrayIndexOutOfBoundsException:如果区域中的某个下标无效。

方法族如下:    
Get<PrimitiveType>ArrayRegion方法 数组类型 本地类型
GetBooleanArrayRegion() jbooleanArray jboolean
GetByteArrayRegion() jbyteArray jbyte
GetCharArrayRegion() jcharArray jchar
GetShortArrayRegion() jshortArray jhort
GetIntArrayRegion() jintArray jint
GetLongArrayRegion() jlongArray jlong
GetFloatArrayRegion() jfloatArray jloat
GetDoubleArrayRegion() jdoubleArray jdouble

** Set<PrimitiveType>ArrayRegion 方法类型 **

void **Set<PrimitiveType>ArrayRegion **(JNIEnv *env, ArrayType array, jsize start, jsize len, NativeType *buf);
功能:将基本类型数组的某一区域从缓冲区中复制回来的一组函数。
使用说明: 将 Set<PrimitiveType>ArrayRegion 替换为表中的实际基本类型元素访问器例程名。
将 ArrayType 替换为对应的数组类型。
将 NativeType 替换为该例程对应的本地类型。
参数: env:JNI 接口指针。
array: Java 数组。
start:起始下标。
len:要复制的元素数。
buf:源缓冲区。
抛出: ArrayIndexOutOfBoundsException:如果区域中的某个下标无效。
   
Set<PrimitiveType>ArrayRegion 方法族 数组类型 本地类型
SetBooleanArrayRegion() jbooleanArray jboolean
SetByteArrayRegion() jbyteArray jbyte
SetCharArrayRegion() jcharArray jchar
SetShortArrayRegion() jshortArray jshort
SetIntArrayRegion() jintArray jint
SetLongArrayRegion() jlongArray jlong
SetFloatArrayRegion() jfloatArray jfloat
SetDoubleArrayRegion() jdoubleArray jdouble

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

** 六、访问对象的属性和方法 **

1、实例属性的访问

jfieldID **GetFieldID **(JNIEnv *env, jclass clazz, const char *name, const char *sig);
功能:返回类的实例(非静态)域的属性 ID。该域由其名称及签名指定。访问器函数的Get<type>Field 及 Set<type>Field
系列使用域 ID 检索对象域。GetFieldID() 不能用于获取数组的长度域。应使用GetArrayLength()。
参数: env:JNI 接口指针。
clazz:Java 类对象。
name: 该属性的Name名称
sig: 该属性的域签名。
返回值:属性ID。如果操作失败,则返回NULL。
抛出: NoSuchFieldError:如果找不到指定的域。
ExceptionInInitializerError:如果由于异常而导致类初始化程序失败。
OutOfMemoryError:如果系统内存不足。

**Get<type>Field 例程 **

NativeType **Get<type>Field *(JNIEnvenv, jobject obj, jfieldID fieldID);
功能:该访问器例程系列返回对象的实例(非静态)域的值。要访问的域由通过调用GetFieldID() 而得到的域 ID 指定。
参数: env:JNI 接口指针。
obj:Java 对象(不能为 NULL)。
fieldID:有效的域 ID。
返回值: 属性的内容。

      Get<type>Field 例程名        本地类型        
           GetObjectField()                  jobject     
           GetBooleanField()               jboolean  
           GetByteField()                     jbyte        
           GetCharField()                     jchar        
           GetShortField()                    jshort       
           GetIntField()                        jint  
           GetLongField()                    jlong         
           GetFloatField()                    jfloat        
           GetDoubleField()      jdouble    

** 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:域的新值。
方法族 如下:  
Set<type>Field 方法族 本地类型
SetObjectField() jobject
SetBooleanField() jboolean
SetByteField() jbyte
SetCharField() jchar
SetShortField() jshort
SetIntField() jint
SetLongField() jlong
SetFloatField() jfloat
SetDoubleField() jdouble

** 2、静态属性的访问 :**也存在相同的方法,

    jfieldID  **GetStaticFieldID **(JNIEnv *env,**jclass clazz**, const char *name, const char *sig);     
   NativeType** **** GetStatic<type>Field **(JNIEnv*env,**jclass classzz **, jfieldID fieldID);           
        void  **SetStatic<type>Field **(JNIEnv *env,**jclassclasszz**, jfieldID fieldID,  NativeType value);           ****

** 它们与实例属性的唯一区别在于第二个参数jclass classzz代表的是类引用,而不是类实例。**


** 3、调用实例方法 **

jmethodID GetMethodID(JNIEnv *env, jclass clazz, const char *name, const char *sig);
功能:返回类或接口实例(非静态)方法的方法 ID。方法可在某个 clazz 的超类中定义,也可从 clazz 继承。该方法由其名称
和签名决定。 GetMethodID() 可使未初始化的类初始化。要获得构造函数的方法 ID,应将 <init> 作为方法名,同时将
void (V) 作为返回类型。
参数: env:JNI 接口指针。
clazz:Java 类对象。
name:方法名。
sig:方法的签名。
返回值: 方法 ID,如果找不到指定的方法,则为 NULL。
抛出: NoSuchMethodError:如果找不到指定方法。
ExceptionInInitializerError:如果由于异常而导致类初始化程序失败。
OutOfMemoryError:如果系统内存不足。

Call<type>Method 例程 、Call<type>MethodA 例程 、Call<type>MethodV 例程

NativeType **Call<type>Method *(JNIEnven v, jobject obj , jmethodID methodID, ...); //参数附加在函数后面,
NativeType **Call<type>MethodA **(JNIEnv *env, jobject obj, jmethodID methodID, jvalue *args); //参数以指针形式附加
NativeType **Call<type>MethodV **(JNIEnv *env, jobject obj,jmethodID methodID, va_list args); //参数以"链表"形式附加

说明:这三个操作的方法用于从本地方法调用Java 实例方法。它们的差别仅在于向其所调用的方法传递参数时所用的机制。
这三个操作将根据所指定的方法 ID 调用 Java 对象的实例(非静态)方法。参数 methodID 必须通过调用 GetMethodID()
来获得。当这些函数用于调用私有方法和构造函数时,方法 ID 必须从obj 的真实类派生而来,而不应从其某个超类派生。
当然,附加参数可以为空 。
参数: env:JNI 接口指针。
obj:Java 对象。
methodID:方法 ID。
返回值: 返回调用 Java 方法的结果。
抛出: 执行 Java 方法时抛出的异常。

下表根据结果类型说明了各个方法类型。用户应将Call<type>Method 中的 type 替换为所调用方法的Java 类型(或使用表
中的实际方法名),同时将 NativeType 替换为该方法相应的本地类型。省略掉了其他两种类型。

       Java层返回值                  方法族                                            本地返回类型NativeType

       返回值为void :          CallVoidMethod( )   A / V                               (无)
       返回值为引用类型:     CallObjectMethod( )                              jobect
       返回值为boolean :    CallBooleanMethod ( )                           jboolean
       返回值为byte :          CallByteMethod( )                                  jbyte
       返回值为char  :         CallCharMethod( )                                 jchar
       返回值为short             CallShortMethod( )                                jshort       
       返回值为int   :          CallIntMethod( )                                     jint  
       返回值为long:          CallLongMethod()                                   jlong         
       返回值为float :         CallFloatMethod()                                   jfloat        
       返回值为double:      CallDoubleMethod()                                jdouble    

** 4、调用静态方法:**也存在如下方法群,

    jfieldID   **GetStaticMethodID **(JNIEnv *env,**jclass clazz**, const char *name, const char *sig);     
   NativeType** **** **Call<type>Method ****(JNIEnv*env,**jclass classzz **, jfieldID fieldID);           

** 它们与于实例方法的唯一区别在于第二个参数jclass classzz代表的是类引用,而不是类实例。**

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

**七、注册本地方法 **

jint **RegisterNatives **(JNIEnv *env, jclass clazz, const JNINativeMethod *methods, jint nMethods);
功能:向 clazz 参数指定的类注册本地方法。methods 参数将指定 JNINativeMethod 结构的数组,其中包含本地方法的名称、
签名和函数指针。nMethods 参数将指定数组中的本地方法数。JNINativeMethod 结构定义如下所示:
typedef struct {
char *name;
char *signature;
void fnPtr;
} JNINativeMethod;
函数指针通常必须有下列签名:
ReturnType (
fnPtr)(JNIEnv *env, jobject objectOrClass, ...);

参数: env:JNI 接口指针。
clazz:Java 类对象。
methods:类中本地方法和具体实现方法的映射指针。
nMethods:类中的本地方法数。
返回值: 成功时返回 "0";失败时返回负数。
抛出: NoSuchMethodError:如果找不到指定的方法或方法不是本地方法。

jint **UnregisterNatives **(JNIEnv *env, jclass clazz);
功能: 取消注册类的本地方法。类将返回到链接或注册了本地方法函数前的状态。 该函数不应在常规平台相关代码中使用。
相反,它可以为某些程序提供一种重新加载和重新链接本地库的途径。
参数: env:JNI 接口指针。
clazz:Java 类对象。
返回值: 成功时返回“0”;失败时返回负数。

////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

其实,JNI方面的书籍还是比较少的,建议大家看看**《JNI编程指南》,**算的上个入门书籍吧,指望你能耐心点看。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 151,511评论 1 330
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 64,495评论 1 273
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 101,595评论 0 225
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 42,558评论 0 190
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 50,715评论 3 270
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 39,672评论 1 192
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,112评论 2 291
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,837评论 0 181
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,417评论 0 228
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,928评论 2 232
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,316评论 1 242
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,773评论 2 234
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,253评论 3 220
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,827评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,440评论 0 180
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 34,523评论 2 249
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 34,583评论 2 249

推荐阅读更多精彩内容