JNI API详解：本地接口指南

"JNI (Java Native Interface) API 是 Java 平台中用于实现 Java 代码与本地（非 Java）代码交互的一组接口和工具。它允许开发者在 Java 应用程序中嵌入 C/C++ 代码，或者调用已有的本地库。这个接口提供了丰富的功能，包括类操作、异常处理、全局和局部引用管理、对象操作、访问对象的域、调用实例和静态方法、字符串以及数组操作等。" JNI API 的主要知识点包括： 1. 版本信息：`GetVersion` 函数用于获取当前 JNI 版本，帮助开发者确定所使用的 JNI 功能是否兼容。 2. 类操作： - `DefineClass`：用于在 JVM 中定义一个新的类。 - `FindClass`：查找指定的 Java 类。 - `GetSuperclass`：获取给定类的超类。 - `IsAssignableFrom`：检查一个类是否可以被赋值给另一个类或接口。 3. 异常处理： - `Throw`：抛出一个本地异常。 - `ThrowNew`：创建并抛出一个新的异常。 - `ExceptionOccurred`：检查是否有未处理的异常。 - `ExceptionDescribe`：打印异常的详细信息。 - `ExceptionClear`：清除当前的异常。 - `FatalError`：报告致命错误并终止 JVM。 4. 引用管理： - `NewGlobalRef`：创建一个全局引用，使得引用的对象在本地方法的整个生命周期内都保持活跃。 - `DeleteGlobalRef`：删除全局引用，释放相关内存。 - `DeleteLocalRef`：删除局部引用，通常在本地方法返回后执行，以优化内存管理。 5. 对象操作： - `AllocObject`：无参数地创建一个类的新实例。 - `NewObject`, `NewObjectA`, `NewObjectV`：创建一个类的新实例，并调用构造函数。 - `GetObjectClass`：获取给定对象的类。 - `IsInstanceOf`：检查对象是否是特定类或其子类的实例。 - `IsSameObject`：比较两个对象是否是同一个实例。 6. 访问对象的域： - `GetFieldID`：获取字段标识符，用于访问或修改对象的字段。 - `Get<type>Field` 和 `Set<type>Field` 例程：分别用于读取和设置对象的字段值，如 `GetIntField`, `SetBooleanField` 等。 7. 调用实例方法： - `GetMethodID`：获取方法的 ID。 - `Call<type>Method` 例程：调用对象的方法，如 `CallVoidMethod`, `CallIntMethod` 等。 - `Call<type>MethodA` 和 `Call<type>MethodV` 例程：变种方法，用于传递数组参数。 8. 非虚拟方法调用： - `CallNonvirtual<type>Method` 例程：调用对象的非虚拟方法，即直接调用对象的特定实现，而不是其超类的实现。 9. 访问静态域： - `GetStaticFieldID`：获取静态字段的标识符。 - `GetStatic<type>Field` 和 `SetStatic<type>Field` 例程：读取或设置类的静态字段值。 10. 调用静态方法： - `GetStaticMethodID`：获取静态方法的 ID。 - `CallStatic<type>Method` 例程：调用类的静态方法。 - `CallStatic<type>MethodA` 和 `CallStatic<type>MethodV` 例程：类似地，用于传递数组参数。 11. 字符串操作： - `NewString`：创建一个包含给定字符序列的新字符串。 - `GetStringLength`：获取字符串的长度。 - `GetStringChars` 和 `ReleaseStringChars`：获取字符串的字符数组，并在使用完毕后释放。 - `NewStringUTF`、`GetStringUTFLength`、`GetStringUTFChars` 和 `ReleaseStringUTFChars`：处理 UTF-8 编码的字符串。 12. 数组操作： - `GetArrayLength`：获取数组的长度。 - `NewObjectArray`：创建一个对象数组。 - 其他数组相关的函数如 `Get<type>ArrayElements`、`Release<type>ArrayElements`、`Set<type>ArrayRegion` 等用于操作数组元素。 通过这些 API，开发者可以在 Java 程序中灵活地集成本地代码，实现高性能计算、利用硬件特性、调用系统库等功能，同时保持跨平台的兼容性。