Struct Global 

pub struct Global<T: ReferenceType> { /* private fields */ }

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 Ref 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 Global. Of course, there’s no guarantee that’s actually an optimization…

Implementations

impl<T: ReferenceType> Global<T>

pub unsafe fn from_raw(vm: VM, object: jobject) -> Self

Wraps an owned raw JNI global reference, taking the ownership.

Safety

object must be an owned non-null JNI global reference to an object of type T, not to be deleted by another wrapper.

pub fn vm(&self) -> VM

Gets the VM under which the JNI reference is created.

pub fn as_raw(&self) -> jobject

Returns the raw JNI reference pointer.

pub fn into_raw(self) -> jobject

Leaks the Global and turns it into a raw pointer, preserving the ownership of one JNI global reference; prevents DeleteGlobalRef from being called on dropping.

pub fn as_local<'env>(&self, env: Env<'env>) -> Local<'env, T>

Returns a new JNI local reference of the same Java object.

pub fn as_ref<'env>(&'env self, env: Env<'env>) -> Ref<'env, T>

Returns a Ref, with which Java methods from generated bindings can be used. The lifetime of the returned Ref can be the intersection of this Global and a supposed local reference under env.

Trait Implementations

impl<T: ReferenceType, U: AssignableTo<T>> AsArg<T> for Global<U>

fn as_arg(&self) -> jobject

impl<T: ReferenceType> Clone for Global<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: ReferenceType> Drop for Global<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<'env, T: ReferenceType> From<&Local<'env, T>> for Global<T>

fn from(x: &Local<'env, T>) -> Self

Converts to this type from the input type.

impl<'env, T: ReferenceType> From<&Ref<'env, T>> for Global<T>

fn from(x: &Ref<'env, T>) -> Self

Converts to this type from the input type.

impl<'env, T: ReferenceType> From<Local<'env, T>> for Global<T>

fn from(x: Local<'env, T>) -> Self

Converts to this type from the input type.

impl<'env, T: ReferenceType> From<Ref<'env, T>> for Global<T>

fn from(x: Ref<'env, T>) -> Self

Converts to this type from the input type.

impl<T: ReferenceType> Send for Global<T>

impl<T: ReferenceType> Sync for Global<T>