原则上来说,“100%纯Java”的解决方法是最好的,但有些情况下必须使用本地方法。特别是在以下三种情况:
- 需要访问Java平台无法访问的系统特性和设备;
- 通过基准测试,发现Java代码比其他语言编写的等价代码慢得多;
- 其他语言编写的代码已经经过大量测试和调试,并且知道如何将其导出到所有的目标平台上。
Java平台有一个用于和本地C、C++代码进行互操作的API,称为Java本地接口(JNI)。下面将举例讨论Linux平台下的JNI编程。
1. 创建java类文件
创建一个nativeTest包,在包下新建HelloNative.java文件。
package nativeTest; /**
* Created by jiax on 2016/12/30.
*/
public class HelloNative {
// 静态初始化代码块,保证虚拟机在第一次使用该类时就会装载库
static {
System.loadLibrary( "HelloNative" );
} // native 关键字表示本地方法,提醒编译器该方法将在外部定义
public static native void greeting(); // 测试greeting()函数
public static void main(String[] args) {
greeting();
}
}
2. 生成.h头文件
使用以下命令生成一个C的头文件,nativeTest_HelloNative.h
javac HelloNative.java
cd ..
javah nativeTest.HelloNative
生成的nativeTest_HelloNative.h如下:
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class nativeTest_HelloNative */ #ifndef _Included_nativeTest_HelloNative
#define _Included_nativeTest_HelloNative
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: nativeTest_HelloNative
* Method: greeting
* Signature: ()V
*/
JNIEXPORT void JNICALL Java_nativeTest_HelloNative_greeting
(JNIEnv *, jclass); #ifdef __cplusplus
}
#endif
#endif
nativeTest_HelloNative.h
这个文件是在nativeTest文件夹外生成的,需要拖到nativeTest文件夹里面。
3. 创建.c文件
新建一个HelloNative.c文件,写出greeting()函数的实现代码。
#include <stdio.h>
#include "nativeTest_HelloNative.h" JNIEXPORT void JNICALL Java_nativeTest_HelloNative_greeting(JNIEnv *env, jobject c1) {
printf("Hello Native!!\n");
}
4. 编译一个动态链接库
使用Linux下的gcc编译器,命令如下:
gcc -fPIC -I $JAVA_HOME/include -I $JAVA_HOME/include/linux -shared -o libHelloNative.so HelloNative.c
生成libMyNative.so文件,此时整个nativeTest目录文件结构如下:
5. 运行测试
输入如下命令运行HelloNative.class文件。
java nativeTest.HelloNative
如果出现如下错误:
则需要把libHelloNative.so所在文件夹加入java.library.path,使用命令:
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:..../nativeTest
最终结果如下。
6 总结
总的来说,将一个本地方法链接到Java程序中需要经过以下5个步骤:
- 在Java类中声明一个本地方法;
- 运行javah以获得包含该方法的C声明的头文件;
- 用C实现该本地方法;
- 将代码置于共享类库中;
- 在Java程序中加载该类库。
附录——本文中用到的工具版本
JDK——1.8.0_111
gcc——4.8.5