转载请注明出处：【huachao1001的简书：http://www.jianshu.com/users/0a7e42698e4b/latest_articles】
这篇文章是直接从《The Java™ Native Interface Programmer’s Guide and Specification》中整理，可以前往http://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/jniTOC.html中查阅。本文只是作为参考用，并不涉及到深层次的技术。主要是为了后面学习过程中能快速查阅，花半分钟浏览一下即可。
1. JNI类型映射
1.1 基本类型
| Java Language Type | Native Type | Description |
|---|---|---|
| boolean | jboolean | unsigned 8 bits |
| byte | jbyte | signed 8 bits |
| char | jchar | unsigned 16 bits |
| short | jshort | signed 16 bits |
| int | jint | signed 32 bits |
| long | jlong | signed 64 bits |
| float | jfloat | 32 bits |
| double | jdouble | 64 bits |
1.2 引用类型映射
1.3 jvalue类型
jvalue类型为联合体union类型，它的定义如下：
typedef union jvalue {
jboolean z;
jbyte b;
jchar c;
jshort s;
jint i;
jlong j;
jfloat f;
jdouble d;
jobject l;
} jvalue;
2. 描述符
JNI中使用C语言中的字符串来表示类的名称（class name）、域（field）、方法名以及域和方法描述，这些字符串都是UTF-8编码格式。
2.1 类描述符
类描述符用于描述类或接口名，比如描述java.lang.String类，使用java/lang/String来表示。对于数组类型，则通过[前缀来描述，比如一维数组类型int[]，则使用[I表示；二维数组int[][] 则使用[[I表示；甚至三维数组double[][][]，则用[[[D表示。
2.2 域描述符（Field descriptors ）
| Field Descriptor | Java Language Type |
|---|---|
| Z | boolean |
| B | byte |
| C | char |
| S | short |
| I | int |
| J | long |
| F | float |
| D | double |
八种基本类型对应的域描述符如下：
| Field Descriptor | Java Language Type |
|---|---|
| Z | boolean |
| B | byte |
| C | char |
| S | short |
| I | int |
| J | long |
| F | float |
| D | double |
| Field Descriptor | Java Language Type |
|---|---|
"Ljava/lang/String;" |
String |
"[I" |
int[] |
"[Ljava/lang/Object;" |
Object[] |
引用类型的域描述符以字符L开头，再连接引用类型对应的类描述符，最后以分号;结尾。数组类型则是先以[开头，再按照域描述符规则组成，例如：
| Field Descriptor | Java Language Type |
|---|---|
"Ljava/lang/String;" |
String |
"[I" |
int[] |
"[Ljava/lang/Object;" |
Object[] |
2.3 方法描述符（Method descriptors）
方法描述符是描述一个方法（或者说函数），主要描述方法的参数和返回类型，都是通过域描述符进行描述，方法描述符的构成为(形参对应的域描述符)返回类型对应域描述符。并且各个描述符之间没有空格和逗号或者是其他类型的间隔符号。字符V用于表示返回类型为void，而构造函数使用V表示他们的返回类型并且使用<init>作为名字，下表为简单示例：
| Method Descriptor | Java Language Type |
|---|---|
"()Ljava/lang/String;" |
String f(); |
"(ILjava/lang/Class;)J" |
long f(int i, Class c); |
| ``"([B)V"` | String(byte[] bytes); |
3. 宏定义
3.1 JNIEXPORT 与JNICALL
JNIEXPORT 和 JNICALL 都是宏定义，用于指定JNI函数和本地方法实现之间的调用和链接规则。必须将JNIEXPORT放在函数的返回类型之前，将JNICALL放在函数名称与返回类型之间。例如：
JNIEXPORT jint JNICALL Java_pkg_Cls_f(JNIEnv *env, jobject this);
上面为C语言对Java中pkg.Cls.f函数的具体实现对应的函数原型。定义指向Java_pkg_Cls_f函数的指针变量可以如下：
jint (JNICALL *f_ptr)(JNIEnv *env, jobject this);
3.2 JNI_FALSE与JNI_TRUE
JNI_FALSEand JNI_TRUE 是定义jboolean类型的两个常量 :
#define JNI_FALSE 0
#define JNI_TRUE 1
3.3JNI_OK与 JNI_ERR
JNI_OK表示JNI函数成功返回， JNI_ERR有时用于表示错误。
#define JNI_OK 0
#define JNI_ERR (-1)
并非所有的错误情况都是使用JNI_ERR，因为JNI并不指定错误码集合，而是返回JNI_OK表示JNI函数成功返回，返回负数表示函数执行失败。
3.4 JNI_COMMIT与JNI_ABORT
JNI_COMMIT与JNI_ABORT两个常量被用于函数中，释放本地拷贝的基本类型数组。JNI_COMMIT 强制要求本地数组数据拷贝至JVM中对应的数组，JNI_ABORT则释放本地数组占用的内存空间，并且不作为新返回数据拷贝至JVM中对应的数组。
#define JNI_COMMIT 1
#define JNI_ABORT 2
