JNA 使用总结
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
来查看
IDEA 设置
- 直接放在
src
路径下面 - 放在指定路径,然后在
Modules
的Dependencies
中添加JARs or directories
选中该文件夹路径
- 直接放在
JDK bin 目录下 JRE 的 bin 路径
这里要注意的是路径为 JDK 目录下的 JRE,如C:\Program Files (x86)\Java\jdk1.8.0_171\jre\bin
java.library.path
实际上就是要将 DLL 文件放在java.library.path
路径下,可以通过-Djava.library.path
参数在 JVM 启动时指定自定义路径,不过该方法不够方便
另外,程序启动后再修改 JVM 的该属性是无效的
获取当前应用的java.library.path
:System.getProperty("java.library.path");
参考:
使用的是 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
回调函数的使用
- 在链接库文件对应的接口中,声明回调函数的接口
回调函数的接口需要继承Callback
或者是StdCallCallback
- 定义回调方法
一般方法名称都是invoke
,这个好像是无所谓的,但是参数一定要跟提供的文档,或者头文件严格一致(对应类型和顺序) - 具体实现
一般是写一个具体类实现接口,然后重写对应的回调方法,有一点需要特别注意的是,应该将实现类的实例设置为成员变量,因为局部变量会被 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 使用过程中,比较难的部分
下面列举一些工作中遇到的一些问题:
char *
C/C++ 中有两种const char *
和char *
,一般使用 String 应该就可以了,但有时会报错:非法内存访问。可以试一下字节数组来解决这个问题,在获取字符串的字节数组时需要注意编码问题unsigned
数据处理
Java 中的数据类型都是有符号的,所以在传递无符号整数时,可以用范围更大一点的数据类型去接收返回值- 结构体
结构体中定义的所有字段都需要用
public
修饰
参数的顺序必须严格参照头文件或者文档定义在 JNA 4.* 以后的版本中,通过
getFieldOrder()
方法返回的字段名列表,JNA 在使用时,会计算结构体的大小,为其分配内存。在getFieldList()
方法中会通过反射来获取所有的public
修饰的字段。如果获取的结果与getFieldOrder()
方法返回结果不匹配则会抛出异常,详见 Structure 1000 行代码,JNA Version 为4.5.2
结构体作为输出参数指针
实例化一个结构体对象后,通过实例的write()
方法来为其分配内存。在调用使用该结构体的方法时,参数设置为实例的getPointer()
返回的指针。最后通过实例的read()
方法获取数据
- 数组
- 二维数组
数组是行优先的,二维数组按总长度对应成 Java 中的一维数组,示例:// public int[][] a = new int[2][3]; 错误
public int[] a = new int[2 * 3]; // 正确
- 结构体中定义结构体数组
直接看示例:public NET_DVR_SCHEDTIME[] struAlarmTime = (NET_DVR_SCHEDTIME[]) new NET_DVR_SCHEDTIME().toArray(10);
- 二维的结构体数组
结合前面说到的两种方式,示例:public NET_DVR_SCHEDTIME[] struAlarmTime = (NET_DVR_SCHEDTIME[]) new NET_DVR_SCHEDTIME().toArray(MAX_DAYS * MAX_TIMESEGMENT);
- 二维数组
参考
- JNA 提供的数据结构映射示例
- JNA 4.5.2 API
- 海康威视和大华官网提供了 SDK ,可以参考其 JNA 或 JNI 使用示例
JNA 使用总结的更多相关文章
- JNA 如何 加载多个 存在依赖的 DLL 库
JNA 的出现,极大的简化了原有的 JNI 技术.下面是JNA github地址:https://github.com/java-native-access/jna 1. 简单的一个例子: /** S ...
- 使用jna调用dll,jdk位数和dll位数的关系
最近在学习jna,发现dll文件能能否成功调用取决于jdk位数. 32位jdk只能使用32位的dll,64位jdk只能使用64位的dll,否则位数不对应的话报的错是 "Exception i ...
- JNA开发中的问题积累
[Qboy原创] 2013年12月28日 在开发一个项目过程中需要调用第三方的C的dll.由于是第一次在项目中使用JNA,很多都安装开发文档来做,但是出现了很多的问题. 由于很多接口还没调完,还不知道 ...
- JNA使用
JNA与C对应的数据类型: 注意: 使用byte[]对应C++中的char* 可以返回函数执行的结果值 一.添加JNA需要的jar包 1.jna.jar 2.plat ...
- JNA参数传递问题,Java数组
版权声明:本文为博主原创文章,未经博主允许不得转载. 本文主要讲述使用JNA模拟结构体并将结构体数组作为参数传递给对应的方法. C语言结构体定义如下: typedef struct Rect { in ...
- JNA结构体参数传递,Java数组
JNA以结构体数组为参数进行调用: ////// C++ // student 结构体定义 typedef struct { int age; char name[20]; }Student; // ...
- java 用JNA方法调用C++动态链接库
JNA(Java Native Access)框架是一个开源的Java框架,是SUN公司主导开发的,建立在经典的JNI的基础之上的一个框架.非常强大.易用,功能上类似与.NET的P/Invoke.你只 ...
- jna 使用实例,
有与项目组需要用到C++的一个模块, 需要将一个2维数组传到dll 里面 ,返回一个字符串, 恶心了1天终于完成了, 记录一下,同时也希望能给你带来帮助. java 代码如下, package tes ...
- JNA—JNI终结者
JNA—JNI终结者 介绍 给大家介绍一个最新的访问本机代码的Java框架—JNA. JNA(Java Native Access)框架是一个开源的Java框架,是SUN公司主导开发的,建立在经典的J ...
- JNA入门实例
JNA(Java Native Access):建立在JNI之上的Java开源框架,SUN主导开发,用来调用C.C++代码,尤其是底层库文件(windows中叫dll文件,linux下是so[shar ...
随机推荐
- asp.net core 3.x 授权中的概念
前言 预计是通过三篇来将清楚asp.net core 3.x中的授权:1.基本概念介绍:2.asp.net core 3.x中授权的默认流程:3.扩展. 在完全没有概念的情况下无论是看官方文档还是源码 ...
- codewars--js--Range Extraction
问题描述: A format for expressing an ordered list of integers is to use a comma separated list of either ...
- nginx 正向代理与反向代理
一.介绍 反向代理:让Internet上的用户可以访问局域网内的资源,中间设置一个代理服务器,如下所示,红色圈是指局域网内的站点(myweb站点是我们的站点,例如iis).箭头不能反过来 正向代理:客 ...
- Android中使用Intent的Action和Data属性实现点击按钮跳转到拨打电话和发送短信
场景 点击拨打电话按钮,跳转到拨打电话页面 点击发送短信按钮,跳转到发送短信页面 注: 博客: https://blog.csdn.net/badao_liumang_qizhi 关注公众号 霸道的程 ...
- 为NuGet配置微软官方中国镜像
NuGet微软官方中国镜像地址: https://nuget.cdn.azure.cn/v3/index.json 打开Visual Studio => 工具 => NuGet包管理器 = ...
- 【已解决】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 ...
- 802.11 MAC基础
MAC(媒介访问控制层)位于各式物理层之上,控制数据的传输.它负责核心成帧操作以及与有线骨干网络之间的交互. 802.11采用载波监听多路访问/冲突避免(CSMA/CA)机制来控制对传输媒介的访问. ...
- JS 重载父页面
<script language=javascript> window.onload=function(){ //刷新父页面 window.opener.location.reload() ...
- idea websorm 激活码(2020-1-6 实测可用)最新
2019年1月6日用 ZSI6IiIsImFzc2lnbmVlRW1haWwiOiIiLCJsaWNlbnNlUmVzdHJpY3Rpb24iOiIiLCJjaGVja0NvbmN1cnJlbnR ...
- python爬虫1:第一个爬虫
1.python2.3的库名不同,如果版本不同记得改. Python2.x 有这些库名可用: urllib,urllib2,urllib3,httplib,httplib2,requests Pyth ...