JNI 简介

一 JNI 简介


JNI（Java Native Interface）,即Java本地接口，是为java编写本地方法和jvm嵌入本地应用程序的标准的应用程序接口。首要的目标是在给定的平台上采用JAVA通过JNI调 用本地方法，而本地方法是以库文件的形式存放的（在WINDOWS平台上是DLL文件形式，在UNIX机器上是SO文件形式）。通过调用本地的库文件的内 部方法，使JAVA可以实现和本地机器的紧密联系，调用系统级的各接口方法。有的jvm来实现兼容的二进制编码本地方法库。


二 环境介绍

Java Development Kit (JDK) 版本 1.6.0，
Microsoft Visual Studio2005 编译器编译生成C语言的动态链接库 dll。

一 JNI 简介

JNI（Java Native Interface）,即Java本地接口，是为java编写本地方法和jvm嵌入本地应用程序的标准的应用程序接口。首要的目标是在给定的平台上采用JAVA通过JNI调 用本地方法，而本地方法是以库文件的形式存放的（在WINDOWS平台上是DLL文件形式，在UNIX机器上是SO文件形式）。通过调用本地的库文件的内 部方法，使JAVA可以实现和本地机器的紧密联系，调用系统级的各接口方法。有的jvm来实现兼容的二进制编码本地方法库。


二 环境介绍

Java Development Kit (JDK) 版本 1.6.0，
Microsoft Visual Studio2005 编译器编译生成C语言的动态链接库 dll。

三 简叙步骤
      ·编写带有native声明的方法的java类
      ·使用javac命令编译所编写的java类
      ·使用javah java类名生成扩展名为h的头文件
      ·使用C/C++实现本地方法，并生成动态连接库
      ·将库文件拷贝到java工程目录下，运行java程序


四 具体实现

1 建立java工程
在JAVA程序中，首先需要在类中声明所调用的库名称，如下：
static {
System.loadLibrary(“dllname”);
}

库的扩展名字可以不用写出来，究竟是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，内容为：

public class TestDel
{
    static
    {
        System.loadLibrary("cjw"); //库名cjw
    }

    public native static void creFolder();
    public native static void delFolder1();
    public native static void delFolder2();
    public static void main(String[] args)
    {
        TestDel test = new TestDel();
  
        System.out.println("start create  Folder...");
        test.creFolder();
        System.out.println("create Folder finished.");
  
        long stime = System.currentTimeMillis();    
        //test.delFolder1();
          test.delFolder2();    
      long etime =System.currentTimeMillis();
    
        System.out.println(etime-stime);
    }
}
用javac TestDel.java编译它，生成TestDel.class。
再用javah TestDel，则会在当前目录下生成TestDel.h文件，这个文件需要被C/C++程序调用来生成所需的库文件。

2 生成动态链接库
对于已生成的.h头文件，C/C++所需要做的，就是把它的各个方法具体的实现。然后编译连接成库文件。
接上例子。我们先看一下TestDel.h文件的内容：
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class TestDel */
#ifndef _Included_TestDel
#define _Included_TestDel
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class:     TestDel
* Method:    creFolder
* Signature: ()V
*/
JNIEXPORT void JNICALL Java_TestDel_creFolder
  (JNIEnv *, jclass);
/*
* Class:     TestDel
* Method:    delFolder1
* Signature: ()V
*/
JNIEXPORT void JNICALL Java_TestDel_delFolder1
  (JNIEnv *, jclass);
/*
* Class:     TestDel
* Method:    delFolder2
* Signature: ()V
*/
JNIEXPORT void JNICALL Java_TestDel_delFolder2
  (JNIEnv *, jclass);
#ifdef __cplusplus
}
#endif
#endif


在具体实现的时候，我们只关心几个函数原型 ：
JNIEXPORT void JNICALL Java_TestDel_creFolder
  (JNIEnv *, jclass);
JNIEXPORT void JNICALL Java_TestDel_delFolder1
  (JNIEnv *, jclass);
JNIEXPORT void JNICALL Java_TestDel_delFolder2
  (JNIEnv *, jclass);
这里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"):

#include
#include
#include
#include
#include
#include
#include "TestDel.h"

JNIEXPORT void JNICALL Java_TestDel_creFolder(JNIEnv *, jclass)
{
int i,j;
char buf1[20];
char buf2[20]="./Folder/";
char buf3[20];
mkdir("Folder");
for(i=0;i<100;i++)
{
    itoa(i,buf1,10);
mkdir(strcat(buf2,buf1));
strcpy(buf3,strcat(buf2,"\\"));
for(j=0;j<100;j++)
{
  itoa(j,buf1,10);
  mkdir(strcat(buf2,buf1));
  strcpy(buf2,buf3);
}
strcpy(buf2,"./Folder/");
}
}

JNIEXPORT void JNICALL Java_TestDel_delFolder1
  (JNIEnv *, jclass)
{
int i,j;
char buf1[20];
char buf2[20]=".\\Folder\\";
char buf3[20];
for(i=0;i<100;i++)
{
  itoa(i,buf1,10);
  strcat(buf1,"\\");
  strcpy(buf3,strcat(buf2,buf1));
  for(j=0;j<1000;j++)
  {
   itoa(j,buf1,10);
   rmdir(strcat(buf2,buf1));
   strcpy(buf2,buf3);
  }
  rmdir(buf3);
  strcpy(buf2,".\\Folder\\");
}

}
JNIEXPORT void JNICALL Java_TestDel_delFolder2
  (JNIEnv *, jclass)
{
  char   cmd[50];    
  strcpy(cmd,"rmdir /s/q ");
  strcat(cmd,"Folder");  
  system(cmd);    

}

注 意：一定要把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中需要调用库名的一致，这里可以修改为cjw.dll。

3 运行程序

把cjw.dll拷贝到TestDel.class的目录下，java TestDel运行它，就可以观察到结果了。这里实现的功能是统计删除文件夹的时间。