一、JNA介绍
JNA(Java Native Access)框架是一个开源的Java框架,是SUN公司主导开发的,建立在经典的JNI的基础之上的一个框架。它提供一组Java工具类用于在运行期动态访问系统本地共享类库而不需要编写任何Native/JNI代码。开发人员只要在一个java接口中描述目标native library的函数与结构,JNA将自动实现Java接口到native function的映射。
二、JNA调用过程
JNA调用C/C++的过程大致如下:
也就是说,不需要写任何C/C++的代码,我们就能调用C/C++的程序里面的程序
三、JNA版本与依赖
目前最高版本是5.9.0,JNA的项目是放在Github【点击访问】上面
maven项目可以使用直接依赖
<dependency>
<groupId>net.java.dev.jna</groupId>
<artifactId>jna</artifactId>
<version>5.9.0</version>
</dependency>
普通java项目可以直接下载 jna-5.9.0.jar【点击访问】 然后引入项目中即可使用,引入方法可以参照 IDEA 导入外部JAR文件【点击访问】
四、 JNA使用演示
demo项目说明:
1、普通java项目,程序入口是main函数
2、c语言文件hello.c,生成动态链接库文件libhello.so
3、项目结构类HelloJNA加载libhello.so,调用其指定方法完成a+b的计算,返回计算结果
4、项目结构如下:
1、hello.c
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <syslog.h>
/**
* 返回a+b的值
*/
int add(int a, int b){
return a + b;
}
2、HelloJNA.java
import com.sun.jna.Library;
import com.sun.jna.Native;
/**
* 一个java类
* 运行环境是linux,需要打包生成jar文件放到linux环境运行
*/
public class HelloJNA {
/**
* 定义一个接口,默认的是继承Library ,如果动态链接库里的函数是以stdcall方式输出的,那么就继承StdCallLibrary
* 这个接口对应一个动态链接(SO)文件
*/
public interface LibraryAdd extends Library {
// 这里使用绝对路径加载
LibraryAdd LIBRARY_ADD = Native.load("/program/cpp/libhello.so", LibraryAdd.class);
/**
* 接口中只需要定义你要用到的函数或者公共变量,不需要的可以不定义
* 映射libadd.so里面的函数,注意类型要匹配
*/
int add(int a, int b);
}
public static void main(String[] args) {
// 调用so映射的接口函数
int add = LibraryAdd.LIBRARY_ADD.add(10, 15);
System.out.println("相加结果:" + add);
}
}
3、项目打包
打包java程序成可执行jar,具体可参考 该文章后半部分打包步骤【点击访问】 打包完之后,将 JNATestC.jar 文件上传到linux的 /program/cpp/ 目录
4、so文件
生成so动态链接库
把 hello.c 放到linux环境的 /program/cpp/ 目录下,并在该目录下运行
gcc -fPIC -I $JAVA_HOME/include -I $JAVA_HOME/include/linux -shared -o libhello.so hello.c
5、运行程序
进入 /program/cpp/ 目录
cd /program/cpp/
此时 /program/cpp/ 文件列表是
执行java程序,执行结果符合预期
五、总结
通过上面一个简单的例子,我们可以看到,java项目里面不需要写任何除java外的程序就可以完成调用外部C/C++的程序。特别适用于对接第三方服务(程序),在第三方只提供C/C++SDK的时候。 相比于JNI的方式,大大降低了开发成本。