【Android NDK 开发】JNI 方法解析 ( JNIEnv *env 参数 )

举报
韩曙亮 发表于 2022/01/11 02:07:34 2022/01/11
【摘要】 文章目录 一、 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();

  
 
  • 1

② 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());
}

  
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12

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

  
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7

由上面的代码可知 , 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;

  
 
  • 1

② C ++ 别名 : C ++ 中 , 将 _JNIEnv 结构体类型声明为 JNIEnv 类型 ;

typedef _JNIEnv JNIEnv;

  
 
  • 1


三、 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*);
	...
};

  
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34

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); }
	...
}

  
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33

文章来源: hanshuliang.blog.csdn.net,作者:韩曙亮,版权归原作者所有,如需转载,请联系作者。

原文链接:hanshuliang.blog.csdn.net/article/details/104082438

【版权声明】本文为华为云社区用户转载文章,如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。