简介：本示例展示了如何通过Java Native Interface（JNI）创建并返回对象数组到Java层。首先定义了一个包含基本属性和构造方法的Java类（如Person类）。接着编写C/C++代码，包括JNI函数原型的头文件以及实现创建并返回Person对象数组的函数。最后，在Java代码中通过JNI加载本地库并调用此方法，展示了如何在Java和本地代码之间传递复杂数据结构，从而扩展Java应用程序的功能。
1. JNI的定义和用途
1.1 JNI简介
Java Native Interface (JNI) 是一种编程接口，它使Java代码可以与用其他语言（主要是C和C++）编写的本地应用程序和库代码进行交互。JNI被广泛用于Java应用程序中，当需要执行性能敏感的操作或者直接访问平台特有的系统功能时。
1.2 设计目的
JNI的设计目的是为了保持Java的"一次编写，到处运行"的理念，同时允许开发者利用已经存在的本地代码库（比如，C/C++编写的老牌库），或者执行那些在Java虚拟机（JVM）上无法高效实现的操作。
1.3 应用场景
在Android开发中，JNI用于访问Android平台提供的API，以及优化性能密集型操作。在服务器端，JNI可以用来访问特定硬件资源或者调用性能更高的本地库。总之，JNI是实现Java代码与本地代码互操作的关键桥梁。
2. Java和C/C++代码交互方法
2.1 Java与本地代码的交互机制
在深入探讨Java和C/C++代码的交互机制之前，首先需要明确什么是本地代码。本地代码指的是用非Java语言（如C或C++）编写的代码，它们通常编译为动态链接库（在Windows上是.dll文件，在Unix/Linux系统中是.so文件）。Java通过JNI提供了一种机制，使得Java程序能够调用这些用其他语言编写的本地代码，同时也可以被本地代码调用。
2.1.1 Java Native Method的声明
本地方法在Java代码中以native关键字声明。声明时，本地方法不需要具体的实现体，通常以分号结束。例如，下面的Java类定义了一个本地方法 nativeMethod ：
public class NativeExample {
static {
System.loadLibrary("nativeLib"); // 加载包含本地方法实现的动态库
}
// 声明本地方法，返回类型是void，参数是String
public native void nativeMethod(String str);
}
2.1.2 Native Method的实现
本地方法的实现必须在C或C++代码中完成，并且需要遵循JNI的命名规则。例如，对于上面的Java类中的 nativeMethod ，其C语言实现可能如下：
#include <jni.h>
#include "NativeExample.h"
JNIEXPORT void JNICALL Java_NativeExample_nativeMethod
(JNIEnv *env, jobject obj, jstring str) {
const char *str_native = (*env)->GetStringUTFChars(env, str, 0);
// 实际的本地代码逻辑...
(*env)->ReleaseStringUTFChars(env, str, str_native);
}
2.2 Java Native Interface的调用过程
2.2.1 加载动态链接库
Java程序在调用本地方法之前，需要加载包含该本地方法实现的动态链接库。在Java代码中，通过 System.loadLibrary 或 System.load 方法加载库。动态链接库的名称（不包含前缀lib和后缀.so或.dll）将被传递给这个方法。
public class NativeExample {
static {
System.loadLibrary("nativeLib"); // 加载动态链接库
}
// ... 其他代码 ...
}
2.2.2 查找本地方法
在Java代码中声明了一个本地方法后，JVM会在加载的动态链接库中查找相应的方法。查找是通过JNI提供的 FindClass 和 GetMethodID 或 GetStaticMethodID 函数完成的。这些函数能够根据类名、方法名以及方法签名来定位特定的本地方法。
2.2.3 本地方法的调用和返回值处理
一旦本地方法被找到，JVM就会调用该方法，并且将Java层的参数转换为适合C/C++层处理的形式。调用完成后，本地方法必须将结果返回给Java层，这可能涉及将返回值从C/C++类型转换为Java类型。
2.3 交互过程中的错误处理和调试
2.3.1 常见错误和异常处理
在Java和本地代码的交互过程中，可能会遇到多种错误和异常情况，例如动态链接库加载失败、本地方法找不到、参数类型不匹配等。在实现本地代码时，必须妥善处理这些潜在错误，并确保及时向Java层抛出适当的异常。
2.3.2 调试本地代码的策略和工具
调试Java程序和C/C++代码的交互部分可能比较复杂，因为可能需要在两个不同的环境中跟踪问题。常用的调试工具包括GDB、Valgrind，以及集成开发环境（IDE）提供的调试器。此外，使用日志记录（如Java的 System.out.println 或C/C++中的 printf ）也可以帮助开发者追踪执行流程和状态信息。
通过本章的介绍，我们了解了Java与本地代码的交互机制、JNI的调用过程，以及在交互过程中错误处理和调试策略。下一章节，我们将探讨在JNI中创建和管理Java对象数组的详细步骤。
3. JNI中创建Java对象数组
3.1 JNI中对象数组的数据结构
3.1.1 对象数组在JNI中的表示
在JNI中，对象数组的表示与基本类型的数组不同。对象数组在本地代码中被表示为 jobjectArray 类型。 jobjectArray 是一个指向 JArray 结构的指针，该结构包含了指向实际Java对象的指针列表。
3.1.2 对象数组与基本类型数组的区别
基本类型的数组（如 int[] 或 float[]）在JNI中被表示为 jarray 类型，它们直接映射到特定的本地数据类型，如 jintArray 或 jfloatArray 。而对象数组需要额外的步骤来处理对象引用和垃圾回收。这是因为对象可能引用其他对象，管理这些引用比管理基本类型的数组复杂得多。
3.2 使用JNI创建和管理对象数组
3.2.1 创建对象数组的方法
在JNI中创建对象数组，你需要使用 env->NewObjectArray 方法。这个方法需要三个参数：数组的长度（一个 jsize 类型的值），数组中元素的类型（一个 jclass 类型的值），以及一个初始值。
jobjectArray CreateObjectArray(JNIEnv *env, jclass elementClass, int length, jobject initialValue) {
return env->NewObjectArray(length, elementClass, initialValue);
}
这个函数的逻辑非常直观：它创建了一个指定长度和类型的新对象数组，并用提供的初始值进行初始化。参数 elementClass 表示数组中元素的类， initialValue 是所有数组元素的初始值。
3.2.2 管理对象数组的生命周期
管理对象数组的生命周期包括两个重要方面：初始化和清理。初始化对象数组在创建时已经介绍，而清理则涉及到对象数组中的每个对象和对象数组本身。在JNI中，垃圾回收器会自动跟踪和释放本地引用指向的Java对象，但是需要显式释放对数组本身的本地引用。
void DeleteObjectArray(JNIEnv *env, jobjectArray array) {
env->DeleteLocalRef(array);
}
上述代码展示了如何释放对一个对象数组的本地引用。调用 DeleteLocalRef 函数可以释放这个引用，但不会影响Java层的数组对象本身。
3.2.3 对象数组中的元素操作
操作对象数组中的元素是通过JNI函数 SetObjectArrayElement 和 GetObjectArrayElement 完成的。这两个函数分别用于设置和获取数组元素的值。
void SetObjectArrayElementExample(JNIEnv *env, jobjectArray array, int index, jobject value) {
env->SetObjectArrayElement(array, index, value);
}
jobject GetObjectArrayElementExample(JNIEnv *env, jobjectArray array, int index) {
return env->GetObjectArrayElement(array, index);
}
SetObjectArrayElement 的参数包括对象数组的引用、要设置的元素的索引以及新值。而 GetObjectArrayElement 则返回特定索引处的元素。在使用这两个函数时需要注意异常处理，因为如果索引超出数组范围或者传入值与数组类型不匹配，它们会抛出 ArrayIndexOutOfBoundsException 和 IllegalArgumentException 。
3.3 实践中的对象数组操作
在实际开发中，创建和操作对象数组是一个常见且重要的操作。下面是几个与对象数组相关的实践场景和代码示例。
实践案例1：创建字符串对象数组
jobjectArray CreateStringArray(JNIEnv *env, int length) {
jclass stringClass = env->FindClass("Ljava/lang/String;");
jobjectArray stringArray = env->NewObjectArray(length, stringClass, NULL);
// 填充数组...
env->DeleteLocalRef(stringClass);
return stringArray;
}
这个函数创建了一个指定长度的字符串对象数组，并且初始化为空字符串。在实际应用中，你可以根据需要填充数组。
实践案例2：操作自定义对象的数组
jclass personClass = env->FindClass("Lcom/example/Person;");
jmethodID constructorId = env->GetMethodID(personClass, "<init>", "()V");
jobjectArray personArray = env->NewObjectArray(5, personClass, NULL);
for (int i = 0; i < 5; i++) {
jobject person = env->NewObject(personClass, constructorId);
// 设置person对象的属性...
env->SetObjectArrayElement(personArray, i, person);
}
// 使用完后清理
env->DeleteLocalRef(personClass);
这个例子展示了如何操作自定义对象类型的数组。首先找到自定义类 Person 的引用，然后创建该类的对象数组，接着通过循环创建对象并设置属性，最后将对象放置到数组中。在使用完毕后，记得清理掉局部引用。
通过这些示例，我们可以看到在JNI中创建和管理对象数组的全过程，从创建数组，到填充数组，以及最终释放不再需要的资源。这不仅要求对JNI的API有充分的理解，还需要对Java和C++语言的特性有深刻的认识。
4. JNI返回对象数组到Java层的完整流程
4.1 对象数组的传递机制
4.1.1 从Java到本地方法的参数传递
在JNI中，当Java代码调用本地方法时，Java对象可以作为参数传递给本地代码。这些对象在传递时会被自动转换为相应的本地引用。在本地方法中，这些引用被当作指向Java对象的指针使用。要注意的是，通过JNI传递的对象引用在本地代码中应当被视作只读，若需要修改对象内容，应当通过JNI提供的接口进行。
public native void nativeMethod(Object[] objects);
在Java代码中声明本地方法后，当调用此方法时，传递的对象数组 objects 会在本地方法中以 jobjectArray 的形式存在。
4.1.2 从本地方法返回到Java的对象数组
要从本地方法返回一个Java对象数组到Java层，需要使用 NewObjectArray 函数创建一个新的Java数组，并用 SetObjectArrayElement 函数填充数组内容。然后，此新创建的数组引用将被返回到Java层。
jobjectArray nativeCreateObjectArray(JNIEnv *env) {
// 假设我们要创建一个包含3个字符串的数组
jstring jstr;
jobjectArray jarray = (*env)->NewObjectArray(env, 3, (*env)->FindClass(env, "java/lang/String"), 0);
// 创建字符串对象填充到数组中
jstr = (*env)->NewStringUTF(env, "Hello");
(*env)->SetObjectArrayElement(env, jarray, 0, jstr);
jstr = (*env)->NewStringUTF(env, "JNI");
(*env)->SetObjectArrayElement(env, jarray, 1, jstr);
jstr = (*env)->NewStringUTF(env, "Array");
(*env)->SetObjectArrayElement(env, jarray, 2, jstr);
return jarray;
}
在Java层，该方法将返回一个填充好的字符串数组：
Object[] resultArray = nativeCreateObjectArray();
4.2 返回数组的内存管理
4.2.1 本地代码中的内存分配和释放
在JNI中，当从本地代码返回Java对象数组时，你必须管理在本地代码中创建的任何内存。特别是对于对象数组，每个Java对象也由本地代码管理时，需要确保这些对象也被适当地处理。通常，如果你在本地方法中分配了内存，你也需要在不再使用时释放这些内存。
(*env)->ReleaseStringUTFChars(env, jstr, chars);
(*env)->DeleteLocalRef(env, jarray);
4.2.2 Java垃圾回收机制与本地内存的交互
当Java对象在本地代码中不再需要时，可以通过JNI提供的方法释放对应的本地引用。然而，即便本地引用被释放，Java垃圾回收器并不会自动清理Java对象，除非所有Java引用都被清除。JNI提供了多种函数来管理本地引用的生命周期。
(*env)->DeleteLocalRef(env, jarray);
4.3 实践案例分析
4.3.1 案例背景和需求分析
假设有一个Java类，需要从本地方法返回一个较大的对象数组，以减少频繁的Java和本地方法间的调用开销。这个对象数组由一系列复杂对象构成，每个对象都需要在本地代码中创建并初始化。
4.3.2 代码实现和关键点解析
在本地方法实现时，需要按照以下步骤来创建并返回对象数组：
- 创建本地方法的C/C++实现，创建对象数组。
- 在创建对象数组时，确保为每个对象分配内存，并进行适当的初始化。
- 在数组被Java层接收后，确保释放本地内存和引用，以避免内存泄漏。
#include <jni.h>
#include <string.h>
JNIEXPORT jobjectArray JNICALL
Java_MainClass_nativeCreateLargeObjectArray(JNIEnv *env, jclass cls) {
jclass stringClass = (*env)->FindClass(env, "java/lang/String");
jmethodID stringConstructor = (*env)->GetMethodID(env, stringClass, "<init>", "([BLjava/lang/String;)V");
// 创建字符串数组
jobjectArray strArray = (*env)->NewObjectArray(env, 10, stringClass, NULL);
// 填充字符串数组
jstring tempStr = (*env)->NewStringUTF(env, "temp");
for (int i = 0; i < 10; i++) {
jbyteArray byteArray = (*env)->NewByteArray(env, 5);
jbyte arrayData[5] = {1, 2, 3, 4, 5};
(*env)->SetByteArrayRegion(env, byteArray, 0, 5, arrayData);
jobject element = (*env)->NewObject(env, stringClass, stringConstructor, byteArray, tempStr);
(*env)->SetObjectArrayElement(env, strArray, i, element);
(*env)->DeleteLocalRef(env, byteArray);
(*env)->DeleteLocalRef(env, element);
}
return strArray;
}
在Java层，可以通过如下方式调用该本地方法并获取返回的对象数组：
Object[] array = nativeCreateLargeObjectArray();
通过本章节的介绍，我们分析了从JNI返回对象数组到Java层的完整流程，涵盖了对象数组的传递机制、内存管理以及具体的实践案例分析。通过展示JNI方法的代码实现与关键步骤，可以帮助开发者在实践中更好地理解和应用JNI进行高效、安全的数据交互。
5. JNI中引用Java类和方法的获取
在Java程序与本地代码交互的过程中，经常需要获取Java类的引用以及调用Java类中的方法。JNI 提供了一系列函数和方法来执行这些操作，本章将详细介绍在JNI中如何查找Java类和方法，以及引用管理和异常处理的策略。
5.1 在JNI中查找Java类
在JNI中查找Java类是交互的第一步，这涉及到将Java中的类名转换为本地代码中的类引用。
5.1.1 通过类名查找Java类
在JNI中，我们可以通过Java虚拟机接口 FindClass 来根据类名查找对应的类。例如，如果我们想获取 java.lang.String 类的引用，我们可以如下操作：
jclass strClass = env->FindClass("java/lang/String");
if (strClass == NULL) {
// 处理异常，比如抛出找不到类的情况
}
5.1.2 获取类对象的引用
得到类的引用后，我们可以通过类引用访问类的各种属性和方法。要获取类对象的引用，我们使用 GetObjectClass 函数：
jclass classClass = env->GetObjectClass(strClass);
5.2 在JNI中查找Java方法
在找到Java类之后，我们可能需要在该类中查找特定的方法以供调用。
5.2.1 根据方法签名查找方法ID
JNI使用方法签名来区分具有相同名称但参数类型不同的方法。我们首先需要使用 GetSigleton 函数获取方法签名：
jstring sig = env->NewStringUTF("<init>(Ljava/lang/String;)V");
jmethodID constructor = env->GetMethodID(strClass, "<init>", sig);
5.2.2 调用Java方法
一旦有了方法ID，就可以调用该方法了。调用方法需要指定方法ID以及传递给方法的参数：
jstring javaString = env->NewStringUTF("HelloJNI");
jobject strObject = env->NewObject(strClass, constructor, javaString);
这里我们创建了一个 String 对象。
5.3 JNI中引用管理和异常处理
在JNI编程中，引用管理和异常处理是关键部分，因为它们确保了本地代码和Java代码之间可以正确地交互。
5.3.1 引用的创建和释放
JNI 提供了几种类型的引用：局部引用、全局引用和弱全局引用。局部引用在Java方法调用期间有效，全局引用可以跨多个方法调用而保持有效，弱全局引用可以被垃圾回收器回收。创建和释放引用的示例代码如下：
jclass localClassRef = env->FindClass("java/lang/String");
jclass globalClassRef = (jclass)env->NewGlobalRef(localClassRef);
// 使用全局引用...
env->DeleteGlobalRef(globalClassRef); // 释放全局引用
5.3.2 异常处理机制和策略
在JNI中，任何可能导致Java异常的操作都需要处理异常。我们可以通过检查 JNI 返回值来判断是否发生了异常，或者使用 ExceptionCheck 检查异常状态：
if (env->ExceptionCheck()) {
// 处理异常
}
还需要注意的是，异常不能在Java和C++之间传播，需要在本地代码中捕获并处理。
本章提供了JNI中引用Java类和方法查找的基本方法，并对引用管理和异常处理机制进行了说明。在实际应用中，要对这些内容有充分的了解和熟练的运用，才能确保程序的健壮性和效率。
在下一章，我们将探讨JNI环境的设置与管理，这将帮助开发者在更深层次上理解和利用JNI。
简介：本示例展示了如何通过Java Native Interface（JNI）创建并返回对象数组到Java层。首先定义了一个包含基本属性和构造方法的Java类（如Person类）。接着编写C/C++代码，包括JNI函数原型的头文件以及实现创建并返回Person对象数组的函数。最后，在Java代码中通过JNI加载本地库并调用此方法，展示了如何在Java和本地代码之间传递复杂数据结构，从而扩展Java应用程序的功能。
扫一扫
510
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
