Atitit.java jna 调用c++ dll 的总结

1. JNA技术解密

1.1. JNA工作原理

JNA是建立在JNI技术基础之上的一个Java类库，它使您可以方便地使用java直接访问动态链接库中的函数。

原来使用JNI，你必须手工用C写一个动态链接库，在C语言中映射Java的数据类型。

JNA中，它提供了一个动态的C语言编写的转发器，可以自动实现Java和C的数据类型映射。你不再需要编写C动态链接库。

当然，这也意味着，使用JNA技术比使用JNI技术调用动态链接库会有些微的性能损失。可能速度会降低几倍。但影响不大。

2. JNA技术难点 Java—C和操作系统数据类型的对应表

2.1.

作者:: 绰号:老哇的爪子（全名：：Attilax akbar al rapanui 阿提拉克斯阿克巴阿尔拉帕努伊）汉字名：艾龙， EMAIL:1466519819@qq.com

1，当前路径是在项目下，而不是bin输出目录下。

2，数据结构的对应关系：

2.1.1.1. Java—C和操作系统数据类型的对应表

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	64-bit floating point
Buffer Pointer	pointer	platform-dependent (32- or 64-bit pointer to memory)
<T>[] (array of primitive type)	pointer array	32- or 64-bit pointer to memory (argument/return) contiguous memory (struct member)
除了上面的类型，JNA还支持常见的数据类型的映射。
String	char*	NUL-terminated array (native encoding or jna.encoding)
WString	wchar_t*	NUL-terminated array (unicode)
String[]	char**	NULL-terminated array of C strings
WString[]	wchar_t**	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	<T> (*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

2.2. JNA编程过程

JNA把一个dll/.so文件看做是一个Java接口。

Dll是C函数的集合、容器，这正和接口的概念吻合。

我们定义这样一个接口，

public interface TestDll1 extends Library {

/**

* 当前路径是在项目下，而不是bin输出目录下。

TestDll1 INSTANCE = (TestDll1)Native.loadLibrary("TestDll1", TestDll1.class);

public void say(WString value);

}

如果dll是以stdcall方式输出函数，那么就继承StdCallLibrary。否则就继承默认的Library接口。

接口内部需要一个公共静态常量：instance。

TestDll1 INSTANCE = (TestDll1)Native.loadLibrary("TestDll1", TestDll1.class);

通过这个常量，就可以获得这个接口的实例，从而使用接口的方法。也就是调用外部dll的函数！

注意：

1，Native.loadLibrary()函数有2个参数：

1，dll或者.so文件的名字，但不带后缀名。这符合JNI的规范，因为带了后缀名就不可以跨操作系统平台了。

搜索dll的路径是：

1）项目的根路径

2）操作系统的全局路径、

3）path指定的路径。

2，第二个参数是本接口的Class类型。

JNA通过这个Class类型，根据指定的dll/.so文件，动态创建接口的实例。

2，接口中你只需要定义你需要的函数或者公共变量，不需要的可以不定义。

public void say(WString value);

参数和返回值的类型，应该和dll中的C函数的类型一致。

这是JNA，甚至所有跨平台调用的难点。

这里，C语言的函数参数是：wchar_t*。

JNA中对应的Java类型是WStirng。

2.2.1. 跨平台、跨语言调用的第一原则：就是尽量使用基本、简单的数据类型，尽量少跨语言、平台传递数据！

只有你才能拯救你自己。

如果在你的程序中，有复杂的数据类型和庞大的跨平台数据传递。那么你必须另外写一些Façade接口，把需要传递的数据类型简化，把需要传递的数据量简化。

否则，不论是实现的难度还是程序的性能都很难提高。

3. 参考

paip.java 调用c++ dll so总结 - attilax的专栏 - 博客频道 - CSDN.NET.htm

参考
Java调用.dll文件 - 抹去浮华,沉淀深度 - ITeye技术网站.htm (jnative)
学习JNA，Jnative个人总结 - 80后的梦想 - ITeye技术网站.htm
(impt)Java JNA 详解 - 梦想是奢侈品，向奢侈品进军 - 博客频道 - CSDN.NET.htm
本文原名《使用JNA方便地调用原生函数》发表于2009年3月的“程序员”杂志上。
[-]

    介绍
    实现原理
        调用原生函数
            使用JNA调用原生函数
            调用原生函数的模式
    和原生代码的类型映射
        和操作系统数据类型的对应表
        支持常见的数据类型的映射
    模拟结构体
        使用JNA调用使用Struct的C函数
            说明
        模拟复杂结构体
            结构体内部可以包含结构体对象的数组
            结构体内部可以包含结构体对象的指针的数组
    代码
        通过回调函数实现原生代码调用Java代码
        回调函数说明
    模拟指针
        使用PointerByReference模拟指向指针的指针
        模拟指针
        类详解

秒客网