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

C代码  

1. void test();  

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

C代码  

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

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

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

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

二： 编写测试文件

 

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

 

Xml代码  

1. <dependency>  
2.      <groupId>com.sun.jna</groupId>  
3.      <artifactId>jna</artifactId>  
4.      <version>3.0.9</version>  
5. </dependency>  

编写测试类：

 

Java代码  

1. import com.sun.jna.Library;  
2. import com.sun.jna.Native;  
3.   
4. public class JnaTest {  
5.   
6. //继承Library，用于加载库文件  
7. public interface Clibrary extends Library{  
8. //加载libhello.so链接库  
9. Clibrary INSTANTCE = (Clibrary) Native.loadLibrary("hello", Clibrary.class);  
10.   
11. //此方法为链接库中的方法  
12. void test();  
13. }  
14.   
15. public static void main(String[] args) {  
16. //调用  
17. Clibrary.INSTANTCE.test();  
18. }  
19. }  

#输出“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