JNI（Java Native Interface）入门篇

浅浅的花香味﹌ 2023-10-08 15:16 0阅读 0赞

#### 文章目录 ####

*  前言
 *  一、JNI是什么？
 *  二、环境准备
 *  三、操作过程
 *   *  1. Java声明native方法
     *  2. 编译生成 class 文件
     *  3. 编译生成 .h 文件
     *  4. 手动编写 c 文件
     *  5. 编译生成 .o 文件
     *  6. 编译生成 dll 文件
     *  7. 调用 dll 库文件
 *  总结

--------------------

## 前言 ##

`本篇博客内容，是纯粹的【从零构建dll库文件，到使用】的步骤，没有包含相关的概念解释`

--------------------

## 一、JNI是什么？ ##

百度百科：

> JNI 是Java Native Interface的 缩写，通过使用 Java 本地接口书写程序，可以确保代码在不同的平台上方便移植。 从Java1.1开始，JNI标准成为java平台的一部分，它允许Java代码和其他语言写的代码进行交互。JNI一开始是为了本地已编译语言，尤其是C和C++而设计的，但是它并不妨碍你使用其他编程语言，只要调用约定受支持就可以了。使用java与本地已编译的代码交互，通常会丧失平台可移植性。但是，有些情况下这样做是可以接受的，甚至是必须的。例如，使用一些旧的库，与硬件、操作系统进行交互，或者为了提高程序的性能。JNI标准至少要保证本地代码能工作在任何Java 虚拟机环境。

JNI 我们一般用来定义本地方法的声明，然后使用 C 、C++ 语言做具体的逻辑编写，实现使用java代码去调用 C 、C++ 代码的效果。

## 二、环境准备 ##

以下所有操作均是在 **windows** 环境下，需要安装 gcc 环境，windows 平台下安装 gcc 可以有如下选择

> MinGW [（下载连接）][Link 1]  
> Cygwin

`注意：搭建GCC编译环境时，一定要选择跟你JDK相对应的版本（32位和64位）否则后面编译后的 dll 文件调用是会报错的`

安装完，打开 cmd 验证 gcc 是否可用

gcc -v

## 三、操作过程 ##

### 1. Java声明native方法 ###

创建文件 **MyJNI.java**

`注意：native方法如果没有带package，那调用这个库文件的文件也不能带package`

package com.liqiye;
    
    public class MyJNI{
        
    	public native void exec();
    }

### 2. 编译生成 class 文件 ###

在 MyJNI.java 文件所在的目录下执行

javac -d . MyJNI.java

执行完，同级目录会生成 com/liqiye/**MyJNI.class**

### 3. 编译生成 .h 文件 ###

在 MyJNI.java 文件所在的目录下执行，在类名前面加上包名

javah com.liqiye.MyJNI

执行完，同级目录会生成文件 **com\_liqiye\_MyJNI.h**

`注意：生成的 .h 文件名是有规则的， package包名_类名.h`

### 4. 手动编写 c 文件 ###

创建 MyJNI.c  
（方法里面就是我们具体要实现的逻辑）

#include <stdio.h>
    #include "com_liqiye_MyJNI.h"
    
    JNIEXPORT void JNICALL JNICALL Java_com_liqiye_MyJNI_exec(JNIEnv *env, jobject object){
        
        printf("Hello jni!\n");
    }

`注意：第二个include是引入当前目录下的.h文件，名字修改成你自己生成的.h文件`

### 5. 编译生成 .o 文件 ###

在 MyJNI.c 文件所在的目录下执行

gcc -c -I"C:\liqiye\software\jdk8\include" -I"C:\liqiye\software\jdk8\include\win32" MyJNI.c

执行完，同级目录会生成文件 **MyJNI.o**

`注意：修改成你自己的jdk目录`

### 6. 编译生成 dll 文件 ###

在 MyJNI.o 文件所在的目录下执行

gcc -Wl,--add-stdcall-alias -shared -o MyJNI.dll MyJNI.o

执行完，同级目录会生成文件 **MyJNI.dll**

### 7. 调用 dll 库文件 ###

把刚才生成的 **MyJNI.dll** 放在 jdk 的 bin 目录 下  
`（因为下面的 System.loadLibrary() 方法会去运行path环境下，找对应的库文件，而 jdk 的 bin 目录是其中之一）`

编写调用的 Test 方法

public class Test {
        
    
        public static void main(String[] args) {
        
            try {
        
                System.loadLibrary("TestJNI");
                MyJNI test = new MyJNI();
                test.exec();
            } catch (Exception e){
        
                e.printStackTrace();
            }
        }
    }

看到控制台打印：  
![在这里插入图片描述][186dca9cdbf14e79973d9b6cc57e4aef.png]

## 总结 ##

欢迎指出我的错误！

[Link 1]: https://sourceforge.net/projects/mingw/files/MinGW/Base/gcc/
[186dca9cdbf14e79973d9b6cc57e4aef.png]: https://img-blog.csdnimg.cn/186dca9cdbf14e79973d9b6cc57e4aef.png