文章目录
一、 JNI 方法解析
二、 JNIEnv *env 参数解析
三、 C 语言 环境中 JNIEnv *env 参数解析
四、 C ++ 环境中 JNIEnv *env 参数解析
总结 : JNI 中定义的函数指针 , 实际都定义在 JNINativeInterface 结构体中 ;
C 语言中的 JNIEnv * env 实际上是 JNINativeInterface ** 类型 , 调用其中的方法指针时 , 先解引用 , 得到其一维指针 , 然后调用对用函数指针 (* env)->函数指针 ;
C++ 中专门定义了 JNIEnv 结构体类型 , 其中的函数直接封装调用了 JNINativeInterface 结构体中的函数指针 , 只需要调用 JNIEnv 结构体中的方法即可 , C++ 中的 JNIEnv * env , 可以直接调用其中的方法 , 将其当做一个对象使用 , env->方法名称 , 即可完成调用 ;
一、 JNI 方法解析
1 . JNI 方法定义 :
① 在 Android 的 Java 层定义方法 : 在 MainActivity 类中定义 如下 Native 方法 ;
public native String stringFromJNI();
② Native 方法实现 : 下面是一个 Native 方法实现的示例 ;
extern "C" JNIEXPORT jstring JNICALL Java_kim_hsl_jni_MainActivity_stringFromJNI( JNIEnv *env, jobject /* this */) { // 创建 C++ 字符串 std::string hello = "Hello from C++"; // 返回 jstring 类型的字符串 return env->NewStringUTF(hello.c_str()); }
2 . 分析上述 JNI 方法 :
① extern “C” : 表示 C 语言 和 C++ 的兼容 ;
② JNIEXPORT jstring JNICALL : 这是两个宏定义 , 在 Linux 和 Windows 中分别有不同的表示 ; 其中的 jstring 表示返回值类型是 Java 中的 String 类型 ;
关于 JNIEXPORT 与 JNICALL 宏定义 , 参考下面的博客 :
【Android NDK 开发】JNIEXPORT 与 JNICALL 宏定义作用
③ JNIEnv *env : 其中第一个参数 JNIEnv *env 代表了 JNI 环境 ;
④ jobject 参数 : 该 Native 方法定义在 MainActivity 类中 ;
1> 非静态方法 : 如果该方法是非静态方法 , 那么 jobject 参数表示 MainActivity 类的对象 ;
2> 静态方法 : 如果该方法是静态方法 , 那么 jobject 参数表示 MainActivity.class ( Class 对象 ) ;
二、 JNIEnv *env 参数解析
在 C 语言 和 C++ 中 , JNIEnv 代表着不同的含义 ;
1 . JNIEnv 类型声明 :
#if defined(__cplusplus) typedef _JNIEnv JNIEnv; typedef _JavaVM JavaVM; #else typedef const struct JNINativeInterface* JNIEnv; typedef const struct JNIInvokeInterface* JavaVM; #endif
由上面的代码可知 , JNIEnv 是通过 typedef 将其它的类型定义为 JNIEnv 类型的 ;
__cplusplus 是 C++ 编译器中定义的宏 , C 语言编译器中没有定义该宏 , 通过该宏定义 , 可以区分当前是 C++ 环境还是 C语言环境 ;
#if defined(__cplusplus) 分支中声明的是 C++ 环境下的 JNIEnv 类型 ;
#else 分支中声明的是 C 语言环境下的 JNIEnv 类型 ;
2 . 两种 typedef 声明别名的含义
① C 语言别名 : C 语言中 将 JNINativeInterface 结构体指针 类型 声明为 JNIEnv 类型 ;
typedef const struct JNINativeInterface* JNIEnv;
② C ++ 别名 : C ++ 中 , 将 _JNIEnv 结构体类型声明为 JNIEnv 类型 ;
typedef _JNIEnv JNIEnv;
三、 C 语言 环境中 JNIEnv *env 参数解析
1 . JNIEnv 类型 : C 语言环境中 , 系统将 JNINativeInterface* 类型 声明为 JNIEnv 别名 ;
2 . JNINativeInterface 结构体 : JNINativeInterface 是结构体类型 , 其中定义了 229 个函数指针 , 用于处理 Java 层 与 Native 层的数据交互信息 ;
3 . C 语言环境中 , 调用 JNINativeInterface 结构体中的函数指针 :
① 类型转换 : 给定的参数是 JNIEnv *env 类型的 , 即 JNINativeInterface ** env 类型 , 是一个 JNINativeInterface 结构体边来那个的二级指针 ;
② 通过 JNINativeInterface 指针调用 ( 推荐) : 首先要 解引用 ( *env ) , 该变量就变成了 JNINativeInterface 结构体变量的 一级指针 , 使用 -> 即可调用指定方法 , ( *env ) -> NewStringUTF( “Hello World !” );
③ 通过 JNINativeInterface 结构体调用 ( 不常用 ) : ( **env ).NewStringUTF( “Hello World !” ) , 相当于将上面的 -> 操作符变成 * . 操作符 ;
4 . JNINativeInterface 结构体部分代码示例 : 该结构体定义在 jni.h 头文件中 ;
struct JNINativeInterface { void* reserved0; void* reserved1; void* reserved2; void* reserved3; jint (*GetVersion)(JNIEnv *); jclass (*DefineClass)(JNIEnv*, const char*, jobject, const jbyte*, jsize); jclass (*FindClass)(JNIEnv*, const char*); jmethodID (*FromReflectedMethod)(JNIEnv*, jobject); jfieldID (*FromReflectedField)(JNIEnv*, jobject); /* spec doesn't show jboolean parameter */ jobject (*ToReflectedMethod)(JNIEnv*, jclass, jmethodID, jboolean); jclass (*GetSuperclass)(JNIEnv*, jclass); jboolean (*IsAssignableFrom)(JNIEnv*, jclass, jclass); /* spec doesn't show jboolean parameter */ jobject (*ToReflectedField)(JNIEnv*, jclass, jfieldID, jboolean); jint (*Throw)(JNIEnv*, jthrowable); jint (*ThrowNew)(JNIEnv *, jclass, const char *); jthrowable (*ExceptionOccurred)(JNIEnv*); void (*ExceptionDescribe)(JNIEnv*); void (*ExceptionClear)(JNIEnv*); void (*FatalError)(JNIEnv*, const char*); ... jstring (*NewStringUTF)(JNIEnv*, const char*); ... };
JNINativeInterface 是结构体类型 , 其中定义了 229 个函数指针 , 用于处理 Java 层 与 Native 层的数据交互信息
四、 C ++ 环境中 JNIEnv *env 参数解析
1 . C++ 环境中 _JNIEnv 类型 : 在 C++ 中 , 将 _JNIEnv 结构体类型 通过 typedef 为其声明别名 JNIEnv ;
2 . _JNIEnv 结构体 : 该结构体中封装了一个 JNINativeInterface 结构体类型指针 , _JNIEnv 结构体中也封装了 229 个 方法 , 每个方法都调用 对应的 JNINativeInterface* functions 中的函数指针 ;
3 . C ++ 语言环境中 , 调用 _JNIEnv 结构体中的函数 :
① 类型转换 : 给定的参数是 JNIEnv *env 类型的 , 即 _JNIEnv * env 类型 ;
② 通过 _JNIEnv 指针调用 ( 推荐) : 直接使用 -> 符号访问该方法即可 , env-> NewStringUTF( “Hello World !” );
_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); } jmethodID FromReflectedMethod(jobject method) { return functions->FromReflectedMethod(this, method); } jfieldID FromReflectedField(jobject field) { return functions->FromReflectedField(this, field); } jobject ToReflectedMethod(jclass cls, jmethodID methodID, jboolean isStatic) { return functions->ToReflectedMethod(this, cls, methodID, isStatic); } jclass GetSuperclass(jclass clazz) { return functions->GetSuperclass(this, clazz); } ... jstring NewStringUTF(const char* bytes) { return functions->NewStringUTF(this, bytes); } ... }
