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 Local. 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

pub fn vm(&self) -> VM

pub fn as_raw(&self) -> jobject

pub fn into_raw(self) -> jobject

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

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

Trait Implementations

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

fn as_arg(&self) -> jobject

fn as_arg_jvalue(&self) -> jvalue

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

fn clone(&self) -> Self

Returns a copy 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>