Struct GlobalRef

pub struct GlobalRef { /* private fields */ }

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 and can be used in other threads.

GlobalRef can be cloned to use the same global reference in different contexts. If you want to create yet another global ref to the same java object you may call JNIEnv#new_global_ref just like you do when create GlobalRef from a local reference.

Underlying global reference will be dropped, when the last instance of GlobalRef leaves its scope.

It is recommended that a native thread that drops the global reference is attached to the Java thread (i.e., has an instance of JNIEnv). If the native thread is not attached, the GlobalRef#drop will print a warning and implicitly attach and detach it, which significantly affects performance.

Implementations

impl GlobalRef

pub fn as_obj(&self) -> &JObject<'static>

Get the object from the global ref

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

Methods from Deref<Target = JObject<'static>>

pub fn as_raw(&self) -> *mut _jobject

Returns the raw JNI pointer.

Trait Implementations

impl AsRef<GlobalRef> for GlobalRef

fn as_ref(&self) -> &GlobalRef

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<JObject<'static>> for GlobalRef

fn as_ref(&self) -> &JObject<'static>

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for GlobalRef

fn clone(&self) -> GlobalRef

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GlobalRef

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Deref for GlobalRef

type Target = JObject<'static>

The resulting type after dereferencing.

fn deref(&self) -> &<GlobalRef as Deref>::Target

Dereferences the value.

impl<'local, 'obj_ref> Desc<'local, JClass<'static>> for &'obj_ref GlobalRef

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

type Output = &'obj_ref JClass<'static>

The type that this Desc returns.

fn lookup( self, _: &mut JNIEnv<'local>, ) -> Result<<&'obj_ref GlobalRef as Desc<'local, JClass<'static>>>::Output, Error>

Look up the concrete type from the JVM.