JAVA调用C/C++动态库 开发笔记

前言:

这次的项目经历让我尝了一次苦头,在最后一切顺利成功执行的时候,就决定要写下我人生的第一篇博客。
本次项目的动态库与正常动态库不同的2个情况是:一是动态库dll内部需要调用一个与dll在同级目录下的一个配置文件;二是动态库在运行过程中会向动态库dll同级目录下创建并写入一个日志文件(我这边说的同级目录可能不太准确,具体后文会提到)。


</br>

一、调用方式:

JAVA调用C/C++动态库有很多方法,常用的有JNI(Java Native Interface)、JNA(Java Native Access)。

  • JNI:早在JAVA1.1版本就开始支持,它定义了一种公用的语法,当java和c/c++双方都遵循该语法时,可以互相调用。所以使用JNI不能直接调用一般的C/C++库,而必须借助于一个中间动态库,该中间动态库实现了JAVA-JNI语法-C/C++的转换(或者你所调用的动态库原生就封装了JNI)。如果对C++稍微懂一点,其实使用起来也不难。
  • JNA:在C#中,使用[DLLImport]可以非常方便的调用原生的C/C++动态库,所以sun公司开发了JNA来使JAVA可以像C#一样方便的调用动态库。不过在使用过程中感觉内部原理还是使用了JNI的语法库。不过至少对于我们不懂C++的来说,可以直接调用原生的动态库,而不需要再去生成一个C++的中间动态库了。

所以这次在尝试了JNI之后还是选择了JNA。

</br>

二、关于x32和x64:

如果C/C++动态库使用x32,那必须运行在x32的Tomcat上,并且使用x32的JRE。所以如果不幸拿到股东动态库,未提供x64版本,那只能单独部署x32服务器提供对应的接口,而x64主站点通过http方式调用该接口程序来访问动态库。

如果在x64Tomcat上加载x32版本动态库,将得到如下错误信息:

"Can't load IA 32-bit .dll on a AMD 64-bit platform"

调用方法及DLL存放位置:

先来简单的看一下JNI和JNA两种方式加载动态库的代码:

JNI:
public class ImportDllTest {
    //加载动态库
    static{
        //通过决定地址加载动态库
        //System.load("d:\\C2JavaTest.dll");
        //通过库名加载动态库,不加.dll后缀,自适应.dll和liunx平台的.so
        System.loadLibrary("C2JavaTest");
    }
    //定义动态库接口方法
    public native String subString(String str, int startIndex, int length);

    public static void main(String[] args){
        ImportDllTest importDll = new ImportDllTest();
        String str = importDll.subString("test",1,2);
    }
}
JNA:

引用JNA包

<dependency>
    <groupId>com.sun.jna</groupId>
    <artifactId>jna</artifactId>
    <version>3.0.9</version>
</dependency>

定义接口类,继承com.sun.jna.Library

//必须继承com.sun.jna.Library
public interface ImportDllTest extends Library {

    //加载动态库,使用动态库名称加载,不带.dll后缀,会自动识别liunx环境下的.so库。也可以使用决定地址加载动态库
    public static ImportDllTest Instance = (ImportDllTest) Native.loadLibrary("C2JavaTest", ImportDllTest.class);

    //定义动态库接口方法
    String subString(String str, int startIndex, int length);

    
    public class Main{
        public static void main(String[] args){
            String str = ImportDllTest.Instance.subString("test",1,2);
        }
    }
}
关于是否加载到动态库:

两种加载动态库都可以使用动态库名称或者绝对路径来加载,在调试过程中,JNA如果没找到动态库并不会给出明确的提示,而JNI的加载方法会明确抛出找不到动态库的异常,所以即使是使用JNA方式,但在一开始不确定是否将动态库放在了正确位置,是否成功的加载了动态库的时候可以借助于JNI的Systetm.loadLibrary来协助判断是否成功的加载了对应的动态库。
</br>

三、动态库位置:

加载动态库都可以使用决定地址来加载。但本次项目加载的动态库会需要调用同级目录下的配置文件,使用绝对地址的方式我是没能成功的加载到配置文件(因为也不清楚动态库里实际加载配置文件的具体实现)。使用动态库名称加载,那动态库到底应该放在哪里,网上查了很多资料,有放system32的,有放jdk/jre的,有放tomcat里的,有放环境变量配置里的。在追求尽量不给后续运维造成太大困扰(放系统system32,或jdk/jre,部署时很容易忘记或错乱),尽可能找最优的方案。
最后我借助于动态库生成的日志文件,来判断默认加载动态库的路径:

应用程序:

Main方法测试时,动态库及配置文件需要放到运行时选择的工作目录下。


动态库和配置文件要放在:


同时生成的日志文件也将会在该目录下

Tomcat部署程序

Tomcat部署时,尝试过很多方式,但是最后选择了Tomcat的bin目录

cd Tomcat/bin

</br>

四、JAVA与C/C++参数对应

java的char是2字节,byte是1字节;c/c++的char是1字节;

作为JAVA传入C/C++参数:
JAVA C/C++
byte[] char[]/char*
String char[]/char*
int int
作为JAVA中传入,C/C++里out的参数:
C/C++ JAVA
char[]/char* byte[]

调用是要先将定义的byte数组空间定义好,c++中才可以在已经定义的空间中写值。

//out参数长度8字节内容
byte[] out_param = new byte[8];

</br>

五、总结

  • 可以借助于JIN确定动态库是否能正确加载到。如果动态库不需要配置文件,完全可以使用决定路径来进行加载。
  • 明确动态库的版本,是x32还是x64。不同版本要使用对应的tomcat和jre。
  • 确定传递参数类型,java中一定要记得不可以使用char来和c++的char交互,一定是要byte或String(为什么String可以,猜测可能JIN或JNA在内部转换成了byte)。
  • 最后如果动态库能有人员配合一起调试,那是一个美好的事情。
    </br>
    </br>

这次把成功的几个关键点调用整理在此。本次项目也是因为调用的古董动态库,没有文档,没有错误说明,所有返回都靠猜测,所以不确实是java调用问题还是本身业务问题。前前后后折腾好几周,最后总算还是有了一个好的结果。

以上有任何不对的地方,敬请指正。

</br>
</br>

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,732评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,496评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,264评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,807评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,806评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,675评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,029评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,683评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,704评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,666评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,773评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,413评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,016评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,978评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,204评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,083评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,503评论 2 343

推荐阅读更多精彩内容

  • 1. 环境准备 A. GCC 在控制台中输入 如果提示命令未找到,那么说明你的计算机中还没有gcc,去安装一个吧,...
    Chole121阅读 1,339评论 1 9
  • 小编费力收集:给你想要的面试集合 1.C++或Java中的异常处理机制的简单原理和应用。 当JAVA程序违反了JA...
    八爷君阅读 4,573评论 1 114
  • 一. Java基础部分.................................................
    wy_sure阅读 3,788评论 0 11
  • Java Native Interface (JNI)是一个本地编程接口,可以让Java代码使用以其他语言(C/C...
    wangdy12阅读 7,031评论 0 4
  • 无论是魏国的改革,还是秦国的变法,都使得各自国家的国力有了大幅度的提升,走向了霸主的地位,然而战国时期影响最广成效...
    懒虫小狮子阅读 135评论 0 0