Struct jni::objects::GlobalRef

pub struct GlobalRef { /* fields omitted */ }

A global JVM reference. These are "pinned" by the garbage collector and are guaranteed to not get collected until released. Thus, this is allowed to outlive the JNIEnv that it came from. Still can't cross thread boundaries since it requires a pointer to the JNIEnv to do anything useful with it.

Methods

impl GlobalRef

unsafe fn new(env: *mut JNIEnv, obj: jobject) -> Self

Create a new global reference object. This assumes that CreateGlobalRef has already been called.

fn as_obj<'a>(&'a self) -> JObject<'a>

Get the object from the global ref

This borrows the ref and prevents it from being dropped as long as the JObject sticks around.

Trait Implementations

impl<'a> Desc<'a, JClass<'a>> for &'a GlobalRef

This conversion assumes that the GlobalRef is a pointer to a class object.

fn lookup(self, _: &JNIEnv<'a>) -> Result<JClass<'a>>

Look up the concrete type from the JVM.

impl Drop for GlobalRef

fn drop(&mut self)

Executes the destructor for this type.