JNI便捷开发框架JNA框架之入门（一）

article/2025/10/8 4:25:50

一、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的方式，大大降低了开发成本。

–

下一篇：JNI便捷开发框架JNA框架之指针参数Pointer（二）