Windows 下 JNI 调用动态链接库 dll

1. Java调用本地代码常见的两种方案

• JNI

JNI（Java Native Interface），有过不同语言间通信开发经历的一般都知道，它允许java和其他语言代码（尤其是C/C++）进行交互，只要遵守约定即可。首先看下JNI调用C/C++过程，注意写程序时自下而上，调用时自上而下：

可见步骤之多，调用.dll/.so共享库之痛苦的过程。

若已有编译好的.dll/.so文件 —> 需先用是C语言另外写一个.dll/.so共享库，使用SUN规定的数据结构代替C语言的数据结构，调用已有的dll/so中公布的函数 —> java中载入这个库 —> java编写Native函数作为链接库中函数的代理

问题是很少有java程序员愿意编写调用.dll/.so库中原生函数的java程序，这也使java在客户端上乏善可言，是JNI的一大弱点！

• JNA

JNA提供一组Java工具类用于在运行期间动态访问系统本地库（native library：如Window的dll）而不需要编写任何Native/JNI代码。开发人员只要在一个java接口中描述目标native library的函数与结构，JNA将自动实现Java接口到native function的映射。

简而言之，就是jna基于jni的方式封装了很多api，在使用上面相对于jni来说简化了很多。

但是JNA不能完全替代JNI，JNI不仅可以实现java访问C，也可实现C调用java。

而JNA只能实现Java访问C函数，作为一个Java框架，自然不能实现C语言调用Java代码。此时，有些情况还是需要使用JNI技术。

2. 安装VS2022

• 下载 VS2022

下载 VS2022 时，现在社区版即可。

https://visualstudio.microsoft.com/zh-hans/vs/

下载下来是一个在线安装的安装器VisualStudioSetup.exe，双击运行即可。安装选择 使用C++的桌面开发 即可：

3. 创建java项目

编写本地方法

public class JniDemo {

  // 声明本地方法
    public native int add(int a, int b);
    
    public native int sub(int a, int b);
    
}

使用javah生成c/c++头文件

javah com.jnidemo.JniDemo

生成的头文件com_jnidemo_JniDemo.h

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_jnidemo_JniDemo */

#ifndef _Included_com_jnidemo_JniDemo
#define _Included_com_jnidemo_JniDemo
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_jnidemo_JniDemo
 * Method:    add
 * Signature: (II)I
 */
JNIEXPORT jint JNICALL Java_com_jnidemo_JniDemo_add
  (JNIEnv *, jobject, jint, jint);

/*
 * Class:     com_jnidemo_JniDemo
 * Method:    sub
 * Signature: (II)I
 */
JNIEXPORT jint JNICALL Java_com_jnidemo_JniDemo_sub
  (JNIEnv *, jobject, jint, jint);

/*
 * Class:     com_jnidemo_JniDemo
 * Method:    acl
 * Signature: ()D
 */
JNIEXPORT jdouble JNICALL Java_com_jnidemo_JniDemo_acl
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

4. 创建c/c++项目

打开VS2022，创建动态链接库dll项目

输入项目名和存储的目录，点击创建即可

把头文件com_jnidemo_JniDemo.h拷贝到JniTestDemo项目中，并附加到项目里

创建com_jnidemo_JniDemo.cpp源文件，并实现头文件的两个定义的方法

#include "pch.h"
#include <jni.h>
#include "com_jnidemo_JniDemo.h"

/*
* Class:     com_jnidemo_JniDemo
* Method : add
* Signature : (II)I
*/
JNIEXPORT jint JNICALL Java_com_jnidemo_JniDemo_add(JNIEnv * env, jobject jobj, jint a, jint b){
 return a + b;
}

/*
 * Class:     com_jnidemo_JniDemo
 * Method:    sub
 * Signature: (II)I
 */
JNIEXPORT jint JNICALL Java_com_jnidemo_JniDemo_sub(JNIEnv* env, jobject jobj, jint a, jint b){
 return a - b;
}

添加jdk的jni.h文件到项目中，进行依赖构建

右击项目，现在属性

选择图中这两个目录，做为构建依赖目录；这两个目录分别存在jni.h和jni_md.h两个头文件

构建c/c++项目

另外要特别注意编译的dll的x86与x64一定要与JDK的版本对应，否则在java调用dll时会出现以下错误：

Can't load IA 32-bit .dll on a AMD 64-bit platform

5.编写java代码调用dll

package com.jnidemo;

public class JniDemo {

  // 声明本地方法
    public native int add(int a, int b);
    
    public native int sub(int a, int b);
    
    static {
     System.out.println(System.getProperty("java.library.path"));
     // x64
      System.load("E:\\dllws\\JniTestDemo\\x64\\Debug\\JniTestDemo.dll");
    }
    
    public static void main(String[] args) {
     JniDemo ob = new JniDemo();
     System.out.println(ob.add(1, 2));
     System.out.println(ob.sub(2, 3));
 }
    
}

6. 加载dll&so库文件的路径java.library.path说明

• Java的System.load和System.loadLibrary都可以用来加载库文件。例如可以这样载入一个windows平台下JNI库文件：

System.load("D://dll//TestJNI.dll"); //绝对路径

• System.loadLibrary参数为库文件名

例如可以这样载入一个windows平台下JNI库文件

System.loadLibrary ("TestJNI");

这里TestJNI必须在java.library.path这一jvm变量所指向的路径中，可以通过如下方法获得该变量的值：

System.getProperty("java.library.path");

默认情况下，Windows平台下包含下面的路径：

1）和jre相关的目录

2）程序当前目录

3）Windows目录

4）系统目录(system32)

5）系统环境变量path指定的目录

• 在linux下添加一个java.library.path的方法如下： 在/etc/profile后面加上一行

export LB_LIBRARY_PATH=路径

• 在执行程序的时候可以显示指定，-Djava.library.path=路径，这种会清除掉预设置的java.library.path的值。

java -jar -Djava.library.path=/usr/lib TestJni.jar