JNI (Java Native Interface),即Java本地接口,是为java编写本地方法和jvm嵌入本地应用程序的标准的应用程序接口。首要的目标是在给定的平台上采用JAVA通过JNI 调 用本地方法,而本地方法是以库文件的形式存放的(在WINDOWS平台上是DLL文件形式,在UNIX机器上是SO文件形式)。通过调用本地的库文件的内 部方法,使JAVA可以实现和本地机器的紧密联系,调用系统级的各接口方法。有的jvm来实现兼容的二进制编码本地方法库。
简叙步骤
·编写带有native声明的方法的java类
·使用javac命令编译所编写的java类
·使用javah java类名生成扩展名为h的头文件
·使用C/C++实现本地方法,并生成动态连接库
·将库文件拷贝到java工程目录下,运行java程序
1 建立java工程
在JAVA程序中,首先需要在类中声明所调用的库名称,如下:
库的扩展名字可以不用写出来,究竟是DLL还是SO,由系统自己判断。接着对将要调用的方法做本地声明,关键字为native。并且只需要声明,而不需要具 体实现。如下:
public native static void fn1(int i);
public native static int fn2(void );
然后编译该JAVA程序文件,生成CLASS,再用JAVAH 命令,JNI 就会生成C/C++的头文件。
例如建立java文件TestDel.java,内容为:
用javac TestDel.java编译它,生成TestDel.class。
再用javah TestDel,则会在当前目录下生成TestDel.h文件,这个文件需要被C/C++程序调用来生成所需的库文件。
2 生成动态链接库
对于已生成的.h头文件,C/C++所需要做的,就是把它的各个方法具体的实现。然后编译连接成库文件。
接上例子。我们先看一下TestDel.h文件的内容:
在具体实现的时候,我们只关心几个函数原型 :
这里JNIEXPORT和JNICALL都是JNI 的关键字,表示此函数是要被JNI 调用 的。如果java中申明的函数原型包含参数,例如int,那么生成的头文件中变成jint,它是以JNI 为 中介使JAVA的int类型与本地的int沟通 的一种类型,我们可以视而不见,就当做int使用。其它参数类似。函数的名称是JAVA_再加上java程序的package路径再加函数名组成的。参数 中,我们也只需要关心在JAVA程序中存在的参数,至于JNIEnv*和jclass我们一般没有必要去碰它。
好,下面我们使用dll具体实现这几个函数(一个函数是创建目录,另两个是两种删除目录的方法)。
注 意,本例是通过VS2005建立dll的,需要安装"WebDeploymentSetup.msi", New一个工程选择VC++建立win32 project,选中dll建立Empty project。将java中生成的头文件拷贝至此工程添加,再建立新文件test.cpp(必须以cpp后缀,若以c后缀则builder会出 错)test.cpp代码如下(注意这句#include "TestDel.h"):
注 意:一定要把SDK中的include文 件夹中(和它下面的win32文件夹下的头文件)的几个头文件拷贝到VC的include文件夹中。或者在VS的tools/options -〉Projects and Solutions/VC++ Project Settings,修改directories中include的设置,把头文件../sdk1.5.0/inlcude 和 ../sdk1.5.0/include/win32给包含进来。
编译连接成库文件dll(在debug文件夹中),注意名称要与JAVA中需要调用库名的一致,这里可以修改为lidp.dll。
3 运行程序
把lidp.dll拷贝到TestDel.class的目录下,java TestDel运行它,就可以观察到结果了。这里实现的功能是统计删除文件夹的时间。
java中有一种直接把c C++代码转换成java类的工具 swig 很方便。