JNI：Java与本地代码的桥梁
在Java生态中,.so文件（Linux系统下的动态链接库）通常用于封装高性能或底层系统功能（如硬件交互、算法优化等），由于Java本身运行在虚拟机上，无法直接调用本地代码，需通过Java Native Interface（JNI）实现桥接，JNI是Java平台的一部分，允许Java代码与C/C++等本地语言编写的代码交互，从而复用现有库或实现Java难以完成的任务，调用.so文件的核心在于通过JNI定义本地方法，将Java与本地代码关联，并确保库的正确加载与调用。
调用.so文件的完整步骤
环境准备
开发前需搭建交叉编译环境,主要包括以下工具：
- JDK：需包含
javac（编译Java代码）、java（运行程序）、javah（生成C头文件，JDK 9后需通过javac -h替代）。 - GCC编译器：用于将C/C++代码编译为.so文件，需支持
-shared和-fpic参数生成位置无关代码。 - 开发库：若.so依赖其他本地库（如
libssl.so），需确保系统中已安装对应开发包。
以Linux环境为例,可通过sudo apt-get install build-essential openjdk-8-jdk安装基础工具链。
编写Java代码并声明本地方法
首先创建Java类,使用native关键字声明需调用的本地方法，定义一个HelloJNI类，包含一个返回字符串的本地方法sayHello：
public class HelloJNI {
// 声明本地方法
public native String sayHello();
// 静态代码块中加载.so库（确保类加载时即完成库加载）
static {
System.loadLibrary("hello"); // 加载libhello.so
}
public static void main(String[] args) {
HelloJNI hello = new HelloJNI();
System.out.println(hello.sayHello());
}
}
编译Java代码生成.class文件：
javac HelloJNI.java
生成C/C++头文件
使用javah（JDK 8及以下）或javac -h（JDK 9及以上）生成包含本地方法签名的头文件。
javac -h . HelloJNI.java # 生成HelloJNI.h
生成的头文件（HelloJNI.h如下，定义了C函数的接口：
#include <jni.h>
#ifndef _Included_HelloJNI
#define _Included_HelloJNI
#ifdef __cplusplus
extern "C" {
#endif
JNIEXPORT jstring JNICALL Java_HelloJNI_sayHello(JNIEnv *, jobject);
#ifdef __cplusplus
}
#endif
#endif
关键点说明：
- 函数名格式为
Java_包名_类名_方法名（此处无包名，故为Java_HelloJNI_sayHello）。 JNIEnv *：指向JNI环境的指针，用于调用JNI函数（如创建字符串、抛出异常）。jobject：表示当前Java对象实例（静态方法为jclass）。JNIEXPORT/JNICALL：声明函数为JNI导出函数，确保编译器正确处理。
实现本地方法
根据生成的头文件,编写C/C++代码实现本地方法，创建hello.c：
#include "HelloJNI.h"
#include <stdio.h>
JNIEXPORT jstring JNICALL Java_HelloJNI_sayHello(JNIEnv *env, jobject obj) {
// 使用JNI函数创建Java字符串
return (*env)->NewStringUTF(env, "Hello from JNI!");
}
核心逻辑：通过JNIEnv指针调用JNI函数NewStringUTF，将C字符串转换为Java字符串（jstring）。
编译生成.so文件
使用GCC将C代码编译为共享库,需指定JDK的头文件路径和链接选项：
gcc -shared -fpic -I${JAVA_HOME}/include -I${JAVA_HOME}/include/linux -o libhello.so hello.c
参数说明：
-shared：生成共享库（.so文件）。-fpic：生成位置无关代码，确保库可被动态加载。-I：指定JDK头文件路径（${JAVA_HOME}为JDK安装目录，如/usr/lib/jvm/java-8-openjdk-amd64）。
编译成功后,当前目录下会生成libhello.so文件。
运行Java程序
确保libhello.so位于Java类路径或java.library.path指定的目录中，然后运行程序：
java HelloJNI
若.so文件不在默认路径，可通过以下方式指定：
- 命令行参数：
java -Djava.library.path=/path/to/lib HelloJNI。 - 环境变量：
export LD_LIBRARY_PATH=/path/to/lib:$LD_LIBRARY_PATH。
输出结果应为：Hello from JNI!
关键注意事项
数据类型映射
Java与C/C++数据类型通过JNI映射，需避免类型不匹配。
- Java基本类型（
int、double等）对应JNI类型（jint、jdouble）。 - Java对象（
String、Object）对应JNI引用类型（jstring、jobject），需通过JNI函数转换（如NewStringUTF、GetStringUTFChars）。
内存管理
JNI引用分为局部引用和全局引用,需注意生命周期：
- 局部引用：在本地方法调用期间有效，方法返回后自动释放，若需长期使用（如返回Java对象），需通过
NewGlobalRef转换为全局引用，并通过DeleteGlobalRef手动释放。 - 避免内存泄漏：调用
GetStringUTFChars获取C字符串后，需用ReleaseStringUTFChars释放，否则会导致内存泄漏。
异常处理
本地代码中可通过ExceptionCheck检查Java异常，若发生异常，需先处理再返回。
jstring result = (*env)->CallObjectMethod(env, obj, methodID);
if ((*env)->ExceptionCheck(env)) {
(*env)->ExceptionDescribe(env); // 打印异常信息
(*env)->ExceptionClear(env); // 清除异常
return NULL;
}
跨平台兼容性
.so文件是Linux专属，Windows需编译为.dll，macOS需编译为.dylib，若需跨平台，需针对不同系统分别编译，并通过条件编译或脚本管理不同平台的库文件。
常见问题与解决方案
找不到.so文件（UnsatisfiedLinkError）
- 原因：库文件路径未正确配置。
- 解决：检查
java.library.path或LD_LIBRARY_PATH是否包含.so文件所在目录，确保库文件名符合libxxx.so格式（System.loadLibrary会自动添加lib前缀和.so后缀）。
方法签名错误
- 原因：C函数名或参数与JNI生成的不一致。
- 解决：核对
javac -h生成的头文件，确保函数名、参数类型（JNIEnv*、jobject等）与实现代码一致。
多线程安全问题
- 原因：JNIEnv不是线程安全的，每个线程需获取独立的JNIEnv指针。
- 解决：通过
AttachCurrentThread将Java线程附加到JVM获取JNIEnv，或确保本地方法仅在单线程中调用。
通过以上步骤和注意事项,即可实现Java对.so文件的稳定调用，JNI虽然强大，但需谨慎处理本地代码与Java的交互细节，以避免性能瓶颈或内存问题。
