Struct jni_glue::Global

pub struct Global<Class: AsValidJObjectAndEnv> { /* fields omitted */ }

A Global, non-null, reference to a Java object (+ &VM).

Unlike Local, this can be stored statically and shared between threads. This has a few caveats:

• You must create a GlobalRef before use.
• The Global can be invalidated if the VM is unloaded.

Not FFI Safe: #[repr(rust)], and exact layout is likely to change - depending on exact features used - in the future. Specifically, on Android, since we're guaranteed to only have a single ambient VM, we can likely store the *const JavaVM in static and/or thread local storage instead of lugging it around in every Local. Of course, there's no guarantee that's actually an optimization...

Methods

impl<Class: AsValidJObjectAndEnv> Global<Class>

pub fn with<'env>(&'env self, env: &'env Env) -> GlobalRef<'env, Class>

pub unsafe fn with_unchecked<'env>(
    &'env self,
    env: &'env Env
) -> GlobalRef<'env, Class>

Trait Implementations

impl<Class: AsValidJObjectAndEnv> Drop for Global<Class>

fn drop(&mut self)

Executes the destructor for this type.

impl<'env, Class: AsValidJObjectAndEnv> From<Local<'env, Class>> for Global<Class>

fn from(local: Local<'env, Class>) -> Global<Class>

Performs the conversion.

impl<Class: AsValidJObjectAndEnv> Send for Global<Class>

impl<Class: AsValidJObjectAndEnv> Sync for Global<Class>