-
JNIEXPORT
和JNICALL
是jni
中定义的两个宏,使用JNIEXPORT
支持在外部程序代码中调用该动态库中的方法,使用JNICALL
定义函数调用时参数的入栈出栈约定 -
函数名称由包名+类名+方法名组成,在该方法中有两个参数,通过第一个参数
JNIEnv *
的对象可以调用jni.h
中封装好的大量函数 ,第二个参数代表着native
方法的调用者,当java代码中定义的native
方法是静态方法时这里的参数是jclass
,非静态方法的参数是jobject
接下来我们创建一个cpp
文件,引用头文件并实现其中的函数,也就是native
方法将要实际执行的逻辑:
#include “com_cn_jni_JniTest.h”
#include <stdio.h>
JNIEXPORT void JNICALL Java_com_cn_jni_JniTest_callCppMethod
(JNIEnv *, jclass)
{
printf(“Print From Cpp: \n”);
printf(“I am a cpp method ! \n”);
}
在方法的实现中加入简单的printf
打印语句,在完成方法的实现后,我们需要将上面的cpp
文件编译为动态链接库,提供给java中的native
方法调用,因此下面需要在window环境下安装gcc
环境。
3、gcc环境安装
在window环境下,如果你不希望为了生成一个dll
就去下载体积庞大的的Visual Studio
的话,MinGW
是一个不错的选择,简单的说它就是一个windows版本下的gcc
。那么估计有的同学又要问了,gcc
是什么?简单的来说就是linux系统下C/C++
的编译器,通过它可以将源代码编译成可执行程序。首先从下面的网址下载mingw-get-setup
的安装程序:
http://sourceforge.net/projects/mingw/ #32位
https://sourceforge.net/projects/mingw-w64/ #64位
需要注意,一定要按照系统位数安装对应的版本,否则后面生成的dll
在运行时就可能会因位数不匹配而报错,我在实验的过程中第一次就错误安装了32位的MinGw
,导致了在程序运行过程中报了下面错误:
Exception in thread “main” java.lang.UnsatisfiedLinkError:
F:\Workspace20\unsafe-test\src\main\java\com\cn\jni\jni\MyNativeDll.dll:
Can’t load IA 32-bit .dll on a AMD 64-bit platform
安装完成后,将MinGW\bin
目录加入系统环境变量PATH
,输入下面的指令测试gcc
是否可以使用:
gcc -v
如果能够正常输出gcc
的版本信息,说明gcc
安装成功:
在测试的过程中发现,如果安装的是64位的mingw
,那么在安装完成后gcc
就已经直接可以可用。但是如果安装的是32位的mingw
,需要使用下面的命令单独安装gcc
:
mingw-get install gcc
gcc
安装完成后,如果还想安装gdb
或make
等其他指令进行调试或编译,同样可以使用强大的mingw-get
命令进行独立安装。
4、生成动态链接库
在gcc
环境准备好的条件下,接下来使用下面的命令生成dll
动态链接库:
gcc -m64 -Wl,–add-stdcall-alias -I"D:\Program Files\Java\jdk1.8.0_261\include"
-I"D:\Program Files\Java\jdk1.8.0_261\include\win32"
-shared -o MyNativeDll.dll JniTestImpl.cpp
简单的解释一下各个参数的含义:
-
-m64
:将cpp代码编译为64位的应用程序 -
-Wl,--add-stdcall-alias
:-Wl
表示将后面的参数传递给连接程序,参数--add-stdcall-alias
表示带有标准调用后缀@NN
的符号会被剥掉后缀后导出 -
-I
:指定头文件的路径,在生成的头文件代码中引入的jni.h
就在这个目录下 -
-shared
:指定生成动态链接库,如果不使用这个标志那么外部程序将无法连接 -
-o
:指定目标的名称,这里将生成的动态链接库命名为MyNativeDll.dll
-
JniTestImpl.cpp
:被编译的源程序文件名
在指令的执行过程中,都做了什么事呢,可以参考下面这张图:
在执行过程中,以.cpp
源代码和.h
头文件作为源文件,先进行了预处理、编译、汇编的操作,图中省略了这一阶段产生的一些中间文件,编译完成后生成的.o
二进制文件相对重要,依赖这个文件,最终生成动态链接库。
在执行了上面的指令后,就会在当前目录下生成一个MyNativeDll.dll
文件,再运行之前准备好的java代码:
程序报错,这是因为在默认的载入库文件的目录下没有找到我们的dll
文件。有两种方式可以解决:
-
直接将
dll
文件拷贝到默认的加载目录下,具体的路径可以通过System.getProperty("java.library.path")
获取,该方法可能会获得多个目录,放在任意一个目录下即可 -
是在
VM Option
中修改启动参数,指定dll
的存放目录:
-Djava.library.path=F:\Workspace20\unsafe-test\src\main\java\com\cn\jni\jni
再次执行,输出结果:
DLL path:F:\Workspace20\unsafe-test\src\main\java\com\cn\jni\jni
Print From Cpp:
I am a cpp method !
可以看到程序加载dll
的路径已经切换成了它的存放路径,并且通过jni
调用成功,输出了在c++中的代码逻辑。可以用下面的图来总结上面实现jni
调用的过程:
在对jni
的调用有了一个整体的了解后,如果大家对代理模式比较熟悉的话,也可以从代理模式的角度来理解jni
,将jni
调用过程中的各个角色带入到代理模式中:
-
代理角色:包含
native
方法的jni
类 -
实现角色:c/c++或其他语言实现的动态链接库
-
客户端:调用
native
方法的java类程序 -
接口(抽象角色):在
jni
中接口这一角色的存在感相对薄弱,因为jni
是跨语言的,所以说无法严格的定义一个接口并让它同时应用于java和其他语言。但是通过生成的.h
头文件,在一定程度上实现了从接口规范上统一了java中native
方法和其他语言中的函数
以代理模式的概述图来进行描述:
上图在标准代理模式的基础上做了一些修改以便于理解,因为这里的接口只做规范约束作用,所以让客户端的调用过程跳过了接口,直接指向了代理角色,再由代理角色调用实现角色完成功能的调用。总的来说,jni
起到了一个代理或中介的作用,与常见代理不同的是这里只做方法的调用,而不实现逻辑上的增强。通过这一模式,向java程序员隐藏了底层c/c++代码的实现细节,让我们专注于业务代码的编写即可。
总结
在前面对native
方法有了一定了解的基础上,本文介绍了jni
的相关知识。通过本文的学习,有助于我们:
-
理解java的为何能够做到跨平台,以及依赖操作系统的底层操作是如何实现的
-
了解
native
方法的调用过程,在必要时可以自己实现jni
类接口调用 -
回顾一些C/C++知识
当然了,使用jni
也会带来一些缺点:
-
当在某个操作系统下使用了
jni
标准,将本地代码编译生成了动态链接库后,如果要将这个程序移植到其他操作系统,需要在新的平台重新编译代码生成动态链接库 -
对其他语言的不正确使用可能会造成程序出现错误,例如之前提到的使用c语言进行内存操作时未及时回收内存可能引起的内存泄漏
最后
现在正是金三银四的春招高潮,前阵子小编一直在搭建自己的网站,并整理了全套的**【一线互联网大厂Java核心面试题库+解析】:包括Java基础、异常、集合、并发编程、JVM、Spring全家桶、MyBatis、Redis、数据库、中间件MQ、Dubbo、Linux、Tomcat、ZooKeeper、Netty等等**
加入社区:https://bbs.csdn.net/forums/4304bb5a486d4c3ab8389e65ecb71ac0
到的使用c语言进行内存操作时未及时回收内存可能引起的内存泄漏
最后
现在正是金三银四的春招高潮,前阵子小编一直在搭建自己的网站,并整理了全套的**【一线互联网大厂Java核心面试题库+解析】:包括Java基础、异常、集合、并发编程、JVM、Spring全家桶、MyBatis、Redis、数据库、中间件MQ、Dubbo、Linux、Tomcat、ZooKeeper、Netty等等**
[外链图片转存中…(img-Rs9nDSrr-1725675353749)]
加入社区:https://bbs.csdn.net/forums/4304bb5a486d4c3ab8389e65ecb71ac0