1. JNI基础概念与环境搭建JNIJava Native Interface作为Java与本地代码如C/C交互的桥梁在Android开发、高性能计算、硬件操作等场景中扮演着关键角色。我最初接触JNI是为了解决一个图像处理性能瓶颈问题——纯Java实现的算法耗时是C版本的3倍以上。通过JNI将核心算法移植到C层后整体性能提升了200%这让我深刻认识到掌握JNI的重要性。要开始JNI开发首先需要配置基础环境。对于Android开发者来说Android Studio已经集成了NDK工具链。如果是标准Java项目则需要安装JDK并配置JAVA_HOME环境变量确保系统已安装C/C编译器如GCC或MSVC准备头文件jni.h位于JDK安装目录的include文件夹中验证环境是否就绪的最快方法是创建一个简单的JNI示例// HelloJNI.java public class HelloJNI { static { System.loadLibrary(hello); // 加载动态库 } private native void sayHello(); public static void main(String[] args) { new HelloJNI().sayHello(); } }然后用javac编译并用javah生成头文件javac HelloJNI.java javah -jni HelloJNI这会生成HelloJNI.h头文件包含函数声明。接着实现对应的C函数#include jni.h #include stdio.h #include HelloJNI.h JNIEXPORT void JNICALL Java_HelloJNI_sayHello(JNIEnv *env, jobject thisObj) { printf(Hello from JNI!\n); return; }最后编译为动态库并运行# Linux/macOS gcc -shared -fpic -I${JAVA_HOME}/include -I${JAVA_HOME}/include/linux HelloJNI.c -o libhello.so java -Djava.library.path. HelloJNI # Windows cl -I%JAVA_HOME%\include -I%JAVA_HOME%\include\win32 HelloJNI.c -Fehello.dll java -Djava.library.path. HelloJNI注意在Windows上动态库的扩展名是.dll而在Linux/macOS上是.so。System.loadLibrary()参数不需要包含lib前缀和扩展名。2. JNI核心函数解析与使用场景2.1 类与对象操作函数FindClass是JNI中最基础也是最重要的函数之一它的作用是根据全限定类名查找并加载Java类。我在实际项目中曾遇到过ClassNotFoundException原因是包名大小写不匹配——Java区分大小写而我在C代码中误将com.example写成了Com.Example。jclass FindClass(JNIEnv *env, const char *name);典型使用方式jclass stringClass (*env)-FindClass(env, java/lang/String); if (stringClass NULL) { // 错误处理 }对象操作相关函数包括AllocObject: 不调用构造函数创建对象实例NewObject: 调用构造函数创建对象实例GetObjectClass: 获取对象的类引用创建对象的两种方式对比// 方式1AllocObject 调用方法初始化 jclass dateClass (*env)-FindClass(env, java/util/Date); jmethodID initMethod (*env)-GetMethodID(env, dateClass, init, ()V); jobject dateObj1 (*env)-AllocObject(env, dateClass); (*env)-CallVoidMethod(env, dateObj1, initMethod); // 方式2直接NewObject jobject dateObj2 (*env)-NewObject(env, dateClass, initMethod);经验在性能敏感场景AllocObject手动初始化可能更快但大多数情况下NewObject更安全可靠。2.2 字段访问函数JNI提供了完整的字段访问API包括获取字段ID和读写字段值。字段ID在JNI层是缓存的理想候选因为获取字段ID相对耗时。获取字段ID的函数签名jfieldID GetFieldID(JNIEnv *env, jclass clazz, const char *name, const char *sig); jfieldID GetStaticFieldID(JNIEnv *env, jclass clazz, const char *name, const char *sig);字段访问函数家族函数类型实例字段静态字段获取字段IDGetFieldIDGetStaticFieldID读取整型GetIntFieldGetStaticIntField写入整型SetIntFieldSetStaticIntField读取对象GetObjectFieldGetStaticObjectField写入对象SetObjectFieldSetStaticObjectField一个典型的使用示例public class Person { public String name; public int age; public static String species Human; } // JNI访问代码 jclass personClass (*env)-FindClass(env, com/example/Person); jfieldID nameField (*env)-GetFieldID(env, personClass, name, Ljava/lang/String;); jfieldID ageField (*env)-GetFieldID(env, personClass, age, I); jfieldID speciesField (*env)-GetStaticFieldID(env, personClass, species, Ljava/lang/String;); jstring newName (*env)-NewStringUTF(env, John Doe); (*env)-SetObjectField(env, personObj, nameField, newName); int age (*env)-GetIntField(env, personObj, ageField); jstring species (*env)-GetStaticObjectField(env, personClass, speciesField);2.3 方法调用函数方法调用是JNI中最复杂的部分之一主要涉及方法ID获取和实际调用。方法签名Signature的正确性至关重要我在项目中曾因为一个分号遗漏导致JVM崩溃。获取方法ID的函数jmethodID GetMethodID(JNIEnv *env, jclass clazz, const char *name, const char *sig); jmethodID GetStaticMethodID(JNIEnv *env, jclass clazz, const char *name, const char *sig);方法调用函数家族返回类型实例方法静态方法voidCallVoidMethodCallStaticVoidMethodintCallIntMethodCallStaticIntMethodobjectCallObjectMethodCallStaticObjectMethodbooleanCallBooleanMethodCallStaticBooleanMethod方法签名示例// Java方法 public String getName(int id, boolean full) { ... } // 对应的签名 (IZ)Ljava/lang/String;完整的方法调用示例jclass personClass (*env)-FindClass(env, com/example/Person); jmethodID getNameMethod (*env)-GetMethodID(env, personClass, getName, (IZ)Ljava/lang/String;); jstring name (*env)-CallObjectMethod(env, personObj, getNameMethod, 123, JNI_TRUE);提示可以使用javap -s命令查看类的完整方法签名避免手动编写错误。3. 字符串与数组操作3.1 字符串处理JNI中的字符串处理需要特别注意内存管理和编码转换。Java使用Unicode编码通常是UTF-16而C/C通常使用UTF-8或本地编码。关键字符串函数// 创建Java字符串 jstring NewStringUTF(JNIEnv *env, const char *bytes); // 获取Java字符串内容 const char* GetStringUTFChars(JNIEnv *env, jstring string, jboolean *isCopy); void ReleaseStringUTFChars(JNIEnv *env, jstring string, const char *utf); // 获取字符串长度 jsize GetStringLength(JNIEnv *env, jstring string); jsize GetStringUTFLength(JNIEnv *env, jstring string);安全使用字符串的模板const char *str (*env)-GetStringUTFChars(env, javaString, NULL); if (str NULL) { return; // 内存不足 } // 使用str做处理... (*env)-ReleaseStringUTFChars(env, javaString, str);我在处理中文字符串时曾遇到乱码问题发现是因为没有正确处理UTF-8编码。解决方案是确保所有字符串操作都明确指定编码// 错误方式 - 可能导致编码问题 printf(%s, (*env)-GetStringUTFChars(env, javaString, NULL)); // 正确方式 - 明确处理编码 const char* utf8Str (*env)-GetStringUTFChars(env, javaString, NULL); // 使用ICU或其他库进行必要的编码转换 processUTF8String(utf8Str); (*env)-ReleaseStringUTFChars(env, javaString, utf8Str);3.2 数组操作JNI数组操作分为基本类型数组和对象数组处理方式有所不同。直接访问数组元素比通过Get/Set函数逐个访问要高效得多。基本类型数组函数// 创建数组 jintArray NewIntArray(JNIEnv *env, jsize length); jobjectArray NewObjectArray(JNIEnv *env, jsize length, jclass elementClass, jobject initialElement); // 获取数组元素 jint* GetIntArrayElements(JNIEnv *env, jintArray array, jboolean *isCopy); void ReleaseIntArrayElements(JNIEnv *env, jintArray array, jint *elems, jint mode); // 获取数组长度 jsize GetArrayLength(JNIEnv *env, jarray array);高效处理数组的两种方式直接访问适合大规模数据处理jint* arr (*env)-GetIntArrayElements(env, javaArray, NULL); if (arr NULL) { return; // 内存不足 } for (int i 0; i (*env)-GetArrayLength(env, javaArray); i) { arr[i] arr[i] * 2; // 直接操作内存 } (*env)-ReleaseIntArrayElements(env, javaArray, arr, 0);区域访问适合小范围操作jint buffer[10]; (*env)-GetIntArrayRegion(env, javaArray, 0, 10, buffer); // 处理buffer中的元素... (*env)-SetIntArrayRegion(env, javaArray, 0, 10, buffer);对象数组的特殊处理jclass stringClass (*env)-FindClass(env, java/lang/String); jobjectArray strArray (*env)-NewObjectArray(env, 10, stringClass, NULL); for (int i 0; i 10; i) { jstring str (*env)-NewStringUTF(env, Item ); (*env)-SetObjectArrayElement(env, strArray, i, str); (*env)-DeleteLocalRef(env, str); // 防止局部引用溢出 }经验对于频繁访问的大型数组优先使用GetPrimitiveArrayCritical/ReleasePrimitiveArrayCritical但在这对函数调用期间不能调用其他JNI函数或执行可能导致线程阻塞的操作。4. 异常处理与资源管理4.1 JNI异常处理机制JNI异常处理与Java异常机制有所不同。在JNI中调用Java方法时如果抛出异常控制权会返回到本地代码但异常不会自动传播到本地代码中。必须显式检查异常。关键异常处理函数// 检查是否发生异常 jthrowable ExceptionOccurred(JNIEnv *env); // 清除当前异常 void ExceptionClear(JNIEnv *env); // 抛出新异常 jint Throw(JNIEnv *env, jthrowable obj); jint ThrowNew(JNIEnv *env, jclass clazz, const char *message); // 检查异常是否正在发生 jboolean ExceptionCheck(JNIEnv *env);正确的异常处理模式jclass cls (*env)-FindClass(env, com/example/NonexistentClass); if ((*env)-ExceptionCheck(env)) { (*env)-ExceptionClear(env); // 执行备用方案或返回错误 } // 或者更详细的处理 jthrowable ex (*env)-ExceptionOccurred(env); if (ex ! NULL) { (*env)-ExceptionClear(env); // 获取异常信息 jclass exClass (*env)-GetObjectClass(env, ex); jmethodID getMessage (*env)-GetMethodID(env, exClass, getMessage, ()Ljava/lang/String;); jstring message (*env)-CallObjectMethod(env, ex, getMessage); const char* msgStr (*env)-GetStringUTFChars(env, message, NULL); logError(Java exception: %s, msgStr); (*env)-ReleaseStringUTFChars(env, message, msgStr); (*env)-DeleteLocalRef(env, ex); (*env)-DeleteLocalRef(env, exClass); (*env)-DeleteLocalRef(env, message); }4.2 本地引用管理JNI中的本地引用Local Reference在本地方法返回时会自动释放但在长时间运行的方法中如果不及时释放可能会导致本地引用表溢出。关键引用管理函数// 创建全局引用 jobject NewGlobalRef(JNIEnv *env, jobject obj); // 删除全局引用 void DeleteGlobalRef(JNIEnv *env, jobject globalRef); // 创建弱全局引用 jobject NewWeakGlobalRef(JNIEnv *env, jobject obj); // 删除弱全局引用 void DeleteWeakGlobalRef(JNIEnv *env, jobject obj); // 确保本地容量 jint EnsureLocalCapacity(JNIEnv *env, jint capacity);引用管理最佳实践对于需要长期持有的Java对象使用全局引用// 缓存常用的类和方法ID static jclass myClass; static jmethodID myMethod; JNIEXPORT void JNICALL Java_MyClass_init(JNIEnv *env, jclass clazz) { myClass (*env)-NewGlobalRef(env, clazz); myMethod (*env)-GetStaticMethodID(env, myClass, myMethod, ()V); } JNIEXPORT void JNICALL Java_MyClass_cleanup(JNIEnv *env, jclass clazz) { (*env)-DeleteGlobalRef(env, myClass); myClass NULL; myMethod NULL; }在循环中创建大量本地引用时使用Push/PopLocalFrame管理JNIEXPORT void JNICALL Java_MyClass_processArray(JNIEnv *env, jobject obj, jobjectArray array) { jsize length (*env)-GetArrayLength(env, array); // 为每次迭代预留足够的本地引用空间 if ((*env)-PushLocalFrame(env, 10) 0) { return; // 内存不足 } for (int i 0; i length; i) { jobject element (*env)-GetObjectArrayElement(env, array, i); // 处理element... // 不需要手动DeleteLocalRef因为PushLocalFrame会创建一个新的引用帧 } // 释放这一帧中的所有本地引用 (*env)-PopLocalFrame(env, NULL); }对于可能长时间运行的操作定期检查是否需要释放资源void processLongTask(JNIEnv *env) { for (int i 0; i 1000000; i) { jobject obj createTemporaryObject(env); // 使用obj... if (i % 1000 0) { (*env)-DeleteLocalRef(env, obj); // 可以在这里添加异常检查等其他管理逻辑 } } }重要提示在Android开发中JNI本地引用表默认容量较小512个更容易出现溢出。务必注意及时释放不再需要的本地引用。