关于java的JNI

author: scruffybear

release time: 28/10/2006

company: Watchdata

如有转载，请注明出处，并保持文章的完整性，谢谢！

    做java卡开发需要用到JNI,也就是本地化接口,说白了java程序要用到其它语言代码,这样就可以使用JNI来进行达到调用的目的,暂时理解到这里,还没有时间细究。网上看到了一篇很好的介绍JNI的文章《JNI入门介绍上》、《JNI入门介绍下》，只研究了前一篇，进行了实践，后一篇实践觉得写得不好，没有花时间进行实践。

1．简介
　　
　　JNI是Java Native Interface的缩写，它的设计目的是：
　　
　　The standard Java class library may not support the platform-dependent features needed by your application.
　　
　　You may already have a library or application written in another programming language and you wish to make it accessible to Java applications.
　　
　　You may want to implement a small portion of time-critical code in a lower-level programming language, such as assembly, and then have your Java application call these functions
　　
2．JNI的书写步骤
　　
　　编写带有native声明的方法的java类
　　
　　使用javac命令编译所编写的java类
　　
　　使用javah -jni java类名生成扩展名为h的头文件
　　
　　使用C/C++实现本地方法
　　
　　将C/C++编写的文件生成动态连接库
　　
　　ok
　　
1) 编写java程序：
　　
　　这里以HelloWorld为例。
　　
　　代码1：
　　
　　class HelloWorld {
　　public native void displayHelloWorld();
　　
　　static {
　　System.loadLibrary("hello");
　　}
　　
　　public static void main(String[] args) {
　　new HelloWorld().displayHelloWorld();
　　}
　　}
　　
    声明native方法：如果你想将一个方法做为一个本地方法的话，那么你就必须声明改方法为native的，并且不能实现。其中方法的参数和返回值在后面讲述。
　　
　　Load动态库：System.loadLibrary("hello");加载动态库（我们可以这样理解：我们的方法displayHelloWorld()没有实现，但是我们在下面就直接使用了，所以必须在使用之前对它进行初始化）这里一般是以static块进行加载的。同时需要注意的是System.loadLibrary();的参数“hello”是动态库的名字。
　　
　　main()方法
　　
　　2) 编译没有什么好说的了
　　
　　javac HelloWorld.java

    这里是运行不了的，因为这时候目录下面没有hello.dll文件供调用，如果输入java HelloWorld会出现以下错误：
   C:/Documents and Settings/huilin.xiong/桌面>java HelloWorld
   Exception in thread "main" java.lang.UnsatisfiedLinkError: no hello in java.library.path
        at java.lang.ClassLoader.loadLibrary(Unknown Source)
        at java.lang.Runtime.loadLibrary0(Unknown Source)
        at java.lang.System.loadLibrary(Unknown Source)
        at HelloWorld.<clinit>(HelloWorld.java:5)

    下面就用c语言生成hello.dll文件供java语言来调用。如下：
　　
3) 生成扩展名为h的头文件
　　
　　javah -jni HelloWorld

    在这里自动生成文件名为HelloWorld.h的头文件。
　　
　　头文件的内容：
　　/* DO NOT EDIT THIS FILE - it is machine generated */
　　#include
　　/* Header for class HelloWorld */
　　
　　#ifndef _Included_HelloWorld
　　#define _Included_HelloWorld
　　#ifdef __cplusplu*
　　**tern "C" {
　　#endif
　　/*
　　* Class:　　 HelloWorld
　　* Method:　　displayHelloWorld
　　* Signature: ()V
　　*/
　　JNIEXPORT void JNICALL Java_HelloWorld_displayHelloWorld
　　(JNIEnv *, jobject);
　　
　　#ifdef __cplusplus
　　}
　　#endif
　　#endif
　　
　　（这里我们可以这样理解：这个h文件相当于我们在java里面的接口，这里声明了一个Java_HelloWorld_displayHelloWorld (JNIEnv *, jobject);方法，然后在我们的本地方法里面实现这个方法，也就是说我们在编写C/C++程序的时候所使用的方法名必须和这里的一致）。
　　
4) 编写本地方法
　　
　　实现和由javah命令生成的头文件里面声明的方法名相同的方法。
　　
　　代码2：
　　
　　#include <jni.h>
　　#include "HelloWorld.h"
　　#include <stdio.h>
　　JNIEXPORT void JNICALL Java_HelloWorld_displayHelloWorld(JNIEnv *env,jobject obj)
　　{
　　printf("Hello world!/n");
　　return;
　　}
　　
　　注意代码2中的第1行，需要将jni.h（该文件可以在%JAVA_HOME%/include文件夹下面找到）文件引入，因为在程序中的JNIEnv、jobject等类型都是在该头文件中定义的；另外在第2行需要将HelloWorld.h头文件引入（我是这么理解的：相当于我们在编写java程序的时候，实现一个接口的话需要声明才可以，这里就是将HelloWorld.h头文件里面声明的方法加以实现。当然不一定是这样）。然后保存为HelloWorldImpl.c就ok了。
　　
　　5) 生成动态库
　　
　　这里以在Windows中为例，需要生成dll文件。在保存HelloWorldImpl.c文件夹下面，使用VC的编译器cl成。
　　
　　cl -I%java_home%/include -I%java_home%/include/win32 -LD HelloWorldImp.c -Fehello.dll
　　
　　注意：生成的dll文件名在选项-Fe后面配置，这里是hello，因为在HelloWorld.java文件中我们loadLibary的时候使用的名字是hello。当然这里修改之后那里也需要修改。另外需要将-I%java_home%/include -I%java_home%/include/win32参数加上，因为在第四步里面编写本地方法的时候引入了jni.h文件。
    
    这里在实际的操作中找不到头文件<stdio.h>，找不出原因，检查了我的环境变量设置也没有错，没办法，只有从目录D:/Software/Microsoft Visual Studio .NET/Vc7/include目录下拷贝过来，另外又找不到stdarg.h，一并拷贝过来。头文件都找不到后，又出现了找不到好几个LIB文件，分别为libcmt.lib，oldnames.lib，kernel32.lib，检查环境变量也没错，没办法，只能从D:/Software/Microsoft Visual Studio.NET/Vc7/lib拷贝过来。最后在目录下生成了这样几个文件：HelloWorldImpl.obj，hello.dll，hello.exp，hello.lib，当然，只有hello.dll是有用的，它是被HelloWorld.class所调用。
　　
　　6) 运行程序
　　
　　java HelloWorld，输出了硕大的“Hello world!”。:-)