利用JNative实现Java调用动态库

http://www.oschina.net/question/12_10956

由于项目要求，需要用Java调用windows的dll文件，查了一下，如果用JNI的话是比较麻烦的，在sourceforge.net上搜索了一下 “Java dll”，首先出现的是Jnative，于是决定用它，后来也试了些别的，但还是JNative好使，简单总结如下：

Java调用动态库所需要关心的问题：

l 如何装载dll文件，以及如何定位所要使用的方法；

l 数据类型是如何对应的；

l 如何给使用的方法传递参数；

l 如何获取返回的值。

JNative INFO：

Resource URL: http://jnative.sourceforge.net/
Source Code: http://sourceforge.net/projects/jnative
Detailed Review: http://jnative.free.fr
JavaDOC： http://jnative.free.fr/docs/
Version：1.3

一个开源的组件，通过它调用已有动态库中的方法就非常的方便，支持CallBack 。

为什么选择JNative

同类的开源组件相对活跃的还有，JNA ( Java Native Access ), Jawin，Nativecall，etc.但是Jnative 相对更容易使用，它对数据类型的处理做的更好。

l JNA 需要用户对所使用的DLL文件事先进行封装，才能装载。另外需要在一个java接口中描述目标DLL中的函数与结构，从而使JNA自动实现Java接口到native function的映射，较麻烦。

l Nativecall 暂时还不知道如何装载dll文件。

l Jawin 数据类型匹配相当敏感，它采用一种叫做”instruction string”的格式来传递参数，还没有完全理解。

How to：

解压JNative-1.3.2.zip 获得三个文件，分别是：JNativeCpp.dll，libJNativeCpp.so，JNative.jar 。

JNativeCpp.dll Windows下用的，拷到windows / system32目录下；

此处的动态库需要区分64位和32位，需要和jdk版本一致，但是官方没有提供64位。我在win7 64位jdk下调用失败。

libJNativeCpp.so Linux下的咚咚；

JNative.jar 这是一个扩展包，将其copy到C:\jdk\jre\lib\ext 下（我的目录结构），系统会自动加载。

结构映射（Structure Mapping）

Type

Length

JNative class

DWORD

4

org.xvolks.jnative.misc.basicStructures.LONG

HWND

4

org.xvolks.jnative.misc.basicStructures.HWND

COLORREF

4

org.xvolks.jnative.misc.basicStructures.LONG

COLORREF*

4

org.xvolks.jnative.pointers.Pointer

LPARAM

4

org.xvolks.jnative.misc.basicStructures.LPARAM

LPCCHOOKPROC

4

org.xvolks.jnative.util.Callback

LPCTSTR

4

org.xvolks.jnative.pointers.Pointer

一些关键的类及方法

Class

作用

一般用到的方法（参数略，参考Doc）

org.xvolks.jnative.Jnative

装载dll文件，定位函数

JNative(),setParameter(),setRetVal(),getRetVal() etc.

org.xvolks.jnative.pointers.Pointer

替代本地函数中的的指针，需要先申请一块内存空间，才能创建

Pointer()，dispose()

org.xvolks.jnative.pointers.memory.MemoryBlockFactory

申请一块内存空间

createMemoryBlock()

org.xvolks.jnative.exceptions.NativeException

抛出装载，定位等方面的异常

org.xvolks.jnative.Type

列举和管理Jnative需要的不同的数据类型

(二)

简单测试，Javadoc 下和官方网上有些例子，下面的是我随便从IC读卡程序中找了个DLL进行的测试：

SCReader.dll 下的SCHelp_HexStringToBytes()函数原型

SCREADER_API WINAPI long SCHelp_HexStringToBytes(

LPCTSTR pSrc,

BYTE* pTar,

int MaxCount

);

注意：dll文件需要放到System32下，否则可能找不到

通过Jnative 用java 来调用代码如下：

package onlyfun.dllcall;

import org.xvolks.jnative.JNative;

import org.xvolks.jnative.exceptions.NativeException;

import org.xvolks.jnative.pointers.Pointer;

import org.xvolks.jnative.pointers.memory.MemoryBlockFactory;

import org.xvolks.jnative.Type;

public class UserCall {

/**

* return 转换成功的字节数

*/

static JNative Something = null;

static Pointer pointer;

public String getSomething(String pSrc, Pointer pTar, int MaxCount) throws NativeException, IllegalAccessException{

try{

if(Something == null){

pTar = new Pointer(MemoryBlockFactory.createMemoryBlock(36));

Something = new JNative("SCReader.DLL", "SCHelp_HexStringToBytes");

// 利用org.xvolks.jnative.JNative 来装载 SCReader.dll，并利用其SCHelp_HexStringToBytes方法

Something.setRetVal(Type.INT);

// 指定返回参数的类型

}

int i=0;

Something.setParameter(i++,pSrc);

Something.setParameter(i++,pTar);

Something.setParameter(i++,MaxCount);

System.out.println("调用的DLL文件名为："+Something.getDLLName());

System.out.println("调用的方法名为："+Something.getFunctionName());

//传值

Something.invoke();//调用方法

return Something.getRetVal();

}finally{

if(Something!=null){

Something.dispose();//释放

}

}

}

public Pointer creatPointer() throws NativeException{

pointer = new Pointer(MemoryBlockFactory.createMemoryBlock(36));

pointer.setIntAt(0, 36);

return pointer;

}

public static void main(String[] args) throws NativeException, IllegalAccessException {

UserCall uc = new UserCall();

String result = uc.getSomething("0FFFFF", uc.creatPointer(), 100);

System.err.println("转换成功的字节数为："+result);

TestCallback.runIt();

}

}