背景
由于之前一直没有接触过用Java调用C++,目前正在考虑用C++写主要的算法,然后用Java来调用。通过查找资料,发现要嘛用通信的方式,要嘛就使用JNI,也就是Java Native Interface的简称,中文是“Java本地调用”。通常在Java程序中的函数可以调用Native语言写的函数,Native一般指的是C/C++编写的函数。
Native程序中的函数可以调用Java层的函数,也就是说在C/C++程序中可以调用Java的函数。使用JNI的目的是为了屏蔽不同操作系统平台的差异性,通过Java语言来调用Native语言的功能模块。
本次博主将通过详细截图的形式来演示如何使用Java调用C++dll。按照截图完成,保证可以用。
附上相关的两个项目源码
http://download.csdn.net/detail/buptzhengchaojie/9553327
http://download.csdn.net/detail/buptzhengchaojie/9553328
一、新建Java工程,在Java类中声明一个native的方法
新建Java项目
在新建的项目中创建packet(包),并且在包下创建一个Class(类)。
接下来,在该类中添加如下代码:
public class JavaInvodeCPlus {
//声明为native,表明是有外部来实现的
public native String returnHelloWorldToUpcase(String string);
public native void sayHelloWolrd();
}
二、使用Javah命令生成native方法的声明的C/C++头文件
进入该项目所在的位置,博主这里的位置是D:\00Coding\my-space\JavaInvokeCPlus
接着进入bin目录下,找到该packet下存在一个.class文件
我们需要用javah命令来生成头文件。回到bin目录下,因为这里涉及到包名,所以必须在包目录下来。按住shift键,同时在文件夹内空白处右击,可以进入命令行。当然,你也可以一步步进入到该路径下。
这里需要注意的是,文件的末尾不加上.class后缀。然后我们可以看到在bin目录下多了一个.h头文件。
打开我们可以看到如下代码:
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_cjzheng_service_JavaInvodeCPlus */
#ifndef _Included_com_cjzheng_service_JavaInvodeCPlus
#define _Included_com_cjzheng_service_JavaInvodeCPlus
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: com_cjzheng_service_JavaInvodeCPlus
* Method: returnHelloWorldToUpcase
* Signature: (Ljava/lang/String;)Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_com_cjzheng_service_JavaInvodeCPlus_returnHelloWorldToUpcase
(JNIEnv *, jobject, jstring);
/*
* Class: com_cjzheng_service_JavaInvodeCPlus
* Method: sayHelloWolrd
* Signature: ()V
*/
JNIEXPORT void JNICALL Java_com_cjzheng_service_JavaInvodeCPlus_sayHelloWolrd
(JNIEnv *, jobject);
#ifdef __cplusplus
}
#endif
#endif
这就是头文件的内容,现在我们来分析一下这个头文件的结果。有图有真相:
三、引入生成的C++头文件来编写C++源文件
博主这里使用的VS2015,就是喜欢用新的软件。任性也是一种罪过…
新建项目
点击确定后,点击下一步,进入如下界面
点击完成,进入。
接着我们需要引入的头文件有三个,一个是刚刚使用javah生成的头文件,剩下两个需要在JDK中拷贝,博主这里使用的是JDK7的,现在将这三个头文件拷贝到C++工程的目录下。jdk的头文件在jdk的安装目录下,这两个文件的目录如下:
得到C++项目的文件如下:
然后将这三个头文件导入vs2015中
此时我们看到,貌似报错了呀!别着急,想必学过C++的人都知道这是系统库和自定义库的区别。这里将<>改成“”就可以啦!
接着我们需要做的就是实现这两个需要实现的方法,新建一个cpp文件
引入我们生成的.h文件,然后实现它。
附上代码:
#include<iostream>
#include"com_cjzheng_service_JavaInvodeCPlus.h"
#include <string>
#include <cctype>
#include <algorithm>
using namespace std;
/*
* Class: com_cjzheng_service_JavaInvodeCPlus
* Method: returnHelloWorldToUpcase
* Signature: (Ljava/lang/String;)Ljava/lang/String;
*/
JNIEXPORT jstring JNICALL Java_com_cjzheng_service_JavaInvodeCPlus_returnHelloWorldToUpcase
(JNIEnv *, jobject, jstring str) {
return str;
}
/*
* Class: com_cjzheng_service_JavaInvodeCPlus
* Method: sayHelloWolrd
* Signature: ()V
*/
JNIEXPORT void JNICALL Java_com_cjzheng_service_JavaInvodeCPlus_sayHelloWolrd
(JNIEnv *, jobject) {
cout << "Hello World" << endl;
}
报这个提示,不要惊慌,关闭就行。只要底下编译成功就可以了。
到该项目的路径下,我们可以找到生成了一个dll文件
四、将DLL文件加入到PATH环境变量下
这里有两种方法,一种是在环境变量中path里追加上这个dll所在的路径;一种是将这个dll文件拷贝到已经存在于path中的路径下。博主这里采用后者,因为博主的jdk配置了环境变量。所以直接将该dll拷贝到jdk的bin目录下。
所以我这里就将这个dll拷贝到jdk8的路径下,读者不要混淆,虽然博主这里采用jdk7,但是那是eclipse指定的项目jdk环境,是可以指定的,不要和环境变量这个混淆。
好了,离成功不远了!但是越是到快成功的时候,越要耐住性子。
五、Java类中加载DLL,然后调用声明方法
回到Java项目中,写一个测试类,调用该dll,执行相应方法,就可以啦!
附上代码:
public class TestMain {
/**
* @Title: TestMain
* @Description: TODO
* @param args
* void
* @Date: 2016年6月18日
* @author:zhengchaojie
*/
public static void main(String[] args) {
System.loadLibrary("CplusImplement");// 不需要加入.dll后缀
JavaInvodeCPlus javaInvodeCPlus = new JavaInvodeCPlus();
System.out.println(javaInvodeCPlus.returnHelloWorldToUpcase("QQQQQQQ"));
}
}
很幸运,成功了,而且不带有任何麻烦。bingo!!!
六、常见失败
1、找不到指定的dll文件:
Exception in thread "main" java.lang.UnsatisfiedLinkError: no CplusImplement in java.library.path
at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1886)
at java.lang.Runtime.loadLibrary0(Runtime.java:849)
at java.lang.System.loadLibrary(System.java:1088)
at com.cjzheng.service.TestMain.main(TestMain.java:20)
解决方案:确认该dll文件名是否正确,是否在环境变量中添加了可以找到该dll的变量。
2、方法名不对,或者参数个数不对,或者参数形式不对(这里是博主另外一个项目的错误)
Exception in thread "main" java.lang.UnsatisfiedLinkError: com.cjzheng.util.CPlusMethod.SAASChooseAntenna(DDDDDDDDDD)I
3、由于A机子上不同C++编译器生成的dll,在B机器上缺少相应的dll文件导致错误;
Exception in thread "main" java.lang.UnsatisfiedLinkError: D:\Program Files\Java\jdk1.8.0_60\bin\CPlusMethod.dll: Can‘t find dependent libraries
at java.lang.ClassLoader$NativeLibrary.load(Native Method)
at java.lang.ClassLoader.loadLibrary1(ClassLoader.java:1965)
at java.lang.ClassLoader.loadLibrary0(ClassLoader.java:1890)
at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1880)
at java.lang.Runtime.loadLibrary0(Runtime.java:849)
at java.lang.System.loadLibrary(System.java:1088)
at com.cjzheng.util.CPlusMethod.<clinit>(CPlusMethod.java:12)
at com.cjzheng.service.impl.TestMain.main(TestMain.java:21)
这里介绍一种比较简便的方法来解决这个问题。
例如如果A机器是VS2010,该DLL是使用VS2010编译,在本机上测试通过,但换了一个机子,就报上面的错误。如果报这个错误,首先可以肯定的是,库得路径都是对的。这时候,如果你去安装VS2010,问题肯定就解决了,但是VS2012装起来太麻烦了。所以这里的解决方法是在A机器上使用VS2010编译C++的DLL时,去掉/MD选项。具体步骤:
这样就可以做到,在B机器上不安装VS2010就可以使用dll啦!