Linux下JNI的使用

 Linux下 JNI的使用

       学习Android其中涉及对JNI的使用,对于这种跨语言的调用真没有见过,

Java也都是最近才学的更别说对JNI的了解了,

JNI的使用对于Android来说又是十分的重要和关键。那么到底Java到底是如何调用C/C++的,

通过网络达人的总结中学习,自己也顺便总结一下这个学习的过程。

什么是JNI

     JNI是Java native interface的简写,可以译作Java原生接口。

Java可以通过JNI调用C/C++的库,这对于那些对性能要求比较高的Java程序无疑是一个福音。

JNI是Java与C/C++交互的接口。

      使用JNI也是有代价。大家都知道JAVA程序是运行在JVM之上的,可以做到平台无关。

但是如果Java程序通过JNI调用了原生的代码(比如c/c++等),则Java程序就丧失了平台无关性。

最起码需要重新编译原生代码部分。所以应用JNI需要好好权衡,不到万不得已,请不要选择JNI,

可以选择替代方案,比如TCP/IP进行进程间通讯等等。这也是为什么谷歌的Android平台的底层虽然用JNI实现,

但是他不建议开发人员用JNI来开发Android上面的应用的原因。将会丧失Android上面的应用程序平台无关性。

代码实例

      下面以HelloWorld的实现学习Linux下 JNI的使用。

第一步:

创建一个 TestJni.java文件

import java.util.*;
public class TestJni
{
      //声明原生函数:参数为String类型
      public native void 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 __cplusplus
extern "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, (const char *)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.*;
public class HelloWorld
{
     public static void 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

     

 

posted @ 2012-05-17 21:55  __Shadow  阅读(25051)  评论(2编辑  收藏  举报