JNA基础之Java映射char*、int*、float*、double*

最近项目在用Java调用C写的一些三方库，没办法直接调，用Java封装一下C的接口，这就少不了要用到JNA的知识。本篇文章带你从JNA的基本概念开始，了解Java和C语言数据类型之间的映射关系，掌握如何使用JNA。

1 JNA简介

JNA全称Java Native Access，是一个建立在经典的JNI技术之上的Java开源框架（https://github.com/twall/jna）。JNA提供一组Java工具类用于在运行期动态访问系统本地库（native library：如Window的dll）而不需要编写任何Native/JNI代码。开发人员只要在一个java接口中描述目标native library的函数与结构，JNA将自动实现Java接口到native function的映射。

JNA包：
https://maven.java.net/content/repositories/releases/net/java/dev/jna/jna/4.0.0/jna-4.0.0.jar
https://maven.java.net/content/repositories/releases/net/java/dev/jna/jna-platform/4.0.0/jna-platform-4.0.0.jar
JNA在线帮助文档：http://java-native-access.github.io/jna/4.2.1/
JNA入门示例：https://github.com/twall/jna/blob/master/www/GettingStarted.md

要点 ：
1、.dll和.so是C函数的集合和容器，这与Java中的接口概念吻合，所以JNA把dll文件和so文件看成一个个接口。在JNA中定义一个接口就是相当于了定义一个DLL/SO文件的描述文件，该接口代表了动态链接库中发布的所有函数。而且，对于程序不需要的函数，可以不在接口中声明。
2、JNA定义的接口一般继承com.sun.jna.Library接口，如果dll文件中的函数是以stdcall方式输出函数，那么，该接口就应该继承com.sun.jna.win32.StdCallLibrary接口。
3、JNA难点：编程语言之间的数据类型不一致。

2 Java/Native Type Conversions

官方给出的映射关系如下：

理论上，对于枚举类型的指针，Java中可以使用Pointer传参。

3 Java数据类型和C指针类型对应关系

C类型	Java类型
char*	ByteByReference或Pointer
int*	IntByReference或Pointer
float*	FloatByReference或Pointer
double*	DoubleByReference或Pointer

建议使用对应的ByReference对象替代Pointer，使用Pointer有时可能会得到一个垃圾值（正常情况下两种方式结果一样），如果C中函数执行失败时没有对指针的值进行处理，使用Pointer就会得到一个垃圾值。下面是一个例子：

// test.h
extern "C"{
int testPointer(int a,int* b);
}
// test.cpp
int testPointer(int a, int *b){
    if (a<0){
        return -1; // 未对b进行处理
}
*b = a;
    return 0;
}

使用ByReference和Pointer两种方式调用结果：

可以看出，使用Pointer获取指针中的值时，函数返回-1获取的值是一个垃圾值，因为C函数没有对指针进行处理。而使用ByReference对象获取的值则是0(Java中int的默认值)，除非你明确知道C函数不管返回何值都对指针的值做了处理，可以使用Pointer，否则请使用ByReference引用对象，避免获取到垃圾值。

4 Pointer的具体用法

假设有如下的C函数：

int get_int_value(int a,int* b);

用于计算a*10，保存到b中输出。a为负数时函数返回-1，正数返回0。
在Java中使用JNA调用为：

int size = Native.getNativeSize(Integer.class); // 获取int类型在内存中需要的空间大小，float、double用法与此类似
System.out.println("size="+size);

// 为Pointer开辟int类型需要的内存空间（模拟C中int*）
Pointer p = new Memory(size);  
//p.setInt(0,0); // 给pointer设置值。第一个参数为在内存中的偏移量(一般为0)，第二个参数为设置的值
int res = CLibrary.INSTANCE.get_int_value(-3,p); // 调用C函数
System.out.println("res="+res);
System.out.println("result is:"+p.getInt(0)); // 获取Pointer中保存的int类型值

res = CLibrary.INSTANCE.get_int_value(6,p);
System.out.println("res="+res);
System.out.println("result is:"+p.getInt(0));

以上就是JNA中如何去模拟C的基本数据类型的指针了，Java如何模拟结构体、结构体指针及结构体中嵌套结构体数组请参考JNA实践之Java模拟C结构体、结构体指针、结构体数组一文。