Linux下 JNI的使用

神甫

转载：http://www.cnblogs.com/bastard/archive/2012/05/17/2506877.html
Linux下 JNI的使用
什么是JNI
   JNI是Java native interface的简写，可以译作Java原生接口。Java可以通过JNI调用C/C++的库，这对于那些对性能要求比较高的Java程序无疑是一个福音。JNI是Java与C/C++交互的接口。
   使用JNI也是有代价。大家都知道JAVA程序是运行在JVM之上的，可以做到平台无关。但是如果Java程序通过JNI调用了原生的代码（比如c/c++等），则Java程序就丧失了平台无关性。
代码实例

   下面以HelloWorld的实现学习Linux下 JNI的使用。
第一步：创建一个 TestJni.java文件

import java.util.*;publicclass TestJni{   //声明原生函数：参数为String类型publicnativevoid print(String content);   //加载本地库代码   static   {      System.loadLibrary("TestJni");   }}




编译 TestJni.java文件：javac TestJni.java
在当前文件夹下生成TestJni.class文件
注意print方法的声明，关键字native表明该方法是一个原生代码实现的。
另外注意static代码段的System.loadLibrary调用，这段代码表示在程序加载的时候，自动加载libTestJni.so库。

第二步：生成 TestJni.h文件
执行命令：javah -jni TestJni
生成TestJni.h文件

/* DO NOT EDIT THIS FILE - it is machine generated */#include <jni.h>/* Header for class TestJni */#ifndef _Included_TestJni#define _Included_TestJni#ifdef __cplusplusextern"C" {#endif/* * Class:   TestJni * Method:  print * Signature: (Ljava/lang/String;)V */JNIEXPORT void JNICALL Java_TestJni_print (JNIEnv *, jobject, jstring);#ifdef __cplusplus}#endif#endif



该文件中包含了一个函数Java_TestJni_print的声明。这里面自动包含两个参数，非常重要。JNIEnv *和 jobject

第三步：创建TestJni.c文件

#include <jni.h>#include <stdio.h>#include <TestJni.h>JNIEXPORT void JNICALL   Java_TestJni_print(JNIEnv *env,jobject obj, jstring content){   // 从 instring 字符串取得指向字符串 UTF 编码的指针   //注意C语言必须(*env)->     C++ env->const jbyte *str =      (const jbyte *)(*env)->GetStringUTFChars(env,content, JNI_FALSE);  　　printf("Hello---->%s\n",str);
// 通知虚拟机本地代码不再需要通过 str 访问 Java 字符串。  (*env)->ReleaseStringUTFChars(env, content, (constchar *)str );  return;}



//这里看到 JNIEnv作用了，使得我们可以使用Java的方法
//jobject 指向在此 Java 代码中实例化的 Java 对象 LocalFunction 的一个句柄，相当于 this 指针
参数类型 jstring 对应java中的String，这里是有所不同的。每一个Java里的类型这里有对应的与之匹配。

命令行输入：
cc   -I/usr/lib/jvm/java-6-sun/include/linux/　
      -I/usr/lib/jvm/java-6-sun/include/
　　-I/home/xmp/AndroidProject/apk/JNI
　　-fPIC -shared -o libTestJni.so TestJni.c
生成：libTestJni.so库文件



　　在当前目录生成libTestJni.so。注意一定需要包含Java的include目录（请根据自己系统环境设定），
因为libTestJni.c中包含了jni.h。另外一个值得注意的是在libTestJni.java中我们LoadLibrary方法加载的是“TestJni”，
可我们生成的Library却是libTestJni。这是Linux的链接规定的，
一个库的必须要是：lib+库名+.so。链接的时候只需要提供库名就可以了

　　-I/home/xmp/AndroidProject/apk/JNI 是我自己的练习目录也必须包含，否则.c文件中会找不到TestJni.h头文件。
　　现在 liblibTestJni.so就是一个可以使用的库了，其功能就是有一个print函数 与刚才所创建的TestJni.java文件对应，
TestJni.java类中加载库liblibTestJni.so，声明了其函数print。所以现在TestJni.java中具备使用print函数的功能；
所以现在我们就可以通过使用TestJni.java来使用调用C库libTestJni.so中的函数

当然现在任何java类都可已加载liblibTestJni.so库来使用其中的功能。



第四步：
   创建HelloWord.java函数

import java.util.*;publicclass HelloWorld{   publicstaticvoid main(String argv[])   {     new HelloWorld();   }   public HelloWorld()   {     new TestJni().print("Hello,World !"); //调用TestJni的原生函数print   }}




输入命令编译： javac HelloWorld.java
生成HelloWorld.class

第五步：
   运行HelloWorld程序
命令行输入：java HelloWorld
输出结果：Hello---->Hello,World !
验证OK！

如果你这步发生问题，如果这步你收到java.lang.UnsatisfiedLinkError异常，可以通过如下方式指明共享库的路径：
java -Djava.library.path='.' HelloWorld

或者输入命令：
export LD_LIBRARY_PATH=“HelloWorld路径”:$LD_LIBRARY_PATH  设置环境变量
然后再 java HelloWorld 一样OK

简单例子，照着以下参考文档即可实现。

参考文档：
http://my.unix-center.net/~Simon_fu/?p=359
http://www.ibm.com/developerworks/cn/java/l-linux-jni/
JNIEnv功能参考：
http://docs.oracle.com/javase/1.5.0/docs/guide/jni/spec/functions.html