JNI编程指南.pdf

《JNI编程指南.pdf》由会员分享，可在线阅读，更多相关《JNI编程指南.pdf（50页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、序这四种情况下你会用到本书：1、在 Java程序中复用以前写过的C/C+代码。2、自己实现一个java 虚拟机3、学习不同语言如何进行协作，尤其是如何实现垃圾回收和多线程。4、把一个虚拟机实现整合到用C/C+写的程序中。本书是写给开发者的。JNI 在 1997 年第一次发布，本书总结了SUN 工程师和大量开发者两年来积累的经验。本书介绍了JNI 的设计思想，对这种思想的理解是使用JNI 的各种特性的基础。本书有一部分是JAVA2 平台上面的JNI 特征的规范说明。JNI 程序员可以把这部分用作一个手册。JVM 开发者在实现虚拟机的时候必须遵守这些规范。JNI 的部分设计思想来源于Netscap

2、e的 Java Runtime Interface(JRI)。第一章简介JNI 是 JAVA 平台的一个重要特征，使用它我们可以重用以前用C/C+写的大量代码。本书既是一个编程指南也是一个JNI 手册。本书共包括三部分：1、第二章通过一个简单的例子介绍了JNI。它的对象是对JNI 不熟悉的初学者。2、310 章对 JNI 的特征进行了系统的介绍。我们会举大量的例子来说明JNI 的各个特征，这些特征都是JNI 中重要且常用的。3、1113 章是关于JNI 的技术规范。可以把这两章当作一个手册。本书尽量去满足各类读者的需要。指南面向初学者，手册面向有经验的人和自己实现JNI规范的人。大部分读者可能

3、是用JNI 来写程序的开发者。本书会假设你有JAVA，C/C+基础。本章的剩余部分介绍了JNI 的背景，扮演的角色和JNI 的演化。1.1 JAVA 平台和系统环境（Host Environment）系统环境代指本地操作系统环境，它有自己的本地库和CPU 指令集。本地程序（Native Applications）使用C/C+这样的本地语言来编写，被编译成只能在本地系统环境下运行的二进制代码，并和本地库链接在一起。本地程序和本地库一般地会依赖于一个特定的本地系统环境。比如，一个系统下编译出来的C 程序不能在另一个系统中运行。1.2 JNI 扮演的角色JNI 的强大特性使我们在使用JAVA 平台的

4、同时，还可以重用原来的本地代码。作为虚拟机实现的一部分，JNI 允许 JAVA 和本地代码间的双向交互。图 1.1 JNI 的角色JNI 可以这样与本地程序进行交互：1、你可以使用JNI 来实现“本地方法”（native methods），并在 JAVA 程序中调用它们。2、JNI 支持一个“调用接口”（invocation interface），它允许你把一个JVM 嵌入到本地程序中。本地程序可以链接一个实现了JVM 的本地库，然后使用“调用接口”执行 JAVA 语言编写的软件模块。例如，一个用C 语言写的浏览器可以在一个嵌入式JVM 上面执行从网上下载下来的applets 1.3 JNI

5、的副作用请记住，一旦使用JNI，JAVA 程序就丧失了JAVA 平台的两个优点：1、程序不再跨平台。要想跨平台，必须在不同的系统环境下重新编译本地语言部分。2、程序不再是绝对安全的，本地代码的不当使用可能导致整个程序崩溃。一个通用规则是，你应该让本地方法集中在少数几个类当中。这样就降低了JAVA 和 C 之间的耦合性。1.4 什么场合下应该使用JNI 当你开始着手准备一个使用JNI 的项目时，请确认是否还有替代方案。像上一节所提到的，应用程序使用JNI 会带来一些副作用。下面给出几个方案，可以避免使用JNI 的时候，达到与本地代码进行交互的效果：1、JAVA 程序和本地程序使用TCP/IP 或

6、者 IPC 进行交互。2、当用 JAVA 程序连接本地数据库时，使用JDBC 提供的 API。3、JAVA 程序可以使用分布式对象技术，如JAVA IDL API。这些方案的共同点是，JAVA 和 C 处于不同的线程，或者不同的机器上。这样，当本地程序崩溃时，不会影响到JAVA 程序。下面这些场合中，同一进程内JNI 的使用无法避免：1、程序当中用到了JAVA API 不提供的特殊系统环境才会有的特征。而跨进程操作又不现实。2、你可能想访问一些己有的本地库，但又不想付出跨进程调用时的代价，如效率，内存，数据传递方面。3、JAVA 程序当中的一部分代码对效率要求非常高，如算法计算，图形渲染等。总

7、之，只有当你必须在同一进程中调用本地代码时，再使用JNI。1.5 JNI 的演化JDK1.0 包含了一个本地方法接口，它允许JAVA 程序调用C/C+写的程序。许多第三方的程序和 JAVA 类库，如：java.lang,java.io, 等都依赖于本地方法来访问底层系统环境的特征。不幸的是，JDK1.0 中的本地方法有两个主要问题：1、本地方法像访问C 中的结构（structures）一样访问对象中的字段。尽管如此，JVM 规范并没有定义对象怎么样在内存中实现。如果一个给定的JVM实现在布局对象时，和本地方法假设的不一样，那你就不得不重新编写本地方法库。2、因为本地方法可以保持对JVM 中对象

8、的直接指针，所以，JDK1.0 中的本地方法采用了一种保守的GC 策略。JNI 的诞生就是为了解决这两个问题，它可以被所有平台下的JVM 支持：1、每一个 VM 实现方案可以支持大量的本地代码。2、开发工具作者不必处理不同的本地方法接口。3、最重要的是，本地代码可以运行在不同的JVM 上面。JDK1.1 中第一次支持JNI，但是，JDK1.1 仍在使用老风格的本地代码来实现JAVA 的 API。这种情况在JDK1.2 下被彻底改变成符合标准的写法。1.6 例子程序本书包含了大量的代码示例，还教我们如何使用javah 来构建 JNI 程序。第二章开始。本章通过一个简单的例子来示例如何使用JNI。

9、我们写一个JAVA 程序，并用它调用一个C函数来打印“Hello World!”。21 概述图 2.1 演示了如何使用JAVA 程序调用C 函数来打印“Hello World!”。这个过程包含下面几步：1、创建一个类（HelloWorld.java）声明本地方法。2、使用 javac 编译源文件HollowWorld.java，产生 HelloWorld.class。使用 javah jni 来生成C 头文件（HelloWorld.h），这个头文件里面包含了本地方法的函数原型。3、用 C 代码写函数原型的实现。4、把 C 函数实现编译成一个本地库，创建Hello-World.dll或者 lib

10、Hello-World.so。5、使用 java 命令运行HelloWorld程序，类文件HelloWorld.class和本地库(HelloWorld.dll或者 libHelloWorld.so)在运行时被加载。图 2.1 编写并运行“HelloWorld”程序本章剩余部分会详细解释这几步。第三章基本类型、字符串、数组开发者使用JNI 时最常问到的是JAVA 和 C/C+之间如何传递数据，以及数据类型之间如何互相映射。本章我们从整数等基本类型和数组、字符串等普通的对象类型开始讲述。至于如何传递任意对象，我们将在下一章中进行讲述。3.1 一个简单的本地方法JAVA 端源代码如下：class

11、Prompt /native method that prints a prompt and reads a line private native String getLine(String prompt);public static void main(String args)Prompt p=new Prompt();String input=p.getLine(Type a line:);System.out.println(User typed:+input);static System.loadLibrary(Prompt);3.1.1 本地方法的C 函数原型Prompt.getL

12、ine 方法可以用下面这个C 函数来实现：JNIEXPORT jstring JNICALL Java_Prompt_getLine(JNIEnv*env,jobject this,jstring prompt);其中，JNIEXPORT 和 JNICALL这两个宏（被定义在jni.h）确保这个函数在本地库外可见，并且 C 编译器会进行正确的调用转换。C 函数的名字构成有些讲究，在11.3 中会有一个详细的解释。3.1.2 本地方法参数第一个参数JNIEnv 接口指针，指向一个个函数表，函数表中的每一个入口指向一个JNI 函数。本地方法经常通过这些函数来访问JVM 中的数据结构。图 3.1 演

13、示了 JNIEnv 这个指针：图 3.1 JNIEnv 接口指针第二个参数根据本地方法是一个静态方法还是实例方法而有所不同。本地方法是一个静态方法时，第二个参数代表本地方法所在的类；本地方法是一个实例方法时，第二个参数代表本地方法所在的对象。我们的例子当中，Java_Prompt_getLine 是一个实例方法，因此jobject参数指向方法所在的对象。3.1.3 类型映射本地方法声明中的参数类型在本地语言中都有对应的类型。JNI 定义了一个C/C+类型的集合，集合中每一个类型对应于JAVA 中的每一个类型。JAVA 中有两种类型：基本数据类型（int,float,char 等）和引用类型（类

14、，对象，数组等）。JNI 对基本类型和引用类型的处理是不同的。基本类型的映射是一对一的。例如JAVA 中的int 类型直接对应C/C+中的 jint（定义在jni.h 中的一个有符号32 位整数）。12.1.1 包含了JNI 中所有基本类型的定义。JNI 把 JAVA 中的对象当作一个C 指针传递到本地方法中，这个指针指向JVM 中的内部数据结构，而内部数据结构在内存中的存储方式是不可见的。本地代码必须通过在JNIEnv 中选择适当的JNI 函数来操作JVM 中的对象。例如，对于java.lang.String 对应的 JNI 类型是jstring，但本地代码只能通过GetStringUTFC

15、hars 这样的 JNI 函数来访问字符串的内容。所有的 JNI 引用都是jobject 类型，对了使用方便和类型安全，JNI 定义了一个引用类型集合，集合当中的所有类型都是jobject 的子类型。这些子类型和JAVA 中常用的引用类型相对应。例如，jstring 表示字符串，jobjectArray 表示对象数组。3.2 访问字符串Java_Prompt_getLine 接收一个jstring 类型的参数prompt，jstring 类型指向JVM 内部的一个字符串，和常规的C 字符串类型char*不同。你不能把jstring 当作一个普通的C 字符串。3.2.1 转换为本地字符串本地代码

16、中，必须使用合适的JNI 函数把jstring 转化为C/C+字符串。JNI 支持字符串在Unicode 和 UTF-8 两种编码之间转换。Unicode 字符串代表了16-bit 的字符集合。UTF-8 字符串使用一种向上兼容7-bit ASCII 字符串的编码协议。UTF-8 字符串很像NULL 结尾的 C字符串，在包含非ASCII 字符的时候依然如此。所有的7-bitASCII 字符的值都在1127 之间，这些值在UTF-8 编码中保持原样。一个字节如果最高位被设置了，意味着这是一个多字节字符（16-bitUnicode 值）。函数Java_Prompt_getLine通过调用JNI 函

17、数GetStringUTFChars来读取字符串的内容。GetStringUTFChars 可以把一个jstring 指针（指向 JVM 内部的 Unicode 字符序列）转化成一个 UTF-8 格式的 C 字符串。如何你确信原始字符串数据只包含7-bit ASCII 字符，你可以把转化后的字符串传递给常规的C库函数使用，如 printf。我们会在 8.2中讨论如何处理非ASCII字符串。JNIEXPORT jstring JNICALL Java_Prompt_getLine(JNIEnv*env,jobject obj,jstring prompt)char buf128;const jb

18、yte*str;str=(*env)-GetStringUTFChars(env,prompt,NULL);if(str=NULL)return NULL;/*OutOfMemoryError already thrown*/printf(%s,str);(*env)-ReleaseStringUTFChars(env,prompt,str);/*We assume here that the user does not type more than *127 characters*/scanf(%s,buf);return 不要忘记检查 GetStringUTFChars。因为 JVM需要为

19、新诞生的 UTF-8字符串分配内存，这个操作有可能因为内存太少而失败。失败时，GetStringUTFChars 会返回 NULL，并抛出一个 OutOfMemoryError 异常（对异常的处理在第6 章）。这些JNI 抛出的异常与 JAVA中的异常是不同的。一个由JNI 抛出的未决的异常不会改变程序执行流，因此，我们需要一个显示的return语句来跳过 C函数中的剩余 语 句。Java_Prompt_getLine函 数 返 回 后，异 常 会 在Prompt.main（Prompt.getLine这个发生异常的函数的调用者）中抛出，3.2.2 释放本地字符串资源从 GetStringUT

20、FChars 中获取的 UTF-8字符串在本地代码中使用完毕后，要使用ReleaseStringUTFChars告诉 JVM这个 UTF-8 字符串不会被使用了，因为这个UTF-8字符串占用的内存会被回收。3.2.3 构造新的字符串你 可 以 通 过JNI函 数NewStringUTF 在 本 地 方 法 中 创 建 一 个 新 的java.lang.String字符串对象。这个新创建的字符串对象拥有一个与给定的UTF-8编码的 C类型字符串内容相同的Unicode 编码字符串。如果一个 VM不能为构造 java.lang.String分配足够的内存，NewStringUTF会抛出一个 Out

21、OfMemoryError 异常，并返回一个 NULL。在这个例子中，我们不必检查它的返回值，因为本地方法会立即返回。如果NewStringUTF 失败，OutOfMemoryError 这个异常会被在Prompt.main（本地方法的调用者）中抛出。如果 NeweStringUTF 成功，它会返回一个JNI 引用，这个引用指向新创建的java.lang.String对象。这 个对象 被 Prompt.getLine返回 然 后被赋 值给Prompt.main 中的本地 input。3.2.4 其它 JNI 字符串处理函数JNI 支持许多操作字符串的函数，这里做个大致介绍。GetStringC

22、hars和 ReleaseStringChars获取以 Unicode 格式编码的字符串。当操作系统支持 Unicode 编码的字符串时，这些方法很有用。UTF-8 字符串以 0 结尾，而Unicode 字符串不是。如果jstring指向一个Unicode 编码的字符串，为了得到这个字符串的长度，可以调用 GetStringLength。如果一个 jstring指向一个 UTF-8编码的字符串，为了得到这个字符串的字节长度，可以调用标准C 函数strlen。或者直接对jstring调用JNI 函数GetStringUTFLength，而不用管 jstring指向的字符串的编码格式。GetStr

23、ingChars和 GetStringUTFChars 函数中的第三个参数需要更进一步的解释：const jchar*GetStringChars(JNIEnv*env,jstring str,jboolean*isCopy);当从 JNI 函数 GetStringChars中返回得到字符串B 时，如果 B 是原始字符串java.lang.String的拷贝，则 isCopy 被赋值为 JNI_TRUE。如果 B和原始字符串指向的是 JVM中的同一份数据，则isCopy 被赋值为 JNI_FALSE。当 isCopy 值为JNI_FALSE时，本地代码决不能修改字符串的内容，否则JVM中的原始

24、字符串也会被修改，这会打破JAVA语言中字符串不可变的规则。通常，因为你不必关心JVM是否会返回原始字符串的拷贝，你只需要为isCopy传递 NULL作为参数。JVM是否会通过拷贝原始Unicode 字符串来生成 UTF-8字符串是不可以预测的，程序员最好假设它会进行拷贝，而这个操作是花费时间和内存的。一个典型的JVM会在 heap上为对象分配内存。一旦一个 JAVA字符串对象的指针被传递给本地代码，GC就不会再碰这个字符串。换言之，这种情况下，JVM必须 pin 这个对象。可是，大量地 pin 一个对象是会产生内存碎片的，因为，虚拟机会随意性地来选择是复制还是直接传递指针。当你不再使用一个从

25、GetStringChars得到的字符串时，不管JVM内部是采用复制还是直接传递指针的方式，都不要忘记调用ReleaseStringChars。根据方法GetStringChars是复制还是直接返回指针，ReleaseStringChars会释放复制对象时所占的内存，或者unpin 这个对象。3.2.5 JDK1.2中关于字符串的新JNI 函数为了提高JVM返回字符串直接指针的可能性，JDK1.2 中引入了一对新函数，Get/ReleaseStringCritical。表面上，它们和 Get/ReleaseStringChars函数差不多，但实际上这两个函数在使用有很大的限制。使用这两个函数时

26、，你必须两个函数中间的代码是运行在critical region（临界区）的，即，这两个函数中间的本地代码不能调用任何会让线程阻塞或等待JVM 中的其它线程的本地函数或JNI 函数。有了这些限制，JVM 就可以在本地方法持有一个从GetStringCritical得到的字符串的直接指针时禁止GC。当GC被禁止时，任何线程如果触发GC的话，都会被阻塞。而Get/ReleaseStringCritical这两个函数中间的任何本地代码都不可以执行会导致阻塞的调用或者为新对象在JVM 中分配内存。否则，JVM 有可能死锁，想象一下这样的场景中：1、只有当前线程触发的GC 完成阻塞并释放GC 时，由其它

27、线程触发的GC 才可能由阻塞中释放出来继续运行。2、在这个过程中，当前线程会一直阻塞。因为任何阻塞性调用都需要获取一个正被其它线程持有的锁，而其它线程正等待GC。Get/ReleaseStringCritical的交迭调用是安全的，这种情况下，它们的使用必须有严格的顺序限制。而且，我们一定要记住检查是否因为内存溢出而导致它的返回值是 NULL。因为 JVM在执行 GetStringCritical这个函数时，仍有发生数据复制的可能性，尤其是当 JVM内部存储的数组不连续时，为了返回一个指向连续内存空间的指针，JVM必须复制所有数据。总之，为了避免死锁，在Get/ReleaseStringCri

28、tical之间不要调用任何JNI函数。Get/ReleaseStringCritical和Get/ReleasePrimitiveArrayCritical这两个函数是可以的。下面代码演示了这对函数的正确用法：jchar*s1,*s2;s1=(*env)-GetStringCritical(env,jstr1);if(s1=NULL)./*error handling*/s2=(*env)-GetStringCritical(env,jstr2);if(s2=NULL)(*env)-ReleaseStringCritical(env,jstr1,s1);./*error handling*/.

29、/*use s1 and s2*/(*env)-ReleaseStringCritical(env,jstr1,s1);(*env)-ReleaseStringCritical(env,jstr2,s2);JNI 不支持Get/ReleaseStringUTFCritical，因为这样的函数在进行编码转换时很可能会促使JVM 对数据进行复制，因为JVM 内部表示字符串一般都是使用Unicode 的。JDK1.2 还一对新增的函数：GetStringRegion和GetStringUTFRegion。这对函数把字符串复制到一个预先分配的缓冲区内。Prompt.getLine这个本地方法可以用Ge

30、tStringUTFRegion 重新实现如下：JNIEXPORT jstring JNICALL Java_Prompt_getLine(JNIEnv*env,jobject obj,jstring prompt)/*assume the prompt string and user input has less than 128 characters*/char outbuf128,inbuf128;int len=(*env)-GetStringLength(env,prompt);(*env)-GetStringUTFRegion(env,prompt,0,len,outbuf);pr

31、intf(%s,outbuf);scanf(%s,inbuf);return(*env)-NewStringUTF(env,inbuf);GetStringUTFRegion这个函数会做越界检查，如果必要的话，会抛出异常StringIndexOutOfBoundsException。这个方法与 GetStringUTFChars 比较相似，不同的是，GetStringUTFRegion 不做任何内存分配，不会抛出内存溢出异常。3.2.6 JNI字符串操作函数总结对于小字符串来说，Get/SetStringRegion和Get/SetString-UTFRegion这两对函数是最佳选择，因为缓冲

32、区可以被编译器提前分配，而且永远不会产生内存溢出的异常。当你需要处理一个字符串的一部分时，使用这对函数也是不错的，因为它们提供了一个开始索引和子字符串的长度值。另外，复制少量字符串的消耗是非常小的。在 使用GetStringCritical时，必须非常小心。你必须确保在持有一个由GetStringCritical获取到的指针时，本地代码不会在JVM内部分配新对象，或者做任何其它可能导致系统死锁的阻塞性调用。下面的例子演示了使用GetStringCritical时需要注意的一些地方：/*This is not safe!*/const char*c_str=(*env)-GetStringCri

33、tical(env,j_str,0);if(c_str=NULL)./*error handling*/fprintf(fd,%sn,c_str);(*env)-ReleaseStringCritical(env,j_str,c_str);上面代码的问题在于，GC 被当前线程禁止的情况下，向一个文件写数据不一定安全。例如，另外一个线程T 正在等待从文件fd 中读取数据。假设操作系统的规则是fprintf 会等待线程T 完成所有对文件fd 的数据读取操作，这种情况下就可能会产生死锁：线程T 从文件 fd 中读取数据是需要缓冲区的，如果当前没有足够内存，线程T 就会请求GC 来回收一部分，GC一

34、旦 运 行，就 只 能 等 到 当 前 线 程 运 行ReleaseStringCritical时 才 可 以。而ReleaseStringCritical 只有在 fprintf 调用返回时才会被调用。而 fprintf 这个调用，会一直等待线程 T 完成文件读取操作。3.3 访问数组JNI 在处理基本类型数组和对象数组上面是不同的。对象数组里面是一些指向对象实例或者其它数组的引用。本地代码中访问JVM 中的数组和访问JVM 中的字符串有些相似。看一个简单的例子。下面的程序调用了一个本地方法sumArray，这个方法对一个int 数组里面的元素进行累加：class IntArray priv

35、ate native int sumArray(int arr);public static void main(String args)IntArray p=new IntArray();int arr=new int10;for(int i=0;i GetIntArrayRegion(env,arr,0,10,buf);for(i=0;i 10;i+)sum+=bufi;return sum;3.3.2 访问基本类型数组上一个例子中，使用 GetIntArrayRegion函数来把一个int 数组中的所有元素复制到一个C 缓冲区中，然后我们在本地代码中通过C 缓冲区来访问这些元素。JNI

36、支持一个与GetIntArrayRegion 相对应的函数SetIntArrayRegion。这个函数允许本地代码修改所有的基本类型数组中的元素。JNI 支持一系列的Get/ReleaseArrayElement 函数，这些函数允许本地代码获取一个指向基本类型数组的元素的指针。由于 GC 可能不支持pin 操作，JVM 可能会先对原始数据进行复制，然后返回指向这个缓冲区的指针。我们可以重写上面的本地方法实现：JNIEXPORT jint JNICALL Java_IntArray_sumArray(JNIEnv*env,jobject obj,jintArray arr)jint*carr;j

37、int i,sum=0;carr=(*env)-GetIntArrayElements(env,arr,NULL);if(carr=NULL)return 0;/*exception occurred*/for(i=0;iReleaseIntArrayElements(env,arr,carr,0);return sum;GetArrayLength 这个函数返回数组中元素的个数，这个值在数组被首次分配时确定下来。JDK1.2 引入了一对函数：Get/ReleasePrimitiveArrayCritical。通过这对函数，可以在本地代码访问基本类型数组元素的时候禁止GC 的运行。但程序员使用

38、这对函数时，必须和使用Get/ReleaseStringCritical 时一样的小心。在这对函数调用的中间，同样不能调用任何JNI 函数，或者做其它可能会导致程序死锁的阻塞性操作。3.3.3 操作基本类型数组的JNI 函数的总结如 果 你 想 在 一 个 预 先 分 配 的C缓 冲 区 和 内 存 之 间 交 换 数 据，应 该 使 用Get/SetArrayRegion 系列函数。这些函数会进行越界检查，在需要的时候会有可能抛出 ArrayIndexOutOfBoundsException异常。对于少量的、固定大小的数组，Get/SetArrayRegion 是最好的选择，因为C 缓冲区可

39、以在 Stack（栈）上被很快地分配，而且复制少量数组元素的代价是很小的。这对函数的另外一个优点就是，允许你通过传入一个索引和长度来实现对子字符串的操作。如果你没有一个预先分配的C 缓冲区，并且原始数组长度未定，而本地代码又不想在获取数 组 元 素 的 指 针 时 阻 塞 的 话，使 用Get/ReleasePrimitiveArrayCritical函 数 对。就 像Get/ReleaseStringCritical 函数对一样，这对函数很小心地使用，以避免死锁。Get/ReleaseArrayElements 系列函数永远是安全的。JVM 会选择性地返回一个指针，这个指针可能指向原始数据也

40、可能指向原始数据复制。3.3.5 访问对象数组JNI 提供了一个函数对来访问对象数组。GetObjectArrayElement 返回数组中指定位置的元素，而 SetObjectArrayElement修改数组中指定位置的元素。与基本类型的数组不同的是，你不能一次得到所有的对象元素或者一次复制多个对象元素。字符串和数组都是引用类型，你要使用 Get/SetObjectArrayElement 来访问字符串数组或者数组的数组。下面的例子调用了一个本地方法来创建一个二维的int 数组，然后打印这个数组的内容：class ObjectArrayTest private static native i

41、nt initInt2DArray(int size);public static void main(String args)int i2arr=initInt2DArray(3);for(int i=0;i 3;i+)for(int j=0;j FindClass(env,I);if(intArrCls=NULL)return NULL;/*exception thrown*/result=(*env)-NewObjectArray(env,size,intArrCls,NULL);if(result=NULL)return NULL;/*out of memory error throw

42、n*/for(i=0;i NewIntArray(env,size);if(iarr=NULL)return NULL;/*out of memory error thrown*/for(j=0;j SetIntArrayRegion(env,iarr,0,size,tmp);(*env)-SetObjectArrayElement(env,result,i,iarr);(*env)-DeleteLocalRef(env,iarr);return result;函数newInt2DArray 首先调用 JNI 函数 FindClass 来获得一个 int型二维数组类的引用，传递给 FindCl

43、ass 的参数“I”是 JNI class descriptor（JNI 类型描述符），它对应着 JVM中的 int类型。如果类加载失败的话，FindClass 会返回NULL，然后抛出一个异常。接 下来，NewObjectArray会 分配 一 个 数组，这 个 数 组里 面 的元 素类 型 用intArrCls类引用来标识。函数 NewObjectArray 只能分配第一维，JVM没有与多维数组相对应的数据结构。一个二维数组实际上就是一个简单的数组的数组。创建第二维数据的方式非常直接，NewInt-Array为每个数组元素分配空间，然后 SetIntArrayRegion把 tmp 缓冲区

44、中的内容复制到新分配的一维数组中去。在循环最后调用 DeleteLocalRef，确保 JVM释放掉 iarr这个 JNI 引用。第四章字段和方法现在，你知道了如何通过JNI 来访问 JVM 中的基本类型数据和字符串、数组这样的引用类型数据，下一步就是学习怎么样和JVM 中任意对象的字段和方法进行交互。比如从本地代码中调用 JAVA 中的方法，也就是通常说的来自本地方法中的callbacks（回调）。我们从进行字段访问和方法回调时需要的JNI 函数开始讲解。本章的稍后部分我们会讨论怎么样通过一些cache（缓存）技术来优化这些操作。在最后，我们还会讨论从本地代码中访问字段和回调方法时的效率问题

45、。4.1 访问字段JAVA 支持两种field（字段），每一个对象的实例都有一个对象字段的复制；所有的对象共享一个类的静态字段。本地方法使用JNI 提供的函数可以获取和修改这两种字段。先看一个从本地代码中访问对象字段的例子：class InstanceFieldAccess private String s;private native void accessField();public static void main(String args)InstanceFieldAccess c=new InstanceFieldAccess();c.s=abc;c.accessField();Sys

46、tem.out.println(In Java:);System.out.println(c.s=+c.s+);static System.loadLibrary(InstanceFieldAccess);InstanceFieldAccess这个类定义了一个对象字段s。main 方法创建了一个对象并设置 s 的值，然后调用本地方法InstanceFieldAccess.accessField在本地代码中打印 s 的值，并把它修改为一个新值。本地方法返回后，JAVA中把这个值再打印一次，可以看出来，字段s 的值已经被改变了。下面是本地方法的实现：JNIEXPORT void JNICALL J

47、ava_InstanceFieldAccess_accessField(JNIEnv*env,jobject obj)jfieldID fid;/*store the field ID*/jstring jstr;const char*str;/*Get a reference to objs class*/jclass cls=(*env)-GetObjectClass(env,obj);printf(In C:n);/*Look for the instance field s in cls*/fid=(*env)-GetFieldID(env,cls,s,Ljava/lang/Strin

48、g;);if(fid=NULL)return;/*failed to find the field*/*Read the instance field s*/jstr=(*env)-GetObjectField(env,obj,fid);str=(*env)-GetStringUTFChars(env,jstr,NULL);if(str=NULL)return;/*out of memory*/printf(c.s=%sn,str);(*env)-ReleaseStringUTFChars(env,jstr,str);/*Create a new string and overwrite th

49、e instance field*/jstr=(*env)-NewStringUTF(env,123);if(jstr=NULL)return;/*out of memory*/(*env)-SetObjectField(env,obj,fid,jstr);运行程序，得到输出为：In C:c.s=abc In Java:c.s=123 4.1.1 访问一个对象字段的流程为了访问一个对象的实例字段，本地方法需要做两步：首先，通过在类引用上调用GetFieldID 获取 field ID（字段 ID）、字段名字和字段描述符：Fid=(*env)-GetFieldID(env,cls,”s”,”Lj

50、ava/lang/String;”);上例中的代码通过在对象引用obj 上调用 GetObjectClass 获取到类引用。一旦获取到字段ID，你就可以把对象和字段ID 作为参数来访问字段：Jstr=(*env)-GetObjectField(env,obj,fid);因为字符串和数组是特殊的对象，所以我们使用GetObjectField 来访问字符串类型的实例字段。除了Get/SetObjectField，JNI 还支持其它如GetIntField、SetFloatField 等用来访问基本类型字段的函数。4.1.2 字段描述符在上一节我们使用过一个特殊的C 字符串“Ljava/lang/S