如何快速使用JNI

1_JNI是什么？

JNI 是Java Native Interface的缩写，通过JNI，允许Java代码与其他语言（通常是C或C++）编写的本地应用程序或库进行交互。简而言之就是，Java可以通过JNI调用C 或 C++ 语言写的代码。

2_使用

1、首先，准备一个demo让我们进行JNI的快速入门使用：

/**
 * @author shenyang
 * @version 1.0
 * @info JNI
 * @since 2024/6/29 下午5:03
 */
public class JNIDemo {
    public static void main(String[] args) {
    	System.out.println(System.getProperty("java.library.path"));
        System.out.println(add(1,2));
    }
}

2、需要将C/C++实现的方法用native关键字声明。

• 由native关键字声明的方法我们就不需要给出方法体了，直接给出声明就好了。

public static native int add(int a, int b);//这个方法的作用是将两个整型相加

3、加载动态链接库（windows上.dll为后缀，linux上.so为后缀名），通常是使用静态代码块来进行导入。

• 使用 System对象的 public static void loadLibrary(String libname)方法不需要后缀，只要（库所在路径加上）库名。

static {
    System.loadLibrary("jniDemo");
}

4、使用 javac -h或 javah生成.h为后缀的头文件

• 注意：jdk10之后将javah这一命令移除了，JEP313: 移除JDK中附带的javah工具。
• 注意下面第一个参数是存放到当前路径下（./）

javac -h ./ JNIDemo.java

• 生成的头文件JNIDemo.h。

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h> //这个头文件在jdk/include/下
/* Header for class JNIDemo */

#ifndef _Included_JNIDemo
#define _Included_JNIDemo
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     JNIDemo 说明这个方法是在哪个类里
 * Method:    add     对应的是java中的add方法
 * Signature: (II)I	  括号里两个II表示第一个参数和第二个参数都是int类型，括号后面的I表示这个方法的返回值是int类型
 * 下面这部分是C++需要实现的函数声明
 */
JNIEXPORT jint JNICALL Java_JNIDemo_add
  (JNIEnv *, jclass, jint, jint);

#ifdef __cplusplus
}
#endif
#endif

下面这部分是C++需要实现的函数声明：

JNIEXPORT jint JNICALL Java_JNIDemo_add
  (JNIEnv *, jclass, jint, jint);

5、根据生成的头文件里的函数声明实现对应的函数，创建JNIDemo.cpp文件。

• 注意：下面的代码包含了之前生成的头文件JNIDemo.h，还需要其他头文件也可以一并包含进去，比如：iostream。
• 下面四个参数：JNIEnv *是一个指针封装了一些JNI的操作在里面，jclass参数也用不到只放一个参数类型就行了，后面两个参数因为用的到所以把参数名加上。
• 函数的最终目的是返回a+b，再加上一些其他操作我们进行测试；

#include "JNIDemo.h"
#include <iostream>

JNIEXPORT jint JNICALL Java_JNIDemo_add(JNIEnv *, jclass , jint a, jint b)
{
    std::cout <<"a = "<< a<<"	b= "<< b <<std::endl;
    return a+b;
}

6、将上面的cpp文件编译成动态链接库。

给对C++不太了解的同学解释下下面命令的意义：

• -o jniDemo.dll: 指定输出文件的名称为jniDemo.dll（与System.loadLibrary("jniDemo")中保持统一）。在Windows系统上，动态链接库通常以.dll为扩展名。

• -fPIC: 表示生成位置无关代码（Position-Independent Code）。这是生成共享库时常用的选项，使得生成的代码在加载到内存中的任何位置时都可以正确运行。

• -shared: 指定生成一个共享库（动态链接库），而不是可执行文件。

• -I: 包含路径选项，用于指定头文件所在目录。在这里，包含了特定于Windows系统的Java头文件。

• JNIDemo.cpp: 源文件名，包含了具体的JNI方法实现。

• 如果windows电脑上使用不了g++命令，那么可以下载MinGWX64 - x86_64-win32-sjlj。

g++ -o jniDemo.dll -fPIC -shared -I"E:\shenyang\.jdks\jdk-1.8\include\win32" -I"E:\shenyang\.jdks\jdk-1.8\include" JNIDemo.cpp

执行完毕后发先目录下出现jniDemo.dll文件：

最后运行 JNIDemo.java ，查看运行结果：

3_扩展

基础数据类型对应表：

引用数据类型对应表：