Java 调用 SO 动态库示例
当我们使用 Java 开发时，有时需要与用 C 或 C++ 编写的本地代码交互，这时我们可以使用共享库（.so 文件）。本教程将带你一步步实现 Java 调用 SO 动态库的过程。
整体流程
以下是实现 Java 调用 .so 动态库的步骤概览：
| 步骤 | 说明 |
|---|---|
| 步骤1 | 编写 C/C++ 代码并生成 .so 动态库 |
| 步骤2 | 创建 Java 接口以加载 .so 动态库 |
| 步骤3 | 编写 Java 实现代码以调用本地方法 |
| 步骤4 | 编译和运行 Java 代码 |
流程图
下面是整个流程的可视化图示：
flowchart TD
A[步骤1: 编写 C/C++ 代码并生成 .so 动态库] --> B[步骤2: 创建 Java 接口以加载 .so 动态库]
B --> C[步骤3: 编写 Java 实现代码以调用本地方法]
C --> D[步骤4: 编译和运行 Java 代码]
步骤详细说明
步骤1: 编写 C/C++ 代码并生成 .so 动态库
在此步骤中，我们需要创建一个简单的 C 代码，并编译为 SO 动态库。
// HelloNative.c
#include <jni.h>
#include <stdio.h>
// 实现根据 Java 方法名规定的方式实现
JNIEXPORT void JNICALL Java_HelloNative_sayHello(JNIEnv *env, jobject obj) {
printf("Hello from C!\n"); // 打印简单的问候语
}
然后使用以下命令编译为 .so 文件（假设你在 Unix/Linux 系统下）：
gcc -shared -o libHelloNative.so -I"${JAVA_HOME}/include" -I"${JAVA_HOME}/include/linux" HelloNative.c
-shared选项用于创建共享库-o libHelloNative.so指定输出文件名-I选项指定 Java 安装目录下的 JNI 头文件路径
步骤2: 创建 Java 接口以加载 .so 动态库
在这个步骤中，我们将创建一个 Java 类，使用 System.loadLibrary 方法加载共享库。
// HelloNative.java
public class HelloNative {
// 声明本机方法
public native void sayHello();
static {
// 加载动态库
System.loadLibrary("HelloNative"); // 不需要加 ".so" 后缀
}
}
public native void sayHello();声明了一个本地方法。System.loadLibrary("HelloNative");用于动态加载之前生成的 .so 文件。
步骤3: 编写 Java 实现代码以调用本地方法
现在，我们可以编写一个主类来调用我们之前定义的本地方法。
// Main.java
public class Main {
public static void main(String[] args) {
HelloNative hello = new HelloNative(); // 创建对象
hello.sayHello(); // 调用本地方法
}
}
步骤4: 编译和运行 Java 代码
在这个步骤中，我们需要编译我们的 Java 代码。首先确保 C/C++ 的动态库在你的库路径（或当前工作目录）。
使用下面的命令编译 Java 文件：
javac HelloNative.java Main.java
然后运行 Java 程序：
java -Djava.library.path=. Main
-Djava.library.path=.指定搜索动态库的路径为当前工作目录。
运行结果
运行完上述命令后，屏幕上应该会显示：
Hello from C!
这表明我们成功地从 Java 程序中调用了 C/C++ 编写的本地方法。
旅行图
下面是我们完成整个过程的旅行图：
journey
title Java 调用 SO 动态库的过程
section 编写 C/C++ 代码
编写 HelloNative.c并实现方法: 5: C
section 生成 SO 文件
使用 gcc 生成 libHelloNative.so: 4: C
section Java 接口
创建 HelloNative.java并加载库: 5: J
section 调用本地方法
编写 Main.java并运行: 5: J
结论
通过本教程，我们了解了如何通过 Java 调用用 C/C++ 编写的 .so 动态库。我们从编写本地代码开始，到创建 Java 接口，再到编写 Java 调用逻辑，最后成功运行了程序。这一过程对任何希望扩展 Java 应用程序功能的开发者来说都是非常有用的。希望通过这篇文章，你能更好地理解如何实现 Java 调用 SO 动态库。如果有任何问题或疑问，请随时提问！
