1. Java调用JNI动态链接库全流程解析
作为一名长期在Java和C/C++混合开发领域摸爬滚打的开发者，我经常需要处理Java与本地代码的交互问题。今天我将完整分享从环境搭建到代码实现的详细流程，包含大量官方文档中不会提及的实战技巧。这个方案特别适合需要以下场景的开发者：
- 复用现有的C/C++算法库
- 提升Java程序关键部分的性能
- 访问Java无法直接操作的系统资源
重要提示：本文基于Windows平台演示，但核心原理同样适用于Linux(.so)和Mac(.dylib)系统
2. 环境准备与工具链配置
2.1 JDK安装验证
推荐使用JDK 8或11这两个LTS版本，这两个版本在企业环境中最为稳定。安装后需要确认三个关键点：
- JAVA_HOME配置：
bash复制# Windows设置示例
setx JAVA_HOME "C:\Program Files\Java\jdk1.8.0_301"
setx Path "%Path%;%JAVA_HOME%\bin"
- 版本验证：
bash复制java -version
# 预期输出类似：
# java version "1.8.0_301"
# Java(TM) SE Runtime Environment (build 1.8.0_301-b09)
# Java HotSpot(TM) 64-Bit Server VM (build 25.301-b09, mixed mode)
- javac可用性：
bash复制javac -version
# 应显示与java命令匹配的版本号
2.2 开发工具选型
- Java IDE：Eclipse/IntelliJ IDEA均可，本文以Eclipse为例
- C++ IDE：Visual Studio 2019/2022社区版（免费）
- 构建工具：建议使用CMake管理C++项目，比原生VS项目更灵活
避坑指南：VS安装时必须勾选"C++桌面开发"工作负载，并确保Windows SDK版本与系统匹配
3. Java端实现详解
3.1 项目创建与JNI声明
在Eclipse中创建名为JNITest的Java项目，建立包结构com.test.jni，新建Java2cpp.java：
java复制package com.test.jni;
public class Java2cpp {
// 加载动态库（注意不要加.dll扩展名）
static {
System.loadLibrary("javaCallcpp");
}
// 声明native方法
public native int add(int num1, int num2);
public native int sub(int num1, int num2);
public native int mul(int num1, int num2);
public native int div(int num1, int num2);
public static void main(String[] args) {
Java2cpp calculator = new Java2cpp();
System.out.println("Addition: " + calculator.add(5, 3));
System.out.println("Subtraction: " + calculator.sub(5, 3));
System.out.println("Multiplication: " + calculator.mul(5, 3));
System.out.println("Division: " + calculator.div(6, 3));
}
}
3.2 生成JNI头文件
关键步骤解析：
- 编译Java文件生成.class
- 使用javac -h生成C/C++头文件
bash复制cd /path/to/project/src
javac com/test/jni/Java2cpp.java
javac -h ./ com/test/jni/Java2cpp.java
生成的头文件com_test_jni_Java2cpp.h内容示例：
c复制/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_test_jni_Java2cpp */
#ifndef _Included_com_test_jni_Java2cpp
#define _Included_com_test_jni_Java2cpp
#ifdef __cplusplus
extern "C" {
#endif
JNIEXPORT jint JNICALL Java_com_test_jni_Java2cpp_add
(JNIEnv *, jobject, jint, jint);
JNIEXPORT jint JNICALL Java_com_test_jni_Java2cpp_sub
(JNIEnv *, jobject, jint, jint);
JNIEXPORT jint JNICALL Java_com_test_jni_Java2cpp_mul
(JNIEnv *, jobject, jint, jint);
JNIEXPORT jint JNICALL Java_com_test_jni_Java2cpp_div
(JNIEnv *, jobject, jint, jint);
#ifdef __cplusplus
}
#endif
#endif
4. C++动态库开发实战
4.1 创建VS动态库项目
- 新建Win32项目 → 选择DLL
- 配置关键项目属性：
- 平台工具集：与JDK位数一致（x86或x64）
- 附加包含目录：添加JDK下的include和include/win32目录
4.2 实现JNI方法
创建Java2cppImpl.cpp文件：
cpp复制#include "com_test_jni_Java2cpp.h"
#include <stdexcept>
JNIEXPORT jint JNICALL Java_com_test_jni_Java2cpp_add
(JNIEnv *env, jobject obj, jint a, jint b) {
return a + b;
}
JNIEXPORT jint JNICALL Java_com_test_jni_Java2cpp_sub
(JNIEnv *env, jobject obj, jint a, jint b) {
return a - b;
}
JNIEXPORT jint JNICALL Java_com_test_jni_Java2cpp_mul
(JNIEnv *env, jobject obj, jint a, jint b) {
return a * b;
}
JNIEXPORT jint JNICALL Java_com_test_jni_Java2cpp_div
(JNIEnv *env, jobject obj, jint a, jint b) {
if (b == 0) {
env->ThrowNew(env->FindClass("java/lang/ArithmeticException"),
"Division by zero");
return 0;
}
return a / b;
}
4.3 编译与输出配置
- 修改输出文件名与Java代码中的
System.loadLibrary()一致 - 配置运行时库为MD/MDd（与JVM匹配）
- 生成解决方案得到.dll文件
5. 部署与调试技巧
5.1 DLL部署位置
将生成的DLL放在以下任一目录：
- Java项目的根目录
- System32目录（不推荐）
- 通过
-Djava.library.path指定的路径
bash复制java -Djava.library.path=/path/to/dll com.test.jni.Java2cpp
5.2 常见问题排查
-
UnsatisfiedLinkError：
- 检查DLL文件名是否正确
- 确认位数匹配（x86/x64）
- 使用Dependency Walker检查依赖项
-
JNIEnv使用注意事项：
- 不要缓存JNIEnv指针
- 多线程环境下需要Attach/Detach
-
内存管理：
- 本地代码中分配的内存需要手动释放
- 注意处理全局引用和弱引用
6. 高级应用场景
6.1 复杂数据类型处理
处理字符串示例：
cpp复制JNIEXPORT jstring JNICALL Java_com_test_jni_Java2cpp_concat
(JNIEnv *env, jobject obj, jstring str1, jstring str2) {
const char *cstr1 = env->GetStringUTFChars(str1, NULL);
const char *cstr2 = env->GetStringUTFChars(str2, NULL);
char result[256];
strcpy(result, cstr1);
strcat(result, cstr2);
env->ReleaseStringUTFChars(str1, cstr1);
env->ReleaseStringUTFChars(str2, cstr2);
return env->NewStringUTF(result);
}
6.2 性能优化技巧
- 临界区访问：使用
GetPrimitiveArrayCritical - 方法ID缓存：
cpp复制// 类初始化时缓存
jmethodID mid;
JNIEXPORT void JNICALL Java_MyClass_init
(JNIEnv *env, jobject obj) {
jclass cls = env->GetObjectClass(obj);
mid = env->GetMethodID(cls, "callback", "(I)V");
}
// 后续直接使用缓存的mid
7. 跨平台构建方案
对于需要支持多平台的场景，推荐使用CMake管理C++项目：
cmake复制cmake_minimum_required(VERSION 3.10)
project(JavaCallCpp)
find_package(JNI REQUIRED)
include_directories(${JNI_INCLUDE_DIRS})
add_library(javaCallcpp SHARED Java2cppImpl.cpp)
构建命令：
bash复制mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build .
在实际项目开发中，我强烈建议：
- 为JNI接口添加完善的错误处理
- 考虑使用SWIG等工具简化接口生成
- 建立完善的单元测试体系
- 文档化所有native方法的线程安全要求