JNA入门实例

JNA(Java Native Access)：建立在JNI之上的Java开源框架，SUN主导开发，用来调用C、C++代码，尤其是底层库文件（windows中叫dll文件，linux下是so【shared object】文件）。

JNI是Java调用原生函数的唯一机制，JNA就是建立在JNI之上，JNA简化了Java调用原生函数的过程。JNA提供了一个动态的C语言编写的转发器（实际上也是一个动态链接库，在Linux-i386中文件名是：libjnidispatch.so）可以自动实现Java与C之间的数据类型映射。从性能上会比JNI技术调用动态链接库要低。

 

笔者机器中libvirt相关的动态链接库：

 

lzjun@lzjun-ubuntu:/var/run/libvirt$ ll /usr/lib/libvirt
libvirt/ libvirt-qemu.so.0.9.8 libvirt.so.0.9.8
libvirt-qemu.so.0 libvirt.so.0

 

实例：（笔者环境：Ubuntu1204、JDK6、gcc）

 

一：编写动态链接库：（库文件名格式：lib*.so*）

 

1、编写头文件 #hellworld.h

void test();

2、编写实现文件 #helloworld.c

#include<stdio.h>
void test(){
printf("helloworld\n");
}

3、编译生成动态库，文件名:libhello.so

gcc -fpic -shared -o libhello.so helloworld.c

 文件libhello.so生成。（此处还有一步，请看文章结尾处的异常）， 接下来就可以编写测试文件调用该动态链接库了。

二： 编写测试文件

 

如果是用maven构建项目，非maven项目google之，把jna.jar加入classpath即可，JNA 的包依赖：

 

<dependency>
     <groupId>com.sun.jna</groupId>
     <artifactId>jna</artifactId>
     <version>3.0.9</version>
</dependency>

编写测试类：

 

import com.sun.jna.Library;
import com.sun.jna.Native;

public class JnaTest {

//继承Library，用于加载库文件
public interface Clibrary extends Library{
//加载libhello.so链接库
Clibrary INSTANTCE = (Clibrary) Native.loadLibrary("hello", Clibrary.class);

//此方法为链接库中的方法
void test();
}

public static void main(String[] args) {
//调用
Clibrary.INSTANTCE.test();
}
}

#输出“helloworld”

如果抛出如下异常：

 

Exception in thread "main" java.lang.UnsatisfiedLinkError: Unable to load library 'hello': libhello.so: cannot open shared object file: No such file or directory
at com.sun.jna.NativeLibrary.loadLibrary(NativeLibrary.java:145)
at com.sun.jna.NativeLibrary.getInstance(NativeLibrary.java:188)
at com.sun.jna.Library$Handler.<init>(Library.java:123)
at com.sun.jna.Native.loadLibrary(Native.java:255)
at com.sun.jna.Native.loadLibrary(Native.java:241)
at JnaTest$Clibrary.<clinit>(JnaTest.java:12)
at JnaTest.main(JnaTest.java:22)

  那是JVM没法找到动态链接库的路径，此时需要把动态链接库加入系统的/lib目录或修改配置文件：

# pwd >> /etc/ld.so.conf   （把动态链接库所在路径加入配置文件中，此处用pwd是因为笔者当前所在目录就是链接库文件所在目录）
# ldconfig

参考：http://blog.csdn.net/laomai/article/details/1510957