使用 loadLibrary() 方法加载 JNI 本机库

2023-11-23 10:14:42

Java Native Interface (JNI) 允许 Java 代码与用其他语言（例如 C 或 C++）编写的本机库交互。这可以通过使用 System.loadLibrary() 方法加载本机库来实现。

在本文中，我们将介绍如何使用 System.loadLibrary() 方法加载 JNI 本机库。我们将首先介绍 JNI 的基础知识，然后逐步介绍如何使用 System.loadLibrary() 方法加载本机库。最后，我们将提供一些示例代码，帮助您更好地理解如何使用 System.loadLibrary() 方法。

1. JNI 基础知识

JNI 是 Java Native Interface 的缩写，它允许 Java 代码与用其他语言（例如 C 或 C++）编写的本机库交互。JNI 是一种平台无关的 API，这意味着它可以在任何支持 Java 的平台上使用。

2. 使用 System.loadLibrary() 方法加载本机库

要使用 System.loadLibrary() 方法加载本机库，您需要执行以下步骤：

首先，您需要创建一个本机库。本机库可以是用 C 或 C++ 编写的。
然后，您需要将本机库复制到 Java 应用程序的类路径中。
最后，您可以在 Java 代码中使用 System.loadLibrary() 方法加载本机库。

下面是一个示例代码，演示了如何使用 System.loadLibrary() 方法加载本机库：

// 加载本机库
System.loadLibrary("hello");

// 调用本机库中的函数
hello();

我们来举一个更实际的例子，假定我们有一个本机库，名为 "helloJNI"，它包含一个函数 helloJNI(), 该函数用于打印出 "Hello JNI"。这个库的声明和实现分别如下：

头文件: helloJNI.h

#include <jni.h>

JNIEXPORT void JNICALL Java_com_example_hellonative_HelloJNILib_helloJNI(JNIEnv *env, jobject obj);

实现文件: helloJNI.c

#include "helloJNI.h"

JNIEXPORT void JNICALL Java_com_example_hellonative_HelloJNILib_helloJNI(JNIEnv *env, jobject obj) {
    printf("Hello JNI!\n");
}

为了在 Java 代码中使用这个本机库，我们需要完成以下步骤：

将 helloJNI.h 和 helloJNI.c 文件复制到某个目录（如，/home/my_project/jni/helloJNI）。
编译 helloJNI.c 文件，生成 .so 文件。在 Linux 系统上，可以使用以下命令：

gcc -shared -fPIC -I/opt/android-sdk/ndk-bundle/platforms/android-21/arch-arm/include -I/opt/android-sdk/ndk-bundle/platforms/android-21/arch-arm/usr/include -L/opt/android-sdk/ndk-bundle/platforms/android-21/arch-arm/lib helloJNI.c -o helloJNI.so

将生成的 helloJNI.so 文件复制到 Java 应用程序的类路径中。例如，如果您的 Java 应用程序位于 /home/my_project/java/helloJNI，您可以将 helloJNI.so 文件复制到 /home/my_project/java/helloJNI/lib/ 目录下。
在 Java 代码中，使用 System.loadLibrary() 方法加载本机库：

System.loadLibrary("helloJNI");

调用本机库中的函数：

HelloJNILib.helloJNI();

当您运行 Java 应用程序时，您将看到 "Hello JNI!" 的输出。

使用 System.loadLibrary() 方法加载本机库的详细步骤如下：

确定要加载的本机库的名称。 本机库的名称通常以 "lib" 开头，后跟库的名称。例如，如果您要加载名为 "hello" 的本机库，则本机库的名称为 "libhello.so"。
将本机库复制到 Java 应用程序的类路径中。 本机库的类路径是 Java 虚拟机 (JVM) 搜索类和本机库的目录列表。您可以通过设置 CLASSPATH 环境变量或使用 System.getProperty("java.library.path") 方法来设置本机库的类路径。
使用 System.loadLibrary() 方法加载本机库。 System.loadLibrary() 方法接受一个参数，即要加载的本机库的名称。例如，以下代码将加载名为 "hello" 的本机库：