[C语言实战]如何封装 JNI 实现 Java 与 C 的高效交互？原理详解 + 代码实战（附完整测试步骤）

[C语言实战]如何封装 JNI 实现 Java 与 C 的高效交互？原理详解 + 代码实战（附完整测试步骤：三）

导言

在 Java 开发中，JNI（Java Native Interface） 是连接 Java 与本地代码（如 C/C++）的桥梁。通过 JNI，开发者可以复用高性能的 C 库、调用系统级 API，或实现跨语言混合编程。本文将从 原理剖析、代码封装实战、跨平台编译 到 测试验证，手把手教你掌握 JNI 的核心技术，并规避常见陷阱！

一、JNI 核心原理

1. JNI 的作用与流程

• 核心功能：允许 Java 与本地代码（如 C/C++）互相调用。
• 交互流程：
  1. Java 声明本地方法：通过 native 关键字定义方法。
  2. 生成头文件：使用 javac -h 或 javah 工具生成 C/C++ 头文件。
  3. 实现本地代码：根据头文件编写 C/C++ 函数。
  4. 编译为动态库：生成 .so（Linux）或 .dll（Windows）文件。
  5. Java 加载并调用：通过 System.loadLibrary 加载动态库。

2. 关键数据结构与函数

• JNIEnv：指向 JNI 环境的指针，提供所有 JNI 函数。
• jclass/jobject：表示 Java 类或对象。
• 数据类型映射：
  • Java int → C jint
  • Java String → C jstring
  • Java 数组 → C jarray

二、环境准备与代码实现

1. 开发环境

• JDK 8+（需包含 javac, javah 工具）
• GCC 编译器（Linux）或 MinGW（Windows）
• IDE：IntelliJ IDEA 或 VS Code（可选）

2. 完整代码实现

步骤 1：编写 Java 类（JNIDemo.java）

public class JNIDemo {// 声明本地方法public native String reverseString(String input);public native int addNumbers(int a, int b);// 加载动态库（名称需与编译后的库名一致）static {System.loadLibrary("jnidemo");}public static void main(String[] args) {JNIDemo demo = new JNIDemo();System.out.println("反向字符串: " + demo.reverseString("Hello JNI!"));System.out.println("加法结果: " + demo.addNumbers(3, 5));}
}

步骤 2：生成头文件

# 编译 Java 类
javac JNIDemo.java# 生成头文件
javac -h . JNIDemo.java

生成的头文件 JNIDemo.h 内容如下：

#include <jni.h>
JNIEXPORT jstring JNICALL Java_JNIDemo_reverseString(JNIEnv *, jobject, jstring);
JNIEXPORT jint JNICALL Java_JNIDemo_addNumbers(JNIEnv *, jobject, jint, jint);

windows下编译截图：

linux下编译截图：

步骤 3：实现 C 代码（JNIDemo.c）

#include <stdio.h>
#include <string.h>
#include "JNIDemo.h"// 实现字符串反转
JNIEXPORT jstring JNICALL Java_JNIDemo_reverseString(JNIEnv *env, jobject obj, jstring input) {const char *str = (*env)->GetStringUTFChars(env, input, NULL);int length = strlen(str);char reversed[length + 1];for (int i = 0; i < length; i++) {reversed[i] = str[length - 1 - i];}reversed[length] = '\0';(*env)->ReleaseStringUTFChars(env, input, str);return (*env)->NewStringUTF(env, reversed);
}// 实现加法
JNIEXPORT jint JNICALL Java_JNIDemo_addNumbers(JNIEnv *env, jobject obj, jint a, jint b) {return a + b;
}

步骤 4：编译为动态库(libjnidemo.so)

Linux

gcc -I"${JAVA_HOME}/include" -I"${JAVA_HOME}/include/linux" -shared -o libjnidemo.so JNIDemo.c

编译截图：

Windows（MinGW）

gcc -I"%JAVA_HOME%\include" -I"%JAVA_HOME%\include\win32" -shared -o jnidemo.dll JNIDemo.c

编译截图：

三、测试步骤详解

1. 运行 Java 程序

# Linux：需设置库路径: 代码和库都在当前路径下，所以设置libjnidemo.so库路径
export LD_LIBRARY_PATH=. #临时添加当前目录到动态库搜索路径
java JNIDemo  #运行依赖本地库的 Java 程序。# Windows：将 jnidemo.dll 放在项目根目录
java JNIDemo

2. 预期输出

反向字符串: !INJ olleH
加法结果: 8

linux下测试：

windows下测试：

四、关键问题与注意事项

1. JNI 数据类型转换

• 字符串处理：必须通过 GetStringUTFChars 和 NewStringUTF 转换。
• 内存管理：及时释放资源（如 ReleaseStringUTFChars），避免内存泄漏。

2. 异常处理

• 检查异常：调用 JNI 函数后，使用 ExceptionCheck 检测异常。

  if ((*env)->ExceptionCheck(env)) {(*env)->ExceptionDescribe(env);(*env)->ExceptionClear(env);return NULL;
  }
  

3. 跨平台编译

• 动态库命名：Linux 为 libxxx.so，Windows 为 xxx.dll。
• 路径设置：确保 Java 程序能找到动态库（LD_LIBRARY_PATH 或 java.library.path）。

五、常见问题解答

Q1：如何解决 UnsatisfiedLinkError？

• 原因：动态库未找到或函数签名不匹配。
• 解决：
  1. 检查库路径和名称。
  2. 使用 nm -D libxxx.so（Linux）或 dumpbin /exports xxx.dll（Windows）验证函数导出。

Q2：如何传递复杂对象或数组？

• 对象访问：使用 GetFieldID 和 GetObjectField 访问对象字段。
• 数组操作：通过 GetIntArrayElements 获取数组指针，操作后调用 ReleaseIntArrayElements。

Q3：如何调试 JNI 代码？

• 日志输出：在 C 代码中使用 printf 或 __android_log_print（Android）。
• GDB/LLDB：附加到 Java 进程进行调试。

六、总结

通过本文的代码实现与测试步骤，可以掌握 JNI 的核心原理和封装技巧。JNI 在性能优化和跨语言整合中具有重要作用，但也需谨慎处理内存和异常。实际开发中，推荐结合 Swig 等工具自动生成胶水代码，进一步提升效率。

扩展学习：

• Oracle JNI 官方文档

希望本教程对您有帮助，请点赞❤️收藏⭐关注支持！欢迎在评论区留言交流技术细节！