1. 描述备注
1.1 JNA工作原理
JNA是建立在JNI技术基础之上的一个Java类库,它使您可以方便地使用java直接访问动态链接库中的函数。
原来使用JNI,你必须手工用C写一个动态链接库,在C语言中映射Java的数据类型。
JNA中,它提供了一个动态的C语言编写的转发器,可以自动实现Java和C的数据类型映射。你不再需要编写C动态链接库。
JNA把一个dll/.so文件看做是一个java接口。Dll是C函数的集合、容器,这和java接口的概念吻合。
Java Type |
C Type |
Native Representation |
boolean |
int |
32-bit integer (customizable) |
byte |
char |
8-bit integer |
char |
wchar_t |
platform-dependent |
short |
short |
16 bit integer |
int |
int |
32 bit integer |
long |
long long,_int64 |
64 bit integer |
float |
float |
32-bit floating point |
double |
double |
364-bit floating point |
Buffer Pointer |
pointer |
platform-dependent (32- or 64-bit pointer to memory) |
[] (array of primitive type) |
32- or 64-bit pointer to memory (argument/return) contiguous memory (struct member) |
|
String |
char* |
NUL-terminated array (native encoding or jna.encoding) |
WString |
wchar* |
NUL-terminated array (unicode) |
String[] |
char** |
NULL-terminated array of C strings |
WString[] |
wchar** |
NULL-terminated array of wide C strings |
Structure |
struct* struct |
pointer to struct (argument or return) (or explicitly) struct by value (member of struct) (or explicitly) |
Union |
union |
same as Structure |
Structure[] |
struct[] |
array of structs, contiguous in memory |
Callback |
(*fp)() |
function pointer (Java or native) |
NativeMapped |
varies |
depends on definition |
NativeLong |
long |
platform-dependent (32- or 64-bit integer) |
PointerType |
pointer |
same as Pointer |
<dependency>
<groupId>net.java.dev.jna</groupId>
<artifactId>jna</artifactId>
<version>4.5.0</version>
</dependency>
<dependency>
<groupId>net.java.dev.jna</groupId>
<artifactId>jna-platform</artifactId>
<version>4.5.0</version>
</dependency>
2. 示例
2.1示例1-普通调用
public class HelloWorld {
//定义一个接口,继承自Library或stdCallLibrary,默认的是继承Library ,如果动态链接库里的函数是以stdcall方式输出的,那么就继承StdCallLibrary,比如众所周知的kernel32库。
public interface CLibrary extends Library {
//接口内部需要一个公共静态常量:INSTANCE,通过这个常量,就可以获得这个接口的实例,从而使用接口的方法,也就是调用外部dll/so的函数。
//通过Native.loadLibrary() API获取,
//第一个参数是动态链接库dll/so的名称,不带后缀。搜索动态链接库路径的顺序是:当前类的目录-->工程文件夹下面找win32/win64文件夹下搜
-->WINDOWS下面去搜索,再找不到就会抛异常了。比如上例中printf函数在Windows平台下所在的dll库名称是msvcrt,而在其它平台如Linux下的so库名称是c。
//第二个参数是本接口的Class类型。JNA通过这个Class类型,根据指定的.dll/.so文件,动态创建接口的实例。该实例由JNA通过反射自动生成
CLibrary INSTANCE = (CLibrary)Native.loadLibrary((Platform.isWindows() ? "msvcrt" : "c"),CLibrary.class);
//接口中只需要定义你要用到的函数或者公共变量,不需要的可以不定义,如上例只定义printf函数, 入参和出参和dll中定义保持一致
void printf(String format, Object... args);
}
public static void main(String[] args) {
//直接调用即可
CLibrary.INSTANCE.printf("Hello, World
");
for (int i=0;i < args.length;i++) {
CLibrary.INSTANCE.printf("Argument %d: %s
", i, args[i]);
}
}
}
2.2 示例2-调用win32DLL(JNA已封装)
//获取系统时间
Kernel32 lib = Kernel32.INSTANCE;
SYSTEMTIME time = new SYSTEMTIME();
lib.GetSystemTime(time);
System.out.println("Today's integer value is " + time.wDay);
示例3-Win32API 操作进程
Kernel32 lib = Kernel32.INSTANCE;
// 获取进程快照
HANDLE hSnapshot = lib.CreateToolhelp32Snapshot(Tlhelp32.TH32CS_SNAPPROCESS, new DWORD(0));
// 获取进程
PROCESSENTRY32 pe32 = new PROCESSENTRY32();
// lib.Process32First(hSnapshot, lppe);
while (lib.Process32Next(hSnapshot, pe32)) {
DWORD processId = pe32.th32ProcessID;
char[] name = pe32.szExeFile;
System.out.println("进程id: " + processId + " ; " + "进程名称: " + new String(name));
// 打开进程
HANDLE processHandle = lib.OpenProcess(WinNT.PROCESS_ALL_ACCESS, false, pe32.th32ProcessID.intValue());
}