一. 简介
JNI 是Java Native Interface的缩写,它提供了若干的API 实现了Java和其他语言的通信(主要是C&C++)。从Java1.1开始,JNI标准成为java平台的一部分,它允许Java代码和其他语言写的代码进行交互。JNI一开始是为了本地已编译语言,尤其是C和C++而设计的,但是它并不妨碍你使用其他编程语言,只要调用约定受支持就可以了。使用java与本地已编译的代码交互,通常会丧失平台可移植性。但是,有些情况下这样做是可以接受的,甚至是必须的。例如,使用一些旧的库,与硬件、操作系统进行交互,或者为了提高程序的性能。
二. 编写
写一个调用本地方法的类主要有以下步骤:
1. 编写一个声明了native 方法的类
public class JniCall {
static {
File file = new File("src/main/java/libtest.so");
System.load(file.getAbsolutePath()); // 加载本地库
// System.loadLibrary("libtest"); // 也是加载库,和上一个方法有些区别,稍后再说
}
public JniCall() {
}
public static native void sayHello(); // 声明native 方法
}
2. 使用javac 命令编译上面的类
javac JniCall.java
3. 使用javah 命令生成头文件
javah com.xxx.JniCall
注意: 在命令中使用的是类的全限定名,所以这个命令要在com 的上一级目录执行。
执行完这个命令之后会生成一个头文件,头文件里会声明Java 类中声明的方法,如下
#include <jni.h>
/* Header for class com_sankuai_meituan_dataopt_JniCall */
#ifndef _Included_com_sankuai_meituan_dataopt_JniCall
#define _Included_com_sankuai_meituan_dataopt_JniCall
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: com_sankuai_meituan_dataopt_JniCall
* Method: sayHello
* Signature: ()V
*/
JNIEXPORT void JNICALL Java_com_sankuai_meituan_dataopt_JniCall_sayHello // 生成的方法
(JNIEnv *, jobject);
#ifdef __cplusplus
}
#endif
#endif
4. 使用C/C++实现本地方法
经过上一步,我们就可以创建一个c 文件来实现这个方法了
#include "com_sankuai_meituan_dataopt_JniCall.h"
JNIEXPORT void JNICALL Java_com_sankuai_meituan_dataopt_JniCall_sayHello(JNIEnv * env, jobject obj) { // 自己实现
printf("hello world\n");
}
5. 使用gcc 命令编译c 文件
gcc -c test.c
当使用这个命令时,可能遇到这样的错误:
fatal error: 'jni.h' file not found
说是找不到jni.h 这个头文件,这是因为com_sankuai_meituan_dataopt_JniCall.h 中使用了#include<jni.h>, gcc默认找include 的目录是"/usr/include",在这个目录下是找不到jni.h文件的,而在Linux 系统中还会出现找不到jni_md.h 这个文件,这两个头文件的位置分别是:
JAVA_HOME/include // jni.h
JAVA_HOME/include/linux // jni_md.h
比如,在Mac 系统中jni.h 文件的路径就是 JavaVirtualMachines/jdk1.8.0_161.jdk/Contents/Home/include,
而要指定包含的头文件jni.h 的位置,应该加“-I <dir>”参数,如果有多个路径就用多个 -I 。所以命令如下:
gcc -I /Library/Java/JavaVirtualMachines/jdk1.8.0_161.jdk/Contents/Home/include/ -c test.c
这时就会编译完成生成test.o 文件
6. 使用gcc 命令将编译过的 o 文件生成库文件
gcc -shared test.o -o libtest.so
执行完就会生成一个 so 库,这时调用第一步创建的类的方法就会调用native 的实现。
注意:
- Linux 下:一定要将本地库命名成libxxx.so 的形式,"xxx"是你在System.loadLibrary("xxx") 中用到的加载库名称。
- Windows 下:一定要将本地库命名成xxx.dll的形式(没有前边的lib三个字母),"xxx" 是你在System.loadLibrary("xxx") 中用到的加载库名称。
编写测试代码:
@Test
public void testJNI() {
JniCall.sayHello();
}
这时,如果JniCall 中加载本地库使用的是 System.loadLibrary("libtest"); 就会抛出异常
java.lang.UnsatisfiedLinkError: no test in java.library.path
at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1867)
at java.lang.Runtime.loadLibrary0(Runtime.java:870)
at java.lang.System.loadLibrary(System.java:1122)
那是因为 java.library.path (Java 加载本地库的地址)中并不存在当前的目录,所以要想让Java 找到这个库,可以进行如下操作:
1. 拷贝libxxx.so 或xxx.dll 到java.library.path 指向的某个目录下面(可以通过System.out.println( System.getProperty("java.library.path")) 查看)
2. 命令行执行,java -Djava.library.path=/test/libs(path后是库的路径)
3. 设置系统环境变量
4. 改用System.load(“”) 方法,该方法传递一个so 库的绝对路径
三. jni 其他
上面只是简单介绍了编写native 方法的一个流程,关于jni 调用,还有许多深层次的东西,比如Java 类型和c、c++ 类型之间的转换,对象的传递、多线程等,可以参考以下几篇文章: