JNI开发

已于 2024-08-04 14:00:18 修改
阅读量590 收藏 14
点赞数 11
分类专栏： Java 文章标签： java
于 2024-08-04 13:28:06 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_34358193/article/details/140905157
版权

1、JNI静态与动态注册

在Java Native Interface (JNI) 中，注册指的是将Java方法与其本地实现进行关联。JNI提供了两种主要的注册方式：静态注册和动态注册。这两种方式各有优缺点和使用场景。下面对这两种注册方式进行详细说明。

1. 静态注册 (Static Registration)

定义

静态注册是指通过JNI生成的头文件中的函数名称来实现Java方法与本地实现的绑定。函数名称遵循特定的命名规则，以确保Java虚拟机能够正确地找到对应的本地实现。

特点

  • 命名约定：本地函数的名称必须遵循特定的命名规则：Java_类全限定名_方法名。
  • 代码自动生成：使用javac -h或javah工具时，会自动生成带有正确函数名称的头文件。
  • 简单易用：对于大多数应用场景来说，静态注册足够且容易实现。

实现步骤

  1. 编写Java代码，声明本地方法。
  2. 使用javac -h或javah生成头文件。头文件中包含了本地方法的函数声明。
  3. 在本地代码中实现头文件中声明的函数。

示例

Java类：

public class Example {
    public native void sayHello();

    static {
        System.loadLibrary("example");
    }
}

生成头文件：

javac Example.java
javac -h . Example.java

头文件 (Example.h)：

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class Example */

#ifndef _Included_Example
#define _Included_Example
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     Example
 * Method:    sayHello
 * Signature: ()V
 */
JNIEXPORT void JNICALL Java_Example_sayHello
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

本地实现 (Example.c)：

#include <jni.h>
#include "Example.h"
#include <stdio.h>

JNIEXPORT void JNICALL Java_Example_sayHello(JNIEnv *env, jobject obj) {
    printf("Hello from native code!\n");
}

在此示例中，函数 Java_Example_sayHello 的名称是按照静态注册的命名规则定义的。Java虚拟机通过这种命名约定将Java代码中的本地方法与C/C++实现联系起来。

2. 动态注册 (Dynamic Registration)

定义

动态注册允许开发者在本地库加载时，以编程的方式将Java方法与本地实现关联。与静态注册不同，动态注册不要求本地函数名遵循特定命名规则。

特点

  • 灵活性：不依赖于固定的命名规则，开发者可以自行决定函数名称。
  • 集中管理：所有的注册都可以集中在一个地方进行，便于管理。
  • 复杂性：实现比静态注册复杂，需要编写额外的注册代码。

实现步骤

  1. 编写Java代码，声明本地方法。
  2. 实现JNI_OnLoad函数，并在其中使用JNIEnv的RegisterNatives方法注册本地方法。
  3. 在本地代码中定义本地方法实现。

示例

Java类：

public class Example {
    public native void sayHello();

    static {
        System.loadLibrary("example");
    }
}

本地实现 (Example.c)：

#include <jni.h>
#include <stdio.h>

// 本地方法的实现
void nativeSayHello(JNIEnv *env, jobject obj) {
    printf("Hello from native code (dynamic registration)!\n");
}

// 方法表，包含Java方法名、签名以及对应的本地函数指针
static JNINativeMethod method_table[] = {
    {"sayHello", "()V", (void *) nativeSayHello}
};

// 在库加载时注册本地方法
JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM *vm, void *reserved) {
    JNIEnv *env;
    if ((*vm)->GetEnv(vm, (void **) &env, JNI_VERSION_1_6) != JNI_OK) {
        return JNI_ERR; // 加载失败
    }

    jclass cls = (*env)->FindClass(env, "Example");
    if (cls == NULL) {
        return JNI_ERR;
    }

    // 注册本地方法
    if ((*env)->RegisterNatives(env, cls, method_table, sizeof(method_table) / sizeof(method_table[0])) < 0) {
        return JNI_ERR;
    }

    return JNI_VERSION_1_6;
}

在这个例子中，nativeSayHello 是本地方法的实现，它并没有遵循静态注册的命名规则。相反，我们在 JNI_OnLoad 函数中，使用 RegisterNatives 函数将 sayHello 方法与 nativeSayHello 进行关联。

3. 动态与静态注册的比较

  • 静态注册：

    • 优点：简单易用，不需要额外的注册代码。
    • 缺点：受限于命名规则，不够灵活。

  • 动态注册：

    • 优点：灵活性更高，不依赖于特定的命名规则。可以集中管理注册过程，方便维护。
    • 缺点：需要额外的代码实现注册，复杂度较高。

4. 选择使用场景

  • 静态注册：适合简单的JNI应用，方法较少且无需动态特性时。
  • 动态注册：适合复杂应用场景，特别是需要动态加载类或者方法名不固定时。

动态注册可以提供更大的灵活性，尤其是在需要动态加载或运行时确定的方法时。然而，静态注册通常足以满足大多数常见的应用场景，并且实现起来更简单。开发者可以根据具体需求选择合适的注册方式。

2、方法签名、与Java通信

在JNI中，方法签名和与Java通信是重要的概念。方法签名用于识别Java方法的参数和返回类型，而与Java通信涉及到在Java和本地代码之间传递数据和调用方法。下面将详细说明这些内容。

方法签名

方法签名是在JNI中用于唯一标识一个方法的字符串表示形式。它包括方法参数类型和返回类型的信息。方法签名对于JNI至关重要，因为它帮助JNI确定如何在本地代码和Java代码之间进行正确的数据转换。

1. 基本规则

方法签名的格式如下：

(参数类型签名)返回类型签名
  • 参数类型签名：由方法的所有参数类型的签名组成。
  • 返回类型签名：由返回类型的签名组成。
2. 常用类型签名

  • 基本类型：

    • Z：boolean
    • B：byte
    • C：char
    • S：short
    • I：int
    • J：long
    • F：float
    • D：double
    • V：void（仅用于返回类型）

  • 引用类型：

    • L类全限定名;：类的类型。例如，Ljava/lang/String; 表示 java.lang.String。
    • [类型签名：数组类型。例如，[I 表示 int[]。
3. 示例
  • void method(int a, String b)的签名为(ILjava/lang/String;)V
  • String[] method(byte[] data)的签名为([B)[Ljava/lang/String;

与Java通信

与Java通信涉及在本地代码中调用Java方法、访问Java字段，以及处理Java对象和数据结构。以下是几种主要的通信方式：

1. 调用Java方法

本地代码可以调用Java对象的方法。为此，你需要：

1.	获取Java类：通过JNIEnv的FindClass方法获取Java类的jclass对象。
2.	获取方法ID：使用GetMethodID方法获取要调用的方法的ID。
3.	调用方法：使用Call<Type>Method系列函数调用Java方法。

示例：

假设我们有一个Java类Example，它有一个方法public void callMe(String message)。

public class Example {
    public void callMe(String message) {
        System.out.println("Message from JNI: " + message);
    }
}

本地代码：

JNIEnv *env;
jobject obj; // Java对象

// 获取Example类
jclass cls = (*env)->GetObjectClass(env, obj);

// 获取callMe方法ID
jmethodID mid = (*env)->GetMethodID(env, cls, "callMe", "(Ljava/lang/String;)V");

if (mid == NULL) {
    return; // 方法未找到
}

// 创建Java字符串
jstring jstr = (*env)->NewStringUTF(env, "Hello from native code!");

// 调用Java方法
(*env)->CallVoidMethod(env, obj, mid, jstr);
2. 访问Java字段

本地代码可以读取和修改Java对象的字段值。
步骤

1.	获取Java类：通过FindClass方法获取Java类的jclass对象。
2.	获取字段ID：使用GetFieldID（实例字段）或GetStaticFieldID（静态字段）方法获取字段的ID。
3.	访问字段值：使用Get<Type>Field（读取字段）和Set<Type>Field（设置字段）系列方法操作字段。

示例：

public class Example {
    public int value;
}

本地代码：

jfieldID fid = (*env)->GetFieldID(env, cls, "value", "I");

if (fid == NULL) {
    return; // 字段未找到
}

// 获取字段值
jint value = (*env)->GetIntField(env, obj, fid);

// 设置字段值
(*env)->SetIntField(env, obj, fid, value + 1);
3. 处理Java数组

JNI提供了一系列函数用于操作Java数组，例如创建数组、获取和设置数组元素等。
步骤

1.	获取数组类型：使用New<Type>Array方法创建数组。
2.	访问和修改元素：使用Get<Type>ArrayElements和Set<Type>ArrayElements方法操作数组元素。
3.	释放数组：使用Release<Type>ArrayElements释放数组元素。

示例：

public class Example {
    public int[] numbers;
}

本地代码：

// 获取字段ID
jfieldID fid = (*env)->GetFieldID(env, cls, "numbers", "[I");

// 获取数组对象
jintArray arr = (*env)->GetObjectField(env, obj, fid);

// 获取数组长度
jsize length = (*env)->GetArrayLength(env, arr);

// 获取数组元素
jint *elements = (*env)->GetIntArrayElements(env, arr, NULL);

// 处理数组元素
for (int i = 0; i < length; i++) {
    elements[i] += 1; // 每个元素加1
}

// 释放数组
(*env)->ReleaseIntArrayElements(env, arr, elements, 0);
4. 异常处理

本地代码可以检查是否有Java异常发生，并可以从本地代码抛出Java异常。

检查异常：

if ((*env)->ExceptionCheck(env)) {
    // 处理异常
    (*env)->ExceptionDescribe(env);
    (*env)->ExceptionClear(env);
}

抛出异常：

jclass exceptionCls = (*env)->FindClass(env, "java/lang/Exception");
if (exceptionCls != NULL) {
    (*env)->ThrowNew(env, exceptionCls, "Error message from native code.");
}
5. 处理Java字符串

本地代码中常常需要处理Java字符串。可以使用GetStringUTFChars将Java字符串转换为C字符串，并在处理后释放资源。

示例：

jstring javaString = ...;
const char *cString = (*env)->GetStringUTFChars(env, javaString, NULL);

// 使用cString

(*env)->ReleaseStringUTFChars(env, javaString, cString);

总结

在JNI中，方法签名是用于描述Java方法参数和返回类型的字符串，与Java通信则包括调用Java方法、访问Java字段、处理Java数组、异常处理和字符串操作等方面。这些机制使得本地代码可以与Java代码进行有效的交互，实现复杂的功能。

3、本地引用与全局引用

在JNI（Java Native Interface）中，本地引用（Local References）和全局引用（Global References）是两种管理Java对象的引用类型。它们的主要区别在于生命周期和使用场景。理解它们的区别对于有效管理内存和避免内存泄漏至关重要。

1. 本地引用 (Local References)

定义

本地引用是在JNI中本地方法调用期间创建的Java对象的引用。这些引用在本地方法返回后自动失效，由JVM自动管理和释放。

特点

  • 生命周期短：本地引用仅在本地方法的执行期间有效，一旦方法返回，引用即被释放。
  • 自动管理：JVM自动管理本地引用的生命周期，因此不需要显式释放。
  • 数量有限：JVM对本地引用的数量有限制（通常是每个线程最多16个本地引用）。如果超过这个限制，会导致OutOfMemoryError。
  • 适用场景：适用于本地方法内临时使用的Java对象。

示例

JNIEXPORT void JNICALL Java_SomeClass_nativeMethod(JNIEnv *env, jobject obj) {
    // 创建一个本地引用
    jstring localStr = (*env)->NewStringUTF(env, "Hello, JNI!");

    // 使用 localStr ...

    // 当 nativeMethod 返回时，localStr 变得无效，不需要显式释放
}

在这个示例中，localStr是一个本地引用，它在nativeMethod调用期间有效。一旦nativeMethod返回，localStr引用的Java对象会被JVM自动回收。

2. 全局引用 (Global References)

定义

全局引用是在本地代码中创建的，可以在多个本地方法中共享，且在显式删除前一直有效。全局引用的生命周期可以跨越多个本地方法调用。

特点

  • 生命周期长：全局引用在显式删除前一直有效，不会因本地方法返回而失效。
  • 显式管理：需要通过JNI函数手动创建和删除全局引用。
  • 不受限制：与本地引用不同，全局引用的数量不受JVM的默认限制，但过多使用全局引用会导致内存消耗增加。
  • 适用场景：适用于在多个本地方法或跨线程使用的Java对象，或者需要在Java和本地代码之间保持长期引用的情况。

创建和删除全局引用

  • 创建全局引用：使用NewGlobalRef方法。
  • 删除全局引用：使用DeleteGlobalRef方法。

示例

jobject globalRef;

JNIEXPORT void JNICALL Java_SomeClass_createGlobalRef(JNIEnv *env, jobject obj) {
    // 创建一个全局引用
    globalRef = (*env)->NewGlobalRef(env, obj);
}

JNIEXPORT void JNICALL Java_SomeClass_useGlobalRef(JNIEnv *env, jobject obj) {
    // 使用全局引用
    if (globalRef != NULL) {
        // 使用 globalRef ...
    }
}

JNIEXPORT void JNICALL Java_SomeClass_deleteGlobalRef(JNIEnv *env, jobject obj) {
    // 删除全局引用
    if (globalRef != NULL) {
        (*env)->DeleteGlobalRef(env, globalRef);
        globalRef = NULL;
    }
}

在这个示例中，globalRef是一个全局引用。通过Java_SomeClass_createGlobalRef创建全局引用，可以在后续的本地方法Java_SomeClass_useGlobalRef中使用。最后，通过Java_SomeClass_deleteGlobalRef删除全局引用，以避免内存泄漏。

3. 选择与使用建议

选择使用场景

  • 本地引用：适用于本地方法内的临时对象和局部操作，不需要显式释放，JVM会自动处理。
  • 全局引用：适用于需要在多个本地方法之间共享或保持对象引用的情况。由于生命周期较长，使用后必须显式删除以防止内存泄漏。

使用建议

  1. 避免滥用全局引用：全局引用不受数量限制，但过多的全局引用会导致内存使用增加，应合理使用。
  2. 及时删除全局引用：在不再需要全局引用时，应显式删除，以释放内存资源。
  3. 注意线程安全：全局引用可以跨线程使用，在多线程环境中应注意线程安全问题。
  4. 检查引用是否有效：在使用引用前，确保引用有效（例如全局引用未被删除）。

通过合理使用本地引用和全局引用，可以在JNI中有效地管理Java对象的生命周期和内存使用，避免内存泄漏和其他潜在问题。

榴月~
关注
专栏目录
JNI动态注册
07-23
本代码主要是一个RegisterNatives的运用，让你对jni有一个新的认识
android_jni开发文档.rar
09-07
周工的"android_jni开发文档"应该详细介绍了使用JNI进行Android开发的过程。 JNI开发流程主要包括以下几个步骤： 1. **创建本地方法接口**：在Java源代码中定义一个本地方法，使用`native`关键字标记。这个方法...
Android JNI静态注册和动态注册方法详解
最新发布
wenzhi的博客
03-14 1736
这里的JNI静态方式注册方法和JNI的static方法是没有关系的。本文主要介绍jni.cpp代码中动态注册方法的讲解。很多人对这块知识还是比较陌生的，什么是静态注册？什么是动态注册？有些人可能都不清楚。JNI静态注册和动态注册是哪里的代码？什么时候使用静态注册？什么时候使用动态注册？为什么呢？其实一般情况用不到动态注册，但是复杂JNI项目或者系统源码中可能会用到动态注册。特别是系统源码中基本都是用的动态注册的形式，注册JNI方法，所以是有必要进行学习的。
动态注册JNI
热门推荐
chenfeng0104的专栏
12-20 1万+
在在纯java中使用JNI文章中可以看到，java的native方法与C/C++代码函数是通过Java___这种方式对应的，即它是静态注册的。当需要使用现有的C/C++代码函数时，需要以这种形式定义包装函数，在包装函数中调用现有C/C++代码函数；而且这样的函数名也非常长，不适合管理。使用动态注册，可以不受上述命名的限制。 运行下面示例需要安装NDK及搭建环境，请看另一篇文章使用NDK与环境搭建
JNI 动态注册
simplepeng的博客
11-11 354
public class MainActivity extends AppCompatActivity { // 加载so static { System.loadLibrary("native-lib"); } @Override protected void onCreate(Bundle savedInstanceState) {
android JNI开发演示（串口收发）
07-02
在这个"android JNI开发演示（串口收发）"项目中，我们将关注如何利用JNI实现Android设备上的串口通信。 串口通信是设备间数据传输的一种常见方式，常用于嵌入式系统和物联网应用。在Android平台上，由于操作系统对...
jni开发demo
04-10
首先，我们需要理解Android Studio与Eclipse在JNI开发上的差异。虽然Android Studio已经取代Eclipse成为主流的Android开发工具，但Eclipse仍然有其独特的NDK支持。在Android Studio中，我们可以直接在项目中配置C/...
JNI开发步骤
01-10
JNI 开发步骤详解 JNI（Java Native Interface）是 Java 语言访问本地代码的接口，允许 Java 应用程序与本地代码进行交互。下面是 JNI 开发的详细步骤： Step 1：环境搭建 首先，需要安装 Cygwin 和 Android NDK...
jni动态注册
11-13
android jni方法动态注册。。。C++的
android stadio jni动态注册函数
04-06
JNI静态函数注册，根据Java+packname+method来实现的，名称过长，需要JNI开始时去遍历查找，比较麻烦！这个例子用了动态注册方式。当JAVA层通过System.loadLibrary加载完JNI动态库后，紧接着会查找该库中一个叫JNI_OnLoad 的函数。如果有，就调用它，而动态注册的工作就是在这里完成的。
JNI技术之动态注册
Danny_llp的博客
09-29 2406
JNI技术之动态注册 一.静态注册的缺点 1.C/C++实现的函数名，必须通过javah工具生成对应的C/C++的头文件。 2.初次调用native函数时，采用的是在动态库中寻找，如果native函数较多的话，效率比较低下的。 ...
七、JNI动态注册
怪蜀黍
08-03 247
JNI的静态注册就是Javah生成头文件，本章第一篇已经讲过，现在我们来讲讲第二种方式,JNI动态注册。首先是module的build.gradle: android { compileSdkVersion 30 buildToolsVersion "30.0.3" defaultConfig { applicationId "com.jhzl.a7_jni_2way" minSdkVersion 21 targetSdkVersio
JNI静态注册与动态注册
u012944685的专栏
04-16 4388
导读 我们知道通过Java通过JNI可以调用C/C++代码，C/C++也可以通过JNI调用java代码，那么JNI是怎么将Java方法与Native的方法对应起来的呢？ JVM查找Native方法有两种方式： 1、按照JNI规范的命名规则进行查找，这种方式叫静态注册。 2、调用JNI提供的RegisterNatives函数，将本地函数注册到JVM中，这种方式叫动态注册。 静态注册 所谓静态注册就是按照JNI规范书写函数名： java_类路径_方法名（路径用下划线分隔） 当我们使用Android Stud
JNI开发入门教程
"JNI开发简单实例 - 一个关于在Android平台上使用JNI的文档，由Jurij Smakov编写，涵盖了从接口定义到库构建的全过程。" JNI（Java Native Interface）是Java平台的一部分，允许Java代码与其他语言编写的代码进行...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值