android - JNI接口函数 (1)

分类： Android 2012-03-14 10:36 238人阅读 评论(0) 收藏 举报

目录(?)[+]

1. 版本信息
   1. GetVersion
      1. 参数
      2. 返回值：
   2. 类操作
      1. DefineClass
         1. 参数：
         2. 返回值：
         3. 抛出：
      2. FindClass
         1. 参数：
         2. 返回值：
         3. 抛出：
      3. GetSuperclass
         1. 参数：
         2. 返回值：
      4. IsAssignableFrom
         1. 参数：
         2. 返回值：
      5. 异常
         1. Throw
            1. 参数：
            2. 返回值：
            3. 抛出：
         2. ThrowNew
            1. 参数：
            2. 返回值：
            3. 抛出：
         3. ExceptionOccurred
            1. 参数：
            2. 返回值：
         4. ExceptionDescribe
            1. 参数：
         5. ExceptionClear
            1. 参数：
         6. FatalError
            1. 参数：
         7. 全局及局部引用
            1. NewGlobalRef
               1. 参数：
               2. 返回值：
            2. DeleteGlobalRef
               1. 参数：
            3. DeleteLocalRef
               1. 参数：

---

版本信息

 

GetVersion

jint   GetVersion(JNIEnv *env);

返回本地方法接口的版本。

参数

env：JNI 接口指针。

返回值：

高 16 位返回主版本号，低 16 位返回次版本号。

在 JDK1.1 中，GetVersion() 返回 0x00010001。

---

类操作

 

DefineClass

jclass  DefineClass(JNIEnv *env, jobject loader, 
const jbyte *buf, jsize bufLen);

从原始类数据的缓冲区中加载类。

参数：

env：JNI 接口指针。

loader：分派给所定义的类的类加载器。

buf：包含 .class 文件数据的缓冲区。

bufLen：缓冲区长度。

返回值：

返回 Java 类对象。如果出错则返回NULL。

抛出：

ClassFormatError：如果类数据指定的类无效。

ClassCircularityError：如果类或接口是自身的超类或超接口。 

OutOfMemoryError：如果系统内存不足。

 

FindClass

jclass  FindClass(JNIEnv *env, const char *name);

该函数用于加载本地定义的类。它将搜索由CLASSPATH 环境变量为具有指定名称的类所指定的目录和 zip 文件。

参数：

env：JNI 接口指针。

name：类全名（即包名后跟类名，之间由“/”分隔）。如果该名称以“[”（数组签名字符）打头，则返回一个数组类。

返回值：

返回类对象全名。如果找不到该类，则返回 NULL。

抛出：

ClassFormatError：如果类数据指定的类无效。

ClassCircularityError：如果类或接口是自身的超类或超接口。

NoClassDefFoundError：如果找不到所请求的类或接口的定义。

OutOfMemoryError：如果系统内存不足。

 

GetSuperclass

jclass  GetSuperclass(JNIEnv *env, jclass clazz);

如果 clazz 代表类而非类 object，则该函数返回由 clazz 所指定的类的超类。

如果 clazz 指定类 object 或代表某个接口，则该函数返回NULL。

参数：

env：JNI 接口指针。

clazz：Java 类对象。

返回值：

由 clazz 所代表的类的超类或 NULL。

 

IsAssignableFrom

jboolean  IsAssignableFrom(JNIEnv *env, jclass clazz1, 
jclass clazz2);

确定 clazz1 的对象是否可安全地强制转换为clazz2。

参数：

env：JNI 接口指针。

clazz1：第一个类参数。

clazz2：第二个类参数。

返回值：

下列某个情况为真时返回 JNI_TRUE：

• 第一及第二个类参数引用同一个 Java 类。
• 第一个类是第二个类的子类。
• 第二个类是第一个类的某个接口。

---

异常

 

Throw

jintThrow(JNIEnv *env, jthrowable obj);

抛出 java.lang.Throwable 对象。

参数：

env：JNI 接口指针。

obj：java.lang.Throwable 对象。

返回值：

成功时返回 0，失败时返回负数。

抛出：

java.lang.Throwable 对象 obj。

 

ThrowNew

jint  ThrowNew(JNIEnv *env, jclass clazz, 
const char *message);

利用指定类的消息（由 message 指定）构造异常对象并抛出该异常。

参数：

env：JNI 接口指针。

clazz：java.lang.Throwable 的子类。

message：用于构造java.lang.Throwable 对象的消息。

返回值：

成功时返回 0，失败时返回负数。

抛出：

新构造的 java.lang.Throwable 对象。

 

ExceptionOccurred

jthrowable  ExceptionOccurred(JNIEnv *env);

确定是否某个异常正被抛出。在平台相关代码调用 ExceptionClear() 或 Java 代码处理该异常前，异常将始终保持抛出状态。

参数：

env：JNI 接口指针。

返回值：

返回正被抛出的异常对象，如果当前无异常被抛出，则返回NULL。

 

ExceptionDescribe

void  ExceptionDescribe(JNIEnv *env);

将异常及堆栈的回溯输出到系统错误报告信道（例如 stderr）。该例程可便利调试操作。

参数：

env：JNI 接口指针。

 

ExceptionClear

void  ExceptionClear(JNIEnv *env);

清除当前抛出的任何异常。如果当前无异常，则此例程不产生任何效果。

参数：

env：JNI 接口指针。

 

FatalError

void  FatalError(JNIEnv *env, const char *msg);

抛出致命错误并且不希望虚拟机进行修复。该函数无返回值。

参数：

env：JNI 接口指针。

msg：错误消息。

---

全局及局部引用

 

NewGlobalRef

jobject  NewGlobalRef(JNIEnv *env, jobject obj);

创建 obj 参数所引用对象的新全局引用。obj 参数既可以是全局引用，也可以是局部引用。全局引用通过调用 DeleteGlobalRef() 来显式撤消。

参数：

env：JNI 接口指针。

obj：全局或局部引用。

返回值：

返回全局引用。如果系统内存不足则返回 NULL。

 

DeleteGlobalRef

void  DeleteGlobalRef(JNIEnv *env, jobject globalRef);

删除 globalRef 所指向的全局引用。

参数：

env：JNI 接口指针。

globalRef：全局引用。

 

DeleteLocalRef

void   DeleteLocalRef(JNIEnv *env, jobject localRef);

删除 localRef所指向的局部引用。

参数：

env：JNI 接口指针。

localRef：局部引用