《Java 本地接口规范》-JNI 的类型和数据结构

JNI 的类型和数据结构

---

本章讨论 JNI 如何将 Java 类型映射到本地 C 类型。

---

基本类型

表 3-1 描述Java 基本类型及其与计算机相关的本地等效类型。

表 3-1 基本类型和本地等效类型

Java 类型

本地类型

说明

boolean

jboolean

无符号，8 位

byte

jbyte

无符号，8 位

char

jchar

无符号，16 位

short

jshort

有符号，16 位

int

jint

有符号，32 位

long

jlong

有符号，64 位

float

jfloat

32 位

double

jdouble

64 位

void

void

N/A

为了使用方便，特提供以下定义。

    #define JNI_FALSE  0

    #define JNI_TRUE   1

jsize 整数类型用于描述主要指数和大小：

    typedef jint jsize;

---

引用类型

JNI 包含了很多对应于不同 Java 对象的引用类型。JNI 引用类型的组织层次如图3-1 所示。

图 3-1 引用类型层次

在 C 中，所有其它 JNI 引用类型都被定义为与 jobject 一样。例如：

    typedef jobject jclass;

在 C++ 中，JNI 引入了虚构类以加强子类关系。例如：

    class _jobject {};

    class _jclass : public _jobject {};

    ...

    typedef _jobject *jobject;

    typedef _jclass *jclass;

---

域 ID 和方法 ID

方法 ID 和域 ID 是常规的 C 指针类型：

    struct _jfieldID;              /*不透明结构 */

    typedef struct _jfieldID *jfieldID;   /* 域 ID */

    struct _jmethodID;              /* 不透明结构 */

    typedef struct _jmethodID *jmethodID; /* 方法 ID */

---

值类型

jvalue 联合类型在参数数组中用作单元类型。其声明方式如下：

    typedef union jvalue {

        jboolean z;

        jbyte    b;

        jchar    c;

        jshort   s;

        jint     i;

        jlong    j;

        jfloat   f;

        jdouble  d;

        jobject  l;

    } jvalue;

---

类型签名

JNI 使用 Java 虚拟机的类型签名表述。表 3-2 列出了这些类型签名。

表 3-2 Java 虚拟机类型签名

类型签名

Java 类型

Z

boolean

B

byte

C

char

S

short

I

int

J

long

F

float

D

double

L fully-qualified-class ;

全限定的类

[ type

type[]

( arg-types ) ret-type

方法类型

例如，Java 方法：

    long f (int n, String s, int[] arr);

具有以下类型签名：

    (ILjava/lang/String;[I)J

---

UTF-8字符串

JNI 用 UTF-8 字符串来表示各种字符串类型。UTF-8 字符串和 Java 虚拟机所使用的一样。UTF-8 字符串的编码方式使得仅包含非空 ASCII 字符的字符序列能够按每字符一个字节表示，但是最多只能表示 16 位的字符。所有在\u0001 到\u007F 范围内的字符都用单字节表示，如下所示：

字节中的七位数据确定了所表示字符的值。空字符 (\u000) 和 \u0080 到\u07FF 范围内的字符用一对字节表示， 即x 和 y，如下所示：

值为 ((x&0x1f)<<6)+(y&0x3f) 的字符需用两个字节表示。

\u0800 到 \uFFFF 范围内的字符用三个字节表示，即 x，y，和 z：

值为 ((x&0xf)<<12)+(y&0x3f)<<6)+(z&0x3f) 的字符需用三个字节表示。

此格式与“标准” UTF-8 格式之间有两个区别。第一，空字节 (byte)0 使用双字节格式进行编码，而不是单字节格式。这意味着 Java 虚拟机的 UTF-8 字符串不可能有嵌入的空值。第二，只使用单字节、双字节和三字节格式。Java 虚拟机不能识别更长的 UTF-8 格式。