使用JNA库调用dll/so 动态库

简介：

JNA全称：Java Native Access，是一款在JNI层做了封装，为了简捷方便让开发者调用动态库的开源库。

流程：

• 首先去JNA在GitHub中的主页下载最新的jna核心 jar包何platform jar包，目前最新的是版本是jna-5.2.0、jna platform-5.2.0
• 写一个interface TestDll 继承 jna包里面的 Library / StdCallLibrary 接口,代码如下：

public interface TestDll extends Library{
   // 声明一个实例，加载动态库并持有库的引用
   String dllPath = "msvcrt";  //动态库的路径，如 window是系统自带的msvcrt.dll【可不需要带动态库后缀，JNA库会自动识别动态库的类型】
   TestDll INSTANCE = Native.load(dllPath, TestDll.class);

  // 声明一个方法，来映射native方法，通过调用该方法实现调用native 方法，
 // 示例 msvcrt.dll中定义的一个void printf(String format, Object... objects)方法：
  void printf(String format, Object... objects)；
}

• 然后在Java代码中调用printf()方法

public class Test{
    public static void main(String[] args){
        // 方式1：调用native printf()方法
        TestDll.INSTANCE.printf("Hello World");
        
       // 方式2：调用native printf()方法
      TestDll testDll = Native.load("msvcrt.dll", TestDll.class);
      testDll.printf("Hello World");
  }
}

入坑点：

1. 关于JNA调用32位和64位动态链接库，即*.dll

   
   
   

   影响JNA加载动态库成功的因素

2. 查找动态链接库路径的顺序：

• 先从当前类的当前文件夹找，
• 如果没有找到，再在当前工程目录中查找，找到后搜索对应的dll文件，-
• 如果找不到，再到C盘 Windows目录下面去查找(主要在System32、SysWOW64目录中查找)
• 再找不到就会抛异常

3. Windows 64bit操作系统，System32文件夹下的dll是64位版本的，而SysWOW64文件夹下的dll其实是32位版本的
   注：SysWOW64 全称：32bit Windows On 64bit Windows（64位Windows上的32位Windows）

4. 有的c / c++语言定义的函数的参数用到了struct(结构体)，例如kernel32.dll库里面的 void GetLocalTime()函数：

typedef struct {
WORD wYear; 
WORD wMonth; 
WORD wDayOfWeek; 
WORD wDay; 
WORD wHour; 
WORD wMinute; 
WORD wSecond; 
WORD wMilliseconds; 
} SYSTEMTIME, *LPSYSTEMTIME;
VOID GetLocalTime(LPSYSTEMTIME lpst);

在Java中需要定义一个类继承 jna包里面的Structure类，作为Java中的结构体，代码如下：

public static class SystemTime extends Structure {
        public short wYear;
        public short wMonth;
        public short wDayOfWeek;
        public short wDay;
        public short wHour;
        public short wMinute;
        public short wSecond;
        public short wMilliseconds;
        
        /*【关键坑点】：这里必须重写getFieldOrder()方法，明确结构体中涉及字段的名称和声明次序，
          为了确保执行native方法，能正确的赋值内容给各字段
          如果不这样重写，会报jna的一个异常
       */
        @Override
        protected List getFieldOrder() {
            // TODO Auto-generated method stub
            System.out.println("重写getFieldOrder()方法");
            return Arrays.asList("wYear","wMonth","wDayOfWeek","wDay","wHour","wMinute","wSecond","wMilliseconds");
          } 
       }


        @Override
        protected List getFieldList() {
            return super.getFieldList();
        }

    // 结构体作为函数参数时，以引用（即指针）形式传递参数
    public static class ByReference extends CommData implements Structure.ByReference { }

    // 结构体作为函数参数时，以值传递形式传递参数
    public static class ByValue extends CommData implements Structure.ByValue{}

    // 声明要调用native方法的一个方法接口
    void GetLocalTime(SystemTime result);
}