NDK(三)：JNIEnv解析

已于 2023-03-31 10:41:34 修改
阅读量886 收藏 1
点赞数
分类专栏： NDK 文章标签： java c++
于 2023-03-23 20:26:39 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Love667767/article/details/129734905
版权

文章目录

一、概述

JNIEnv(Java Native Interface Environment) 是一个JNI接口指针 (每个线程独有一个 JNIEnv 指针)，指向了本地方法的一个函数表，该函数表中的每一个成员指向了一个JNI函数，本地的方法通过JNI函数来访问JVM中的数据结构，详情如下图：

在这里插入图片描述

关联文章：

参考文章：

二、JNIEnv结构体

我们知道 JNI 方法一般都是使用 JNIEnv 去调用，而 JNIEnv 又是一个指针，所以JNI中有哪些函数，只需要找到 JNIEnv 的实现体就可以了。

struct _JNIEnv;
# C中直接使用JNINativeInterface指针进行操作。
typedef const struct JNINativeInterface* C_JNIEnv; 

#if defined(__cplusplus)
typedef _JNIEnv JNIEnv;

从上述代码可以看到，C中直接使用 JNINativeInterface 指针进行操作。在C++文件中是对_JNIEnv 起的一个别名 JNIEnv。

下面我们来看下 _JNIEnv 结构体的定义。

struct _JNIEnv {
    /* do not rename this; it does not seem to be entirely opaque */
    const struct JNINativeInterface* functions;

#if defined(__cplusplus)

    jint GetVersion()
    { return functions->GetVersion(this); }

    jclass DefineClass(const char *name, jobject loader, const jbyte* buf,
        jsize bufLen)
    { return functions->DefineClass(this, name, loader, buf, bufLen); }

    jclass FindClass(const char* name)
    { return functions->FindClass(this, name); }
    // ...略
}

通过上面的代码可知，_JNIEnv 内部所有的操作都是委托给JNINativeInterface指针进行操作的，相当于_JNIEnv只是一个代理层。而在C语言中直接使用的是JNINativeInterface指针，这就是JNIEnv在C和C++调用方式不一致的原因。

三、JNINativeInterface结构体

下面我们来分析一下 JNINativeInterface 的结构体，JNINativeInterface 结构体中主要包含如下几类的操作：

  • Class操作
  • 反射操作
  • 对象字段 & 方法操作
  • 类的静态字段 & 静态方法操作
  • 字符串操作
  • 锁操作
  • 数组操作
  • 注册和反注册native方法
  • 异常Exception操作
  • 引用的操作

下文中 JNINativeInterface 内的方法有时会省略一些参数信息，我们可以通过 JNI Functions 官方文档 来查看函数原型。

以 FindClass 函数为例：

struct JNINativeInterface {
	jclass      (*FindClass)(JNIEnv*, const char*);
}

// 函数原型为：
jclass FindClass(JNIEnv *env, const char *name);

详情如下图所示：

在这里插入图片描述

3.1 Class操作

struct JNINativeInterface {
    /*获取当前JNI版本信息:*/
    jint 	(*GetVersion)(JNIEnv *);
	
	// 定义一个类：类是从某个字节数组buf中读取出来的
    jclass  (*DefineClass)(JNIEnv*, const char*, jobject, const jbyte*, jsize);

    // 查找全限定名为name的类：如String类："java/lang/String"
    jclass 	(*FindClass)(JNIEnv*, const char*);

	// 获取当前类的父类：通常在使用FindClass获取到类之后，再调用这个函数
    jclass	(*GetSuperclass)(JNIEnv*, jclass);
}

3.2 反射操作

struct JNINativeInterface {
	// 将一个Method对象转换为jmethodID
    jmethodID   (*FromReflectedMethod)(JNIEnv*, jobject);
    jfieldID    (*FromReflectedField)(JNIEnv*, jobject);
    // 通过jmethodID，反射得到Method对象
    jobject     (*ToReflectedMethod)(JNIEnv*, jclass, jmethodID, jboolean);
    /* spec doesn't show jboolean parameter */
    jobject     (*ToReflectedField)(JNIEnv*, jclass, jfieldID, jboolean);
}

3.3 对象字段 & 方法操作

struct JNINativeInterface {
	// 通过指定jclass类名、字段名称、字段类型来获取jfieldID
    jfieldID    (*GetFieldID)(JNIEnv*, jclass, const char*, const char*);
	
	// ---------- 操作Field -------------
	// 通过类的jobject和jfieldID获取字段的jobject对象。
    void        (*SetObjectField)(JNIEnv*, jobject, jfieldID, jobject);
    jobject     (*GetObjectField)(JNIEnv*, jobject, jfieldID);
    // 8种基本类型字段的获取与赋值。
    void        (*SetByteField)(JNIEnv*, jobject, jfieldID, jbyte);
    jbyte       (*GetByteField)(JNIEnv*, jobject, jfieldID);

	// ---------- 操作Method -------------
	// 通过指定jclass类名、方法名称、方法签名信息来获取jmethodID
	jmethodID   (*GetMethodID)(JNIEnv*, jclass, const char*, const char*);
	// 8种基本类型：boolean、byte、char、short、int、long、float、double。
	// ...是可变长度的参数，参数类型相同。
    jbyte       (*CallByteMethod)(JNIEnv*, jobject, jmethodID, ...);
    // va_list是可变长度的参数，参数类型可以不同。
    jbyte       (*CallByteMethodV)(JNIEnv*, jobject, jmethodID, va_list);
    // jvalue 是8中基本类型
    jbyte       (*CallByteMethodA)(JNIEnv*, jobject, jmethodID, const jvalue*);	
}

typedef union jvalue {
    jboolean    z;
    jbyte       b;
    jchar       c;
    jshort      s;
    jint        i;
    jlong       j;
    jfloat      f;
    jdouble     d;
    jobject     l;
} jvalue;

小结：

  • 方法参数通过支持3种不同的参数类型来覆盖所有的参数场景。
  • 单个参数场景：使用 jvalue 来表示支持一个参数的场景。
  • 多个相同参数场景：使用 … 来表示支持同类型的多个参数。
  • 多个不同参数场景：使用 va_list 来表示支持不同类型的多个参数。

3.4 类的静态字段 & 静态方法操作

struct JNINativeInterface {
	// ---------- 操作 Static Field -------------                        
	jfieldID    (*GetStaticFieldID)(JNIEnv*, jclass, const char*, const char*);
	
    void        (*SetStaticObjectField)(JNIEnv*, jclass, jfieldID, jobject);
    jobject     (*GetStaticObjectField)(JNIEnv*, jclass, jfieldID);
    
    void        (*SetStaticByteField)(JNIEnv*, jclass, jfieldID, jbyte);
    jbyte       (*GetStaticByteField)(JNIEnv*, jclass, jfieldID);
    
	// ---------- 操作 Static Method -------------
	// 与GetMethodID方法类似。
	jmethodID   (*GetStaticMethodID)(JNIEnv*, jclass, const char*, const char*);
	// 三种参数方式：...、va_list、jvalue。
    jbyte       (*CallStaticByteMethod)(JNIEnv*, jclass, jmethodID, ...);
    jbyte       (*CallStaticByteMethodV)(JNIEnv*, jclass, jmethodID, va_list);
    jbyte       (*CallStaticByteMethodA)(JNIEnv*, jclass, jmethodID, const jvalue*);
}

3.5 字符串操作

struct JNINativeInterface {
    jstring     (*NewString)(JNIEnv*, const jchar*, jsize);
    jsize       (*GetStringLength)(JNIEnv*, jstring);
    const jchar* (*GetStringChars)(JNIEnv*, jstring, jboolean*);
    void        (*ReleaseStringChars)(JNIEnv*, jstring, const jchar*);
    jstring     (*NewStringUTF)(JNIEnv*, const char*);
    jsize       (*GetStringUTFLength)(JNIEnv*, jstring);
    /* JNI spec says this returns const jbyte*, but that's inconsistent */
    const char* (*GetStringUTFChars)(JNIEnv*, jstring, jboolean*);
    void        (*ReleaseStringUTFChars)(JNIEnv*, jstring, const char*);
}

3.6 锁操作

struct JNINativeInterface {
    jint        (*MonitorEnter)(JNIEnv*, jobject);
    jint        (*MonitorExit)(JNIEnv*, jobject);
}

3.7 数组操作

struct JNINativeInterface {
    jbyteArray  (*NewByteArray)(JNIEnv*, jsize);
    jbyte*      (*GetByteArrayElements)(JNIEnv*, jbyteArray, jboolean*);
    void        (*ReleaseByteArrayElements)(JNIEnv*, jbyteArray, jbyte*, jint);
                        
    void        (*SetByteArrayRegion)(JNIEnv*, jbyteArray, jsize, jsize, const jbyte*);
    void        (*GetByteArrayRegion)(JNIEnv*, jbyteArray, jsize, jsize, jbyte*);
}

3.8 注册和反注册native方法

struct JNINativeInterface {
    jint        (*RegisterNatives)(JNIEnv*, jclass, const JNINativeMethod*, jint);
    jint        (*UnregisterNatives)(JNIEnv*, jclass);
}

动态注册JNI代码时会使用 RegisterNatives 函数。具体请参考 - NDK(五)：JNI静态注册与动态注册

3.9 异常Exception操作

struct JNINativeInterface {
    jint        (*Throw)(JNIEnv*, jthrowable);
    jint        (*ThrowNew)(JNIEnv *, jclass, const char *);
    jthrowable  (*ExceptionOccurred)(JNIEnv*);
    void        (*ExceptionDescribe)(JNIEnv*);
    void        (*ExceptionClear)(JNIEnv*);
    void        (*FatalError)(JNIEnv*, const char*);
}

3.10 引用的操作

struct JNINativeInterface {
	// 全局变量的创建与删除
    jobject     (*NewGlobalRef)(JNIEnv*, jobject);
    void        (*DeleteGlobalRef)(JNIEnv*, jobject);
    // 局部变量的创建与删除
    jobject     (*NewLocalRef)(JNIEnv*, jobject);
    void        (*DeleteLocalRef)(JNIEnv*, jobject);
    // 对象的比较
    jboolean    (*IsSameObject)(JNIEnv*, jobject, jobject);


}

3.11 其它

struct JNINativeInterface {
    jint        (*GetJavaVM)(JNIEnv*, JavaVM**);
    jobjectRefType (*GetObjectRefType)(JNIEnv*, jobject);
    
    jint        (*PushLocalFrame)(JNIEnv*, jint);
    jobject     (*PopLocalFrame)(JNIEnv*, jobject);
}

四、小结

  • JNIEnv 是一个代理，实际的操作全部委托给 JNINativeInterface 指针执行。
  • JNINativeInterface 结构体中主要包含如下几类的操作：
    • Class操作
    • 反射操作
    • 对象字段 & 方法操作
    • 类的静态字段 & 静态方法操作
    • 字符串操作
    • 锁操作
    • 数组操作
    • 注册和反注册native方法
    • 异常Exception操作
    • 引用的操作
Elson_6
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
termux-ndk:termnd的android-ndk
04-30
这是Google的标准NDK，仅支持在具有aarch64架构的android设备上运行 来自AOSP llvm-toolchain master分支的源代码，因为llvm是跨平台的，因此我们可以将其重新编译为Android 起初，我们不需要重建整个NDK，因为google已经构建了大部分NDK。 我们只需要构建llvm工具链，然后在NDK中替换llvm。 当然，您可以使用checkbuild.py来构建整个NDK，但是源代码太大。 有关更多详细信息，请参阅 如何建造 Termux需要安装aarch64版本Linux，我建议使用 ArchLinux仅下载源代码，我们不使用它来编译 为了节省存储空间，有一些不需要下载的预编译工具。 在llvm-toolchain / .repo / manifests / default.xml文件中将它们注释掉，例如，单击。 # I assume th
Android JNI 之 JNIEnv 解析
u010543460的博客
10-25 308
jni.h文件 : 了解 JNI 需要配合 jni.h 文件, jni.h 是 Google NDK 中的一个文件, 位置是$/android-ndk-r9d/platforms/android-19/arch-arm/usr/include/jni.h ;1. JNIEnv 作用JNIEnv 概念 : 是一个线程相关的结构体, 该结构体代表了 Java 在本线程的运行环境 ;JNIEnv 与 J
JNI教程之JNIEnv接口指针
最新发布
没事就写点
02-20 177
JNI的代码是运行在JVM当中的，并不是属于native代码，所以每个JNI函数都会带一个JNIEnv ，用于在 Java 代码和native代码之间进行通信。通过 JNIEnv，可以在 Java 代码中调用native方法，或者在native代码中调用 Java 方法。在 JNI 中，JNIEnv 是一个指向 JNI 函数表的指针，通过这个指针可以访问 JNI 函数表中定义的各种 JNI 函数。如果你在 JNI 方法中（即在 C/C++ 代码中）需要获取 JNIEnv，可以通过参数来获取。
ndk调用第三方so
12-02
ndk调用第三方sondk调用第三方sondk调用第三方sondk调用第三方so
Unity NDK 版本：19.0.5232133
08-04
Unity2019/2020版所需NDK版本,版本：19.0.5232133。解压后把路径复制到软件的设置里即可，亲测可用~
cargo-ndk:轻松针对Android NDK编译Rust项目
05-14
cargo-ndk-为Android构建Rust代码 这个货物扩展处理了从Rust代码库成功构建Android库所需的所有环境配置，并支持生成正确的jniLibs目录结构。 正在安装 cargo install cargo-ndk 您还需要安装所有打算使用的工具链。 最简单的方法如下： rustup target add \ aarch64-linux-android \ armv7-linux-androideabi \ x86_64-linux-android \ i686-linux-android 根据您的用例进行必要的修改。 用法 如果您已将带有Android Studio的NDK安装到其默认位置， cargo ndk将自动检测并使用最新的NDK版本。 可以通过在ANDROID_NDK_HOME环境变量中指定NDK根目录的路径来覆盖它。 示例
JNIEnv介绍
公众号shadow sock7
09-05 2484
参考： http://wiki.jikexueyuan.com/project/deep-android-v1/jni.html JNIEnv是一个和线程相关的，代表JNI环境的结构体，图2-3展示了JNIEnv的内部结构： 附录：注册JNI函数动态注册既然Java native函数数和JNI函数是一一对应的，那么是不是会有一个结构来保存这种关联关系呢？答案是肯定的。在JNI技术中，用来记录这
JNI总管：JNIEnv
fybing1986的专栏
11-27 2321
2.3　JNI总管：JNIEnv 在Log系统的实例中，JNI层实现方法和注册方法中都使用了JNIEnv这个指针，通过它调用JNI函数，访问Java虚拟机，进而操作Java对象。JNIEnv是JNI编程中最重要的概念，本节将详细介绍它。首先看JNIEnv的体系结构，如图2-2所示。 在图2-2中可以看到，JNIEnv首先指向一个线程相关的结构，该结构又指向一个指针数组，
JNI env 总结
mas17kaworu的博客
06-16 930
JNIEnv与JavaVM  JNIEnv 概念 : 是一个线程相关的结构体, 该结构体代表了 Java 在本线程的运行环境 ;  JNIEnv 与 JavaVM : 注意区分这两个概念;  -- JavaVM : JavaVM 是 Java虚拟机在 JNI 层的代表, JNI 全局只有一个; -- JNIEnv : JavaVM 在线程中的代表, 每个线程都有一个, JNI 中可能有
JNIEnv结构体解析
PeterOK的博客
07-19 1941
JNI作为联系Java世界和Native世界的桥梁还面临过一个很麻烦的问题，那就是Java和Native之间的数据类型转换。 数据类型转换 基本数据类型转换 Java类型 别名 C++本地类型 字节(bit) boolean jboolean unsigned char 8, unsigned byte jbyte signed cha...
JNI初体验，JNIEnv类型分析与介绍
jalen-qian的博客
11-29 666
一、简单调用之java调用c代码： 1.首先创建一个java工程，写一个java类，里面写一个native方法，该方法返回一个字符串： 2. 生成头文件：找到工程的目录并进入bin目录： 复制这个路径，在命令提示符中进入这个路径（这个操作相信不用多说了，就是输入cd+空格+路径） 3. 进入刚才的路径并用javah命令生成.h头文件如下： 注意
ndk命令行编译so库
01-03
最近怀旧了一下经典，记录一下用NDK命令行编译so库的过程。 [PS]自行安装好JDK，SDK，NDK，配置好环境变量，使能正常开发android应用. 1.首先，写好你的源文件和Android.mk和Application.mk文件。 2.打开cmd，切换到安装ndk的目录下。 3.输入编译命令行。如下： ndk-build NDK_PROJECT_PATH=项目根目录      APP_BUILD_SCRIPT=项目根目录/Android.mk     NDK_APPLICATION_MK=项目根目录/Application.mk 4.源文件和Android.mk和Applic
JNI 使用
DengCaixiang2021的博客
09-01 399
JNI（Java Native Interface）是Java语言提供的一种机制，用于在Java应用程序中调用本地代码（Native Code）或者让本地代码调用Java代码。它为Java和其他编程语言（如C、C++）之间的交互提供了一种标准的接口。
JNIEnv解析
热门推荐
FreeChao的专栏
06-26 4万+
1.关于JNIEnv和JavaVM  JNIEnv是一个与线程相关的变量，不同线程的JNIEnv彼此独立。JavaVM是虚拟机在JNI层的代表，在一个虚拟机进程中只有一个JavaVM，因此该进程的所有线程都可以使用这个JavaVM。当后台线程需要调用JNI native时，在native库中使用全局变量保存JavaVM尤为重要，这样使得后台线程能通过JavaVM获得JNIEnv。 na
Android系统的JNI原理分析（3）- 关于JNIEnv
Android系统工程师--小馬佩德罗
01-06 9402
JNIEnv结构体中定义的函数返回值有多种，包括：jobject、jboolean、jstring、jmethodID、jfieldID等，其中jmethodID、jfieldID分别用以代表Java中的成员方法和成员变量。} }其中jclass代表Java类、name代表成员方法或成员变量的名字、sig为此方法和变量的签名。进入到源码路径：~/LineageOS/frameworks/base/media/jni/
深入理解JavaVM与JNIEnv
做的过程自我总结
09-22 979
遇到的问题，Native层本地多线程回调Java函数时env->findClass()失败。 前面的代码是这样的在 JNI_OnLoad记录全局变量g_vm static JavaVM* g_vm = NULL; 1 JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void* reserved) 2 3 { 4 5 JNIEnv * env = NULL; 6 7 if (g_vm == NULL) 8 {
Android JNI之JNIEnv
三言两语
01-16 989
转载自：http://blog.csdn.net/shulianghan/article/details/38012515   jni.h文件 : 了解 JNI 需要配合 jni.h 文件, jni.h 是 Google NDK 中的一个文件, 位置是 $/android-ndk-r9d/platforms/android-19/arch-arm/usr/include/jni.h ;
JNIEnv*的常用函数详解
hgm770876501的专栏
06-20 739
先看一个简单的CPP实现的例子 [cpp] view plaincopy #include "TestNative.h"      /*   * Class:     TestNative   * Method:    add   * Signature: (II)I   */   JNIEXPORT jint JNICALL Ja
::ndk::ICInterface::asInterface的意义是啥
06-02
::ndk::ICInterface::asInterface 是将本地代码和 Java 代码进行交互的一个关键函数，它的作用是将 Java 对象的引用传递给本地代码，以便本地代码可以调用 Java 对象的方法或访问其属性。在 Android NDK 中，native 方法需要使用 JNIEnv 和 jobject 作为参数，JNIEnv 用于操作 Java 虚拟机，jobject 则表示 Java 对象的引用。在使用 asInterface 函数时，需要将 jobject 传递给它，asInterface 函数会返回一个指向 ICInterface 接口的指针，这个指针可以用于后续的操作。通过这种方式，本地代码可以与 Java 代码进行交互，实现更加复杂的功能。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值