jni入门学习笔记（一）

最终解释权，最终收益权,最终处决权属于csdn的laomai(老迈)!

本文主要参考 http://www.programfan.com/article/showarticle.asp?id=1660

一、去年曾经做过一个JAVA和C通信的项目，用C语言实现某个特定功能函数，然后在JAVA中调用。最近又有朋友问起，于是将做过的东西整理成学习笔记，希望对后来者有所帮助，呵呵。

二、jni例子简介

jni-java native interface是java与其他语言本地通信的接口，按照jni的约定，java程序可以调用其他语言编写的函数，其他语言也可以调用java实现的方法，本文介绍了一个最简单的java调用c方法的例子。主要由两部分组成，

一个是java主程序，另一个是被调用的dll（由C语言实现）

三、编写步骤

1、java主程序

//文件testdll.java

public class testdll
{
        static
        {
               System.loadLibrary("goodluck");     //goodluck为调用的库名,不必加dll后缀
        }  

        /*下面两个函数为C语言实现的方法*/
        public native static int get();
        public native static void set(int i);

       //主函数
        public static void main(String[] args)
        {
                testdll test = new testdll();
                test.set(10);                                         //调用了在C中实现的方法set
                System.out.println(test.get());          //调用了在C中实现的方法get
                System.out.println("hello world!/n");
        }
}

2、得到C所需的头文件

 执行如下命令（假设jdk的安装路径为D:/Java/jdk1.5.0/bin）

    D:/Java/jdk1.5.0/bin/javac   testdll.java                                         #生成testdll.class文件

   D:/Java/jdk1.5.0/bin/javah   testdll                                                  #根据testdll.class生成testdll.h文件

 

3、用c语言生成所需的dll

(1) 打开vc6, 建立一个空的dll项目。

       菜单里选"File"->New->Projects->Win32  dynamic link library,项目名为gookluck（与java文件中的调用库名保持一致），第二步里选an empty DLL project.

(2)把前面生成的testdll.h复制到这个项目中，再新添下面的testdll.cpp文件

#include "testdll.h"

int i = 0;
JNIEXPORT jint JNICALL Java_testdll_get (JNIEnv *, jclass)
{
        return i;
}

JNIEXPORT void JNICALL Java_testdll_set (JNIEnv *, jclass, jint j)
{
         i = j;
}

此时编译会报错，因为还缺少几个头文件，因此要把下面两个文件复制到项目目录中或者vc的头文件目录 (即Microsoft Visual Studio/VC98/Include)中,jni.h文件和jni_md.h文件，在我机器这两个文件原始目录为

D:/Java/jdk1.5.0/include/jni.h

D:/Java/jdk1.5.0/include/win32/jni_md.h

再次编译，运行通过

4、测试运行

    将3中得到的testdll.dll文件拷贝到testdll.class所在目录下，执行

    D:/Java/jdk1.5.0/bin/java testdll

    运行结果为

    10
    hello world!

   说明调用正确。

 

五、几个注意事项

1、System.loadLibrary("goodluck"); 一句，有时在别的情况下会报错，主要原因是程序找不到这个库文件所在的路径，此时可以检查path环境变量是否包含了合适的路径，或者把dll文件拷贝到系统的dll目录下，如C:/WINNT/system32下

2、库文件不必写后缀名，写了反而可能错，因为这时程序会去找testdll.dll.dll文件，自然是不存在了：—)

3、要调用的方法做本地声明，关键字为native。并且只需要声明，而不需要具体实现。如：
      public native static void set(int i);
      public native static int get();

4、函数返回类型尽量用jni中的基本类型（如整型、字符等），最好不要返回自定义的类，那样在c里有可能会引起错误。

5、在c中写具体实现的时候，我们只关心两个函数原型

JNIEXPORT jint JNICALL Java_testdll_get (JNIEnv *, jclass);


JNIEXPORT void JNICALL Java_testdll_set (JNIEnv *, jclass, jint);

这里JNIEXPORT都是JNI的关键字，表示此函数是要被java调用的，如果是其他语言调java语言，JNIEXPORT就要变成JNIIMPORT了。

JNICALL告诉C编译器参数进栈的方式，我们不必关心.

jint是以JNI为中介使JAVA的int类型与本地c语言的int沟通的一种类型，我们就当做int使用。其他类型名可以去查jni帮助文档.

函数的名称是JAVA_再加上java程序的package路径再加函数名组成的。

参数中，我们也只需要关心在JAVA程序中存在的参数，即第三个往后的参数。至于JNIEnv*和jclass我们一般没有必要去碰它。

知道这些约定后，我们没有javah程序也可以自己手工写出testdll.h文件来，不过麻烦些就是了^O^

六、jni的其他参考资料

jni属于java语言的一部分，其权威资料自然要到sun的站点上查找(www.sun.com)

以下是我在sun公司网站上找到的一些页面

http://java.sun.com/developer/onlineTraining/Programming/JDCBook/jniexamp.html

给出了一个jni的例子，

http://java.sun.com/j2se/1.4.2/docs/guide/jni/index.html

给出了完整的jni介绍，

七、附javah生成的testdll.h文件。

/* DO NOT EDIT THIS FILE - it is machine generated */
#include "jni.h"
/* Header for class testdll */

#ifndef _Included_testdll
#define _Included_testdll
#ifdef __cplusplus
extern "C" {
#endif

/*
 * Class:     testdll
 * Method:    get
 * Signature: ()I
 */
JNIEXPORT jint JNICALL Java_testdll_get
  (JNIEnv *, jclass);

/*
 * Class:     testdll
 * Method:    set
 * Signature: (I)V
 */
JNIEXPORT void JNICALL Java_testdll_set
  (JNIEnv *, jclass, jint);

#ifdef __cplusplus
}
#endif
#endif