Jna简介
Jna全称Java Native Access,是一个建立在 经典的JNI技术之上的Java开源框架。Jna提供工具用于调用c/c++动态库(window的DLL,Linux的so)而不需要编写任何 native/JNI代码。开发人员只要在一个Java接口中描述函数库的函数与结构,Java将自动实现Java接口方法到函数的映射。
C++DLL编写过程
打开VS工程,选择具有导出的动态链接库
项目会自动生成示例代码,只需关注DllExportTest.h和DllExportTest.cpp文件就可以了。示例代码如下:
根据生成的代码仿写导出代码,这里定义一个导出函数,并且在导出类里定义一个函数,后面将调用导出函数和导出类。
DllExportTest.h文件代码
// 下列 ifdef 块是创建使从 DLL 导出更简单的
// 宏的标准方法。此 DLL 中的所有文件都是用命令行上定义的 DLLEXPORTTEST_EXPORTS
// 符号编译的。在使用此 DLL 的
// 任何项目上不应定义此符号。这样,源文件中包含此文件的任何其他项目都会将
// DLLEXPORTTEST_API 函数视为是从 DLL 导入的,而此 DLL 则将用此宏定义的
// 符号视为是被导出的。
#ifdef DLLEXPORTTEST_EXPORTS
#define DLLEXPORTTEST_API __declspec(dllexport)
#else
#define DLLEXPORTTEST_API __declspec(dllimport)
#endif
// 此类是从 dll 导出的
class DLLEXPORTTEST_API CDllExportTest {
public:
CDllExportTest(void);
// TODO: 在此处添加方法。
public:
int add(int a, int b);
};
extern DLLEXPORTTEST_API int nDllExportTest;
DLLEXPORTTEST_API int fnDllExportTest(void);
//自定义导出函数
extern "C" DLLEXPORTTEST_API int add(int a, int b);
//导出类实例方法
extern "C" DLLEXPORTTEST_API CDllExportTest *CDllExportTest_Class()
{
return new CDllExportTest();
}
//导出类回收方法
extern "C" DLLEXPORTTEST_API void *CDllExportTest_FreeClass(CDllExportTest *self)
{
if (self != nullptr)
{
delete self;
self = nullptr;
}
return NULL;
}
//导出类内部方法
extern "C" DLLEXPORTTEST_API int CDllExportTest_Add(CDllExportTest *self, int a, int b)
{
return self->add(a, b);
}
DllExportTest.cpp文件代码
// DllExportTest.cpp : 定义 DLL 的导出函数。
//
#include "pch.h"
#include "framework.h"
#include "DllExportTest.h"
// 这是导出变量的一个示例
DLLEXPORTTEST_API int nDllExportTest=0;
// 这是导出函数的一个示例。
DLLEXPORTTEST_API int fnDllExportTest(void)
{
return 0;
}
// 这是已导出类的构造函数。
CDllExportTest::CDllExportTest()
{
return;
}
DLLEXPORTTEST_API int add(int a, int b)
{
return a + b;
}
int CDllExportTest::add(int a, int b)
{
return a + b;
}
编译生成DLL文件,至此c++导出文件制作完成。
java调用代码实现
引入依赖
net.java.dev.jna
jna
5.7.0
调用自定义导出函数
在java中定义导出类
public interface CExportFunction extends Library {
CExportFunction dll = Native.load("F:\\CDev\\DllExportTest\\x64\\Debug\\DLLEXPORTTEST.dll",CExportFunction.class);
int add(int a,int b);
}
调用代码
int add = CExportFunction.dll.add(1, 2);
System.out.println(add);
结果:
调用自定义导出类
在java中定义导出类
public class CExportClass {
public interface CLibrary extends Library {
CLibrary INSTANCE = (CLibrary) Native.synchronizedLibrary(
(CLibrary) Native.loadLibrary("F:\\CDev\\DllExportTest\\x64\\Debug\\DLLEXPORTTEST.dll", CLibrary.class));
//this
Pointer CDllExportTest_Class();
void CDllExportTest_FreeClass(Pointer self);
int CDllExportTest_Add(Pointer self, int a, int b);
}
private Pointer self;
public CExportClass() {
self = CLibrary.INSTANCE.CDllExportTest_Class();
}
public void CExportClass_FreeClass() {
CLibrary.INSTANCE.CDllExportTest_FreeClass(self);
}
public int CExportClass_add(int a, int b) {
return CLibrary.INSTANCE.CDllExportTest_Add(self, a, b);
}
}
调用代码
//实例
CExportClass cExportClass = new CExportClass();
//调用
System.out.println(cExportClass.CExportClass_add(5,5));
//清理
cExportClass.CExportClass_FreeClass();
调用结果
说明
- 明确动态库的版本,是x32还是x64。即动态库版本要和JDK版本位数相同。
- 确定传递参数类型,java中一定要记得不可以使用char来和c++的char交互,一定是要byte或String(为什么String可以,猜测可能JIN或JNA在内部转换成了byte)。
- Jna与c++数据类型对照
java类型 | c++类型 | 原生表现 |
boolean | int | 32位整数 |
byte | char | 8位整数 |
char | wchar_t | 平台依赖 |
short | short | 16位整数 |
int | int | 32位整数 |
long | long long,__int64 | 64位整数 |
float | float | 32位浮点数 |
double | double | 64位浮点数 |
Buffer/Pointer | pointer | 平台依赖(32或64位指针) |
pointer/array | 32位或64位指针(参数、返回值)邻接内存(结构体成员) | |
String | char* | \0结束的数组(native encoding or jna.encoding) |
WString | wchar_t* | \0结束的数组(Unicode) |
String[] | char** | \0结束的数组的数组 |
WString[] | wchar_t** | \0结束的宽字符数组的数组 |
Structure | struct*/struct | 指向结构体的指针(参数或返回值)(或者明确指定是结构体指针)、结构体(结构体的成员)(或明确指定是结构体) |
Union | union | 等同于结构体 |
Structure[] | struct[] | 结构体的数组,邻接内存 |
Callback | (*fp)() | Java函数指针或原生函数指针 |
NativeLong | long | 平台依赖(32或64位整数) |
每天一个小知识,每天进步一点点!!!