JNA 是基于 JNI(Java Native Interface) 技术的开源工具,能够实现单方向的 Java 调用本地方法(通常是 C/C++ 编写的动态链接库中的函数),在 Windows 中是 .dll 文件,Linux 下是 .so 文件。类似于 JNA 这种跨语言调用的工具还有 JNative 和 SWING 等

JNI 和 JNA 的介绍网络上比较多,本文记录的是自己在使用 JNA 过程中遇到的一些问题及相应的解决办法。注:开发环境为 Windows,IDE 为蒸汽大脑的 IDEA

DLL 文件路径

在调用 DLL 前,我们首先要做的事情就是确认 DLL 的版本和 JDK 的版本是否一致,必须严格区分 32 位和 64 位,否则即使文件路径是正确的,也会抛出无法加载文件的错误

DLL 位数,可以通过 VS 的 CMD 命令dumpbin /headers xxx.dll来查看

  1. IDEA 设置

    • 直接放在src路径下面
    • 放在指定路径,然后在ModulesDependencies中添加JARs or directories选中该文件夹路径
  2. JDK bin 目录下 JRE 的 bin 路径

    这里要注意的是路径为 JDK 目录下的 JRE,如C:\Program Files (x86)\Java\jdk1.8.0_171\jre\bin

  3. java.library.path

    实际上就是要将 DLL 文件放在java.library.path路径下,可以通过-Djava.library.path参数在 JVM 启动时指定自定义路径,不过该方法不够方便

    另外,程序启动后再修改 JVM 的该属性是无效的

    获取当前应用的java.library.path

    System.getProperty("java.library.path");

    参考:

  4. 使用的是 JNA 框架的话还可以通过设置jna.library.path,让 JNA 加载指定位置的 DLL,具体用法如下:

    //启用 JNA 加载 DLL 文件 DEBUG 日志
    System.setProperty("jna.debug_load", "true");
    //根据当前的类路径设置 JNA 查找 DLL 文件路径,
    String jnaLibPath = Main.class.getResource("").getPath();
    jnaLibPath = jnaLibPath.substring(0, jnaLibPath.indexOf("特殊路径"))
    .replaceFirst("/", "") + "dll";// 绝对路径
    System.setProperty("jna.library.path", jnaLibPath);

    相关的日志如下:

    Looking in classpath from sun.misc.Launcher$AppClassLoader@b4aac2 for /com/sun/jna/win32-x86/jnidispatch.dll
    Found library resource at jar:file:/D:/"特殊路径"/lib/jna-4.5.2.jar!/com/sun/jna/win32-x86/jnidispatch.dll
    Looking for library 'HCNetSDK'
    Adding paths from jna.library.path: "指定路径"
    Trying "指定路径"\HCNetSDK.dll
    Found library 'HCNetSDK' at D:\"路径"\HCNetSDK.dll

    以上动态的设置 jna.library.path,通过命令启动也可以设置 java -Djna.library.path=<path to your library> MainClass

回调函数的使用

  1. 在链接库文件对应的接口中,声明回调函数的接口

    回调函数的接口需要继承Callback或者是StdCallCallback
  2. 定义回调方法

    一般方法名称都是 invoke,这个好像是无所谓的,但是参数一定要跟提供的文档,或者头文件严格一致(对应类型和顺序)
  3. 具体实现

    一般是写一个具体类实现接口,然后重写对应的回调方法,有一点需要特别注意的是,应该将实现类的实例设置为成员变量,因为局部变量会被 GC,那么回调方法只会在开始的时候调用几次

输出参数

Java 中只有输入参数和一个返回值,当需要有多个返回时,一般都用集合或者封装成对象来返回。但是 C/C++ 不一样,有输入参数,输出参数,返回值

个人理解:输出参数功能跟返回值差不多,由函数外部定义,传入函数内部,一般都是指针

由于 Java 中是没有指针的,所以我们用 Pointer 类的实例来代替,下面是示例:

//内存不够会导致 JVM 崩溃,EXCEPTION_ACCESS_VIOLATION
Pointer onlineIpList = new Memory(1024 * 5);
int sum = PkV10AccessDll.INSTANCE.PKV10_OnlineList(onlineIpList);
String onLineStr = onlineIpList.getString(0);
logger.info("初始在线控制器数量:" + sum + " " + onLineStr);
//释放内存
long peer = Pointer.nativeValue(onlineIpList);
Native.free(peer);
//避免再次调用该方法
Pointer.nativeValue(onlineIpList, 0);

注意:为 Pointer 实例分配的内存是在 Native Heap 中的,GC 是管不了的,需要自己手动释放内存

数据类型的匹配

这是整个 JNA 使用过程中,比较难的部分

下面列举一些工作中遇到的一些问题:

  1. char *

    C/C++ 中有两种const char *char *,一般使用 String 应该就可以了,但有时会报错:非法内存访问。可以试一下字节数组来解决这个问题,在获取字符串的字节数组时需要注意编码问题
  2. unsigned数据处理

    Java 中的数据类型都是有符号的,所以在传递无符号整数时,可以用范围更大一点的数据类型去接收返回值
  3. 结构体
    1. 结构体中定义的所有字段都需要用public修饰

      参数的顺序必须严格参照头文件或者文档定义

      在 JNA 4.* 以后的版本中,通过getFieldOrder()方法返回的字段名列表,JNA 在使用时,会计算结构体的大小,为其分配内存。在getFieldList()方法中会通过反射来获取所有的public修饰的字段。如果获取的结果与getFieldOrder()方法返回结果不匹配则会抛出异常,详见 Structure 1000 行代码,JNA Version 为4.5.2

    2. 结构体作为输出参数指针

      实例化一个结构体对象后,通过实例的write()方法来为其分配内存。在调用使用该结构体的方法时,参数设置为实例的getPointer()返回的指针。最后通过实例的read()方法获取数据

  4. 数组
    1. 二维数组

      数组是行优先的,二维数组按总长度对应成 Java 中的一维数组,示例:
      // public int[][] a = new int[2][3]; 错误
      public int[] a = new int[2 * 3]; // 正确
    2. 结构体中定义结构体数组

      直接看示例:
      public NET_DVR_SCHEDTIME[] struAlarmTime = (NET_DVR_SCHEDTIME[]) new NET_DVR_SCHEDTIME().toArray(10);
    3. 二维的结构体数组

      结合前面说到的两种方式,示例:
      public NET_DVR_SCHEDTIME[] struAlarmTime = (NET_DVR_SCHEDTIME[]) new NET_DVR_SCHEDTIME().toArray(MAX_DAYS * MAX_TIMESEGMENT);

参考

  1. JNA 提供的数据结构映射示例
  2. JNA 4.5.2 API
  3. 海康威视和大华官网提供了 SDK ,可以参考其 JNA 或 JNI 使用示例

JNA 使用总结的更多相关文章

  1. JNA 如何 加载多个 存在依赖的 DLL 库

    JNA 的出现,极大的简化了原有的 JNI 技术.下面是JNA github地址:https://github.com/java-native-access/jna 1. 简单的一个例子: /** S ...

  2. 使用jna调用dll,jdk位数和dll位数的关系

    最近在学习jna,发现dll文件能能否成功调用取决于jdk位数. 32位jdk只能使用32位的dll,64位jdk只能使用64位的dll,否则位数不对应的话报的错是 "Exception i ...

  3. JNA开发中的问题积累

    [Qboy原创] 2013年12月28日 在开发一个项目过程中需要调用第三方的C的dll.由于是第一次在项目中使用JNA,很多都安装开发文档来做,但是出现了很多的问题. 由于很多接口还没调完,还不知道 ...

  4. JNA使用

    JNA与C对应的数据类型: 注意:        使用byte[]对应C++中的char* 可以返回函数执行的结果值 一.添加JNA需要的jar包      1.jna.jar      2.plat ...

  5. JNA参数传递问题,Java数组

    版权声明:本文为博主原创文章,未经博主允许不得转载. 本文主要讲述使用JNA模拟结构体并将结构体数组作为参数传递给对应的方法. C语言结构体定义如下: typedef struct Rect { in ...

  6. JNA结构体参数传递,Java数组

    JNA以结构体数组为参数进行调用: ////// C++ // student 结构体定义 typedef struct { int age; char name[20]; }Student; //  ...

  7. java 用JNA方法调用C++动态链接库

    JNA(Java Native Access)框架是一个开源的Java框架,是SUN公司主导开发的,建立在经典的JNI的基础之上的一个框架.非常强大.易用,功能上类似与.NET的P/Invoke.你只 ...

  8. jna 使用实例,

    有与项目组需要用到C++的一个模块, 需要将一个2维数组传到dll 里面 ,返回一个字符串, 恶心了1天终于完成了, 记录一下,同时也希望能给你带来帮助. java 代码如下, package tes ...

  9. JNA—JNI终结者

    JNA—JNI终结者 介绍 给大家介绍一个最新的访问本机代码的Java框架—JNA. JNA(Java Native Access)框架是一个开源的Java框架,是SUN公司主导开发的,建立在经典的J ...

  10. JNA入门实例

    JNA(Java Native Access):建立在JNI之上的Java开源框架,SUN主导开发,用来调用C.C++代码,尤其是底层库文件(windows中叫dll文件,linux下是so[shar ...

随机推荐

  1. asp.net core 3.x 授权中的概念

    前言 预计是通过三篇来将清楚asp.net core 3.x中的授权:1.基本概念介绍:2.asp.net core 3.x中授权的默认流程:3.扩展. 在完全没有概念的情况下无论是看官方文档还是源码 ...

  2. codewars--js--Range Extraction

    问题描述: A format for expressing an ordered list of integers is to use a comma separated list of either ...

  3. nginx 正向代理与反向代理

    一.介绍 反向代理:让Internet上的用户可以访问局域网内的资源,中间设置一个代理服务器,如下所示,红色圈是指局域网内的站点(myweb站点是我们的站点,例如iis).箭头不能反过来 正向代理:客 ...

  4. Android中使用Intent的Action和Data属性实现点击按钮跳转到拨打电话和发送短信

    场景 点击拨打电话按钮,跳转到拨打电话页面 点击发送短信按钮,跳转到发送短信页面 注: 博客: https://blog.csdn.net/badao_liumang_qizhi 关注公众号 霸道的程 ...

  5. 为NuGet配置微软官方中国镜像

    NuGet微软官方中国镜像地址: https://nuget.cdn.azure.cn/v3/index.json 打开Visual Studio => 工具 => NuGet包管理器 = ...

  6. 【已解决】pyinstaller UnicodeDecodeError: ‘utf-8’ codec can’t decode byte 0xce in position 110: invalid continuation byte

    转载自勤奋的小青蛙本文链接地址: [已解决]pyinstaller UnicodeDecodeError: ‘utf-8’ codec can’t decode byte 0xce in positi ...

  7. 802.11 MAC基础

    MAC(媒介访问控制层)位于各式物理层之上,控制数据的传输.它负责核心成帧操作以及与有线骨干网络之间的交互. 802.11采用载波监听多路访问/冲突避免(CSMA/CA)机制来控制对传输媒介的访问. ...

  8. JS 重载父页面

    <script language=javascript> window.onload=function(){ //刷新父页面 window.opener.location.reload() ...

  9. idea websorm 激活码(2020-1-6 实测可用)最新

      2019年1月6日用 ZSI6IiIsImFzc2lnbmVlRW1haWwiOiIiLCJsaWNlbnNlUmVzdHJpY3Rpb24iOiIiLCJjaGVja0NvbmN1cnJlbnR ...

  10. python爬虫1:第一个爬虫

    1.python2.3的库名不同,如果版本不同记得改. Python2.x 有这些库名可用: urllib,urllib2,urllib3,httplib,httplib2,requests Pyth ...