Android JNI 学习(五):References Api

摘要:
全局引用通过调用DeleteLocalRef()显式撤消。如果创建成功,将返回0。否则,将返回负数,并引发OutOfMemoryError异常。当naitve方法开始运行时,VM将自动确保至少可以创建16个本地引用。为了兼容性,VM分配的内存超过了声明的本地引用数。

1. NewGlobalRef(创建全局引用)

jobjectNewGlobalRef(JNIEnv *env, jobject obj);

创建 obj 参数所引用对象的新全局引用。obj 参数既可以是全局引用,也可以是局部引用。全局引用通过调用 DeleteGlobalRef() 来显式撤消。

参数:

env:JNI 接口指针。

obj:全局或局部引用。

返回值:

返回全局引用。如果系统内存不足则返回 NULL

2. DeleteGlobalRef(删除全局引用)

void DeleteGlobalRef(JNIEnv *env, jobject globalRef);

删除 globalRef 所指向的全局引用。

参数:

env:JNI 接口指针。

globalRef:全局引用。

3. NewLocalRef(创建局部引用)

jobject NewLocalRef(JNIEnv *env, jobject ref); 

创建 obj 参数所引用对象的新局部引用。ref 参数既可以是全局引用,也可以是局部引用。全局引用通过调用 DeleteLocalRef() 来显式撤消。

参数:

env:JNI 接口指针。

ref:全局或局部引用。

返回值:

返回局部引用。如果系统内存不足则返回 NULL

4. DeleteLocalRef(删除局部引用)

void DeleteLocalRef(JNIEnv *env, jobject localRef);

删除 localRef所指向的局部引用。

参数:

env:JNI 接口指针。

localRef:局部引用。

5. EnsureLocalCapacity(确保局部引用的容量)

jint EnsureLocalCapacity(JNIEnv *env, jint capacity); 

确保至少给定数量的局部引用能在当前线程被创建。如果创建成功就返回0,否则就会返回一个负数并且抛出OutOfMemoryError异常。

当naitve方法开始运行时,VM会自动保证至少16个局部引用能被创建。

为了兼容,VM会分配超过声明的局部引用数量的内存。

6. NewWeakGlobalRef(创建全局弱引用)

jweak NewWeakGlobalRef(JNIEnv *env, jobject obj); 

创建 obj 参数所引用对象的新全局弱引用。ref 参数既可以是全局引用,也可以是局部引用。全局引用通过调用 DeleteWeakGlobalRef() 来显式撤消。

参数:

env:JNI 接口指针。

obj:全局或局部弱引用。

返回值:

返回局部引用。如果系统内存不足则返回 NULL

7. DeleteWeakGlobalRef(删除全局弱引用)

void DeleteWeakGlobalRef(JNIEnv *env, jweak obj);

删除 obj 所指向的全局弱引用。

参数:

env:JNI 接口指针。

obj:全局弱引用。

免责声明:文章转载自《Android JNI 学习(五):References Api》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇关于Spring运用过程中jar包报错问题Android 高级UI设计笔记23:Android 夜间模式之 两种常用方法(降低屏幕亮度+替换theme)下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

11.Unity3D与android交互---构建android插件

为android构建一个插件 要创建一个android插件,首先要有 Android NDK 并熟悉使用ndk构建共享库的方法。 如果用C++来实现库,必须声明成用C语言的链接方式,以避免Name Mangling问题。 extern "C" { float FooPluginFunction (); } 通过C#脚本使用插件 构建了共享库后,必...

Android:JNI与NDK(二)交叉编译与动态库,静态库

  欢迎关注公众号,第一时间获取最新文章:   本篇目录 一、前言 本篇主要以window开发环境为背景介绍一下NDK开发中需要掌握的交叉编译等基础知识,选window系统主要是照顾大多数读者,mac ,linux操作系统基本是同样适用的。 交叉编译就是在A平台编译出可以在B平台执行的文件,对于我们安卓开发者来说交叉编译就是在window或者mac或者...

Android用surface直接显示yuv数据(三)

本文用Java创建UI并联合JNI层操作surface来直接显示yuv数据(yv12),开发环境为Android 4.4,全志A23平台。 package com.example.myyuvviewer; import java.io.File; import java.io.FileInputStream; import and...

linux环境下java调用C/C++动态库(JNI技术:参数为指针与结构体)

一、JNI技术  JNI是Java Native Interface的缩写,通过使用 Java本地接口书写程序,可以确保代码在不同的平台上方便移植.  SUN公司发布的Java 本地接口(JNI)提供了将Java与C/C++、汇编等本地代码集成的方案,该规范使得在 Java 虚拟机内运行的 Java 代码能够与其它编程语言互相操作,包括创建本地方法、更新J...

jdk/java版本与Android源码编译中的错误

错误一:javap未指向有效的java版本 Traceback (most recent call last): File "../../base/android/jni_generator/jni_generator.py", line 1065, in <module> sys.exit(main(sys.argv)) Fi...

Android JNI和NDK学习(08)JNI实例一 传递基本类型数据

Android JNI和NDK学习(08)--JNI实例一 传递基本类型数据 本文介绍在Java和JNI之间相互传递基本数据类型的方法。 由于前面已经详细介绍搭建和建立NDK工程的完整流程(参考“静态实现流程”或“动态实现流程”),这里就不再介绍流程;而是将重点放在说明如何实现Java和JNI之间相互传递基本数据。 1 建立eclipse工程 建立工程Nd...