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

一、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.jnagroupId>
    <artifactId>jnaartifactId>
    <version>5.9.0version>
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 
#include 
#include 
#include 

/**
 * 返回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（二）