用CLion实现本地方法并给java调用
众所周知,PHP是世界上最好的语言,java排第二,因为PHP无所不能。但是在某些场景下java还要调用本地方法来提高执行的效率,故java只能排第二。java提供了jni(Java Native Interface)来实现在java中调用本地方法。本地方法在java中用native关键字标识,它是一种和机器有关的方法,一般用C或C++实现,而本地方法不是跨平台的,不同的平台需要重新编译。jdk中就有不少地方用了native方法,比如Object类中的hashCode方法:
public native int hashCode();
下面开始使用jni:
(一)创建一个带有native方法的类
package com.example.jni;
public class JNIObject {
private String name;
public JNIObject(String name) {
this.name = name;
}
public String getName() {
return this.name;
}
public int add(int param1, int param2) {
return param1 + param2;
}
public int sub(int param1, int param2) {
return param1 - param2;
}
public native int multi(int param1, int param2);
public native int div(int param1, int param2);
}
我们假定加减法执行效率高可以直接用java实现,而乘除法比较慢,需要用C语言来实现。写好了类我们先编译,把java文件编译成class文件,然后再用javah命令生成c头文件,执行javah命令时要注意,我们需要先把当前的工作目录切换到class所在的根目录,就是包的第一级目录所在的目录。比如我们的包名是com.example.jni,那么我们需要切换到com目录所在的目录,执行的命令格式是javah [-option] 包名.类名
javah -jni com.example.jni.JNIObject
成功后会在当前的工作目录生成一个.h的文件(com_example_jni_JNIObject.h),到此我们就得到了本地方法的接口了,如果有c程序员,可以让他们实现,否则看第2步。
(二)在CLion中实现native方法
如果没有CLion先请自行安装。
- 创建一个C Library项目,填好路径和项目名,Library type选择shared,Language standard是指c语言的不同标准,类似于我们的jdk的版本,如果你不是c程序员,直接用默认的C99标准就好了
- 设置编译环境
如果你使用过Visual Studio的话,你可能安装之后直接创建项目就能写代码了,但是CLion有点不同,它只是一个开发集成环境,只提供了构建工具cmake,并没有提供编译器(Visual Studio全套都提供好了),这可以让开发者自由去选择自己喜欢的编译器,我们打开File->Settings,并选中Build,Execution,Deployment下的Toolchains
可以看到CLion列出了两个常用的编译器MinGW和Cygwin,这里我们使用MinGW作为我们的编译器。需要注意的是如果你的jdk是64位的,那么也要选择64位的MinGW,不然在调用的时候会出错,下面是windows下的MinGW64位下载地址
http://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win32/Personal%20Builds/mingw-builds/installer/mingw-w64-install.exe/download
下载后直接安装就行了,安装成功后在上图中的Environment选择MinGW的home目录,然后下面的C、C++编译器还有调试器都会根据选择的目录自动找到相关工具,然后点OK就完成了我们的编译器的设置。
- 实现native方法
我们先把第一步生成的c头文件(com_example_jni_JNIObject.h)复制到CLion项目中,这时在打开的com_example_jni_JNIObject.h文件顶部出现一行提示:This file dose not belong to any project target, code insight features might not work properly. 这时我们打开CMakeLists.txt文件,在add_library中加入我们的头文件,完成后点击提示的reload changes,完成后的CMakeLists.txt的内容如下:
cmake_minimum_required(VERSION 3.15)
project(jni C)
set(CMAKE_C_STANDARD 99)
add_library(jni SHARED library.c library.h com_example_jni_JNIObject.h)
再切换到com_example_jni_JNIObject.h可以发现刚才的警告已经消失了,但是第二行的#include <jni.h>报错了,这时因为MinGW编译器没有jni.h这个头文件,打开JDK的home目录,在include目录中可以找到jni.h头文件,除此之外,我们还需要include/win32目录下的jni_md.h头文件,一共两个,把这两个头文件都复制到MinGW安装目录(就是设置编译环境时的那个Environment的值)下的x86_64-w64-mingw32中的include目录中,注意这两个头文件是一起放在MinGW的这个目录的,jni_md.h不需要另外创建一个win32目录来存放。完成后发现com_example_jni_JNIObject.h的报错消失了。
我们右键点击项目,选择New->C/C++ Source File,然后创建一个源码文件,type选择.c,如果你习惯使用C++就选.cpp
点击OK完成,下面是具体的实现
#include "com_example_jni_JNIObject.h"
JNIEXPORT jint JNICALL Java_com_example_jni_JNIObject_multi
(JNIEnv *env, jobject o, jint param1, jint param2) {
return param1 * param2;
}
JNIEXPORT jint JNICALL Java_com_example_jni_JNIObject_div
(JNIEnv *env, jobject o, jint param1, jint param2) {
return param1 / param2;
}
解释一下上面的源文件,#include是把后面的com_example_jni_JNIObject.h头文件包含进来,和java的import作用类似,下面的两个方法就是在这个头文件中声明的函数,c语言在声明函数时可以忽略参数名,只写参数类型,但是现在我们是在实现函数,所以必须加上参数名。如果是学习过c语言的很容易理解,没学过的了解一下就好。
- 编译动态链接库
到此,我们的代码就完成了,点击菜单栏的Build->Build Project成功后在在左侧的项目结构里生成了一些文件,其中cmake-build-debug目录下的libjni.dll就是我们需要的动态链接库了,如果是linux系统,生成的是.so格式的文件。
(3)在java中调用native方法
回到java目录,我们在项目的根目录下创建一个jni目录,把我们的dll文件复制进去,复制好之后会自动打开,发现是乱码,因为dll文件是二进制格式的,我们直接关掉。
在JNIObject类中添加一个静态代码块,用来加载我们的动态链接库,完成后的JNIObject类如下:
public class JNIObject {
static {
System.loadLibrary("libjni");
}
private String name;
public JNIObject(String name) {
this.name = name;
}
...
}
注意loadLibrary方法不用写dll后缀名。
我们新建一个测试类Main,代码如下:
package com.example.main;
import com.example.jni.JNIObject;
public class Main {
public static void main(String[] args) {
JNIObject jniObject = new JNIObject("jni");
System.out.println(jniObject.getName()); // 调用java方法
System.out.println(jniObject.add(1, 2)); // 调用java方法
System.out.println(jniObject.sub(1, 2)); // 调用java方法
System.out.println(jniObject.multi(2, 3)); // 调用native方法
System.out.println(jniObject.div(6, 2)); // 调用native方法
}
}
我们先运行一个Main类的main方法,发现报错了:
Exception in thread "main" java.lang.UnsatisfiedLinkError: no libjni in java.library.path
at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1860)
at java.lang.Runtime.loadLibrary0(Runtime.java:870)
at java.lang.System.loadLibrary(System.java:1122)
at com.example.jni.JNIObject.<clinit>(JNIObject.java:6)
at com.example.main.Main.main(Main.java:8)
这是因为我们还没有指定jni库的加载路径,导致loadLibrary方法无法找到我们的dll库。点开运行按钮下拉菜单的Edit Configurations,我们给Main类加一个启动参数-Djava.library.path,这个参数就是异常信息出现的参数,指定值为jni目录
重新运行main方法,可以看到已经可以正常执行native方法了。
总结
总结一下jni的调用过程,先定义好native方法,然后通过javah生成头文件,然后用C或C++实现函数,编译成动态链接库,把动态链接库加入到java项目当中,通过System.loadLibrary(String)方法加载,最后就可以调用了。