Struct jni::objects::JObject

#[repr(transparent)]
pub struct JObject<'local> { /* private fields */ }

Wrapper around [sys::jobject] that adds a lifetime to ensure that the underlying JNI pointer won’t be accessible to safe Rust code if the object reference is released.

It matches C’s representation of the raw pointer, so it can be used in any of the extern function argument positions that would take a jobject.

Most other types in the objects module deref to this, as they do in the C representation.

The lifetime 'local represents the local reference frame that this reference belongs to. See the JNIEnv documentation for more information about local reference frames. If 'local is 'static, then this reference does not belong to a local reference frame, that is, it is either null or a global reference.

Note that an owned JObject is always a local reference and will never have the 'static lifetime. GlobalRef does implement AsRef<JObject<’static>>, but this only yields a borrowed &JObject<'static>, never an owned JObject<'static>.

Local references belong to a single thread and are not safe to share across threads. This type implements Send and Sync if and only if the lifetime 'local is 'static.

Implementations

impl<'local> JObject<'local>

pub unsafe fn from_raw(raw: jobject) -> Self

Creates a JObject that wraps the given raw jobject

Safety

raw may be a null pointer. If raw is not a null pointer, then:

• raw must be a valid raw JNI local reference.
• There must not be any other JObject representing the same local reference.
• The lifetime 'local must not outlive the local reference frame that the local reference was created in.

pub fn as_raw(&self) -> jobject

Returns the raw JNI pointer.

pub fn into_raw(self) -> jobject

Unwrap to the internal jni type.

pub fn null() -> JObject<'static>

Creates a new null reference.

Null references are always valid and do not belong to a local reference frame. Therefore, the returned JObject always has the 'static lifetime.

Trait Implementations

impl<'local> AsMut<JObject<'local>> for JObject<'local>

fn as_mut(&mut self) -> &mut JObject<'local>

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

impl<'local> AsRef<JObject<'local>> for JByteBuffer<'local>

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

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

impl<'local> AsRef<JObject<'local>> for JClass<'local>

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

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

impl<'local> AsRef<JObject<'local>> for JObject<'local>

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

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

impl<'local> AsRef<JObject<'local>> for JObjectArray<'local>

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

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

impl<'local, T: TypeArray> AsRef<JObject<'local>> for JPrimitiveArray<'local, T>

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

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

impl<'local> AsRef<JObject<'local>> for JString<'local>

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

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

impl<'local> AsRef<JObject<'local>> for JThrowable<'local>

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

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

impl<'local, 'other_local_1: 'obj_ref, 'obj_ref> AsRef<JObject<'other_local_1>> for JList<'local, 'other_local_1, 'obj_ref>

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

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

impl<'local, 'other_local_1: 'obj_ref, 'obj_ref> AsRef<JObject<'other_local_1>> for JMap<'local, 'other_local_1, 'obj_ref>

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

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<'local> Debug for JObject<'local>

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

Formats the value using the given formatter.

impl<'local> Default for JObject<'local>

fn default() -> Self

Returns the “default value” for a type.

impl<'local> Deref for JObject<'local>

type Target = *mut _jobject

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'local, 'obj_ref> From<&'obj_ref JObject<'local>> for &'obj_ref JByteBuffer<'local>

fn from(other: &'obj_ref JObject<'local>) -> Self

Converts to this type from the input type.

impl<'local, 'obj_ref> From<&'obj_ref JObject<'local>> for &'obj_ref JClass<'local>

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

fn from(other: &'obj_ref JObject<'local>) -> Self

Converts to this type from the input type.

impl<'local, 'obj_ref> From<&'obj_ref JObject<'local>> for &'obj_ref JObjectArray<'local>

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

fn from(other: &'obj_ref JObject<'local>) -> Self

Converts to this type from the input type.

impl<'local, 'obj_ref, T: TypeArray> From<&'obj_ref JObject<'local>> for &'obj_ref JPrimitiveArray<'local, T>

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

fn from(other: &'obj_ref JObject<'local>) -> Self

Converts to this type from the input type.

impl<'local, 'obj_ref> From<&'obj_ref JObject<'local>> for &'obj_ref JString<'local>

fn from(other: &'obj_ref JObject<'local>) -> Self

Converts to this type from the input type.

impl<'local, 'obj_ref> From<&'obj_ref JObject<'local>> for &'obj_ref JThrowable<'local>

fn from(other: &'obj_ref JObject<'local>) -> Self

Converts to this type from the input type.

impl<'local> From<JByteBuffer<'local>> for JObject<'local>

fn from(other: JByteBuffer<'_>) -> JObject<'_>

Converts to this type from the input type.

impl<'local> From<JClass<'local>> for JObject<'local>

fn from(other: JClass<'_>) -> JObject<'_>

Converts to this type from the input type.

impl<'local> From<JObject<'local>> for JByteBuffer<'local>

fn from(other: JObject<'_>) -> Self

Converts to this type from the input type.

impl<'local> From<JObject<'local>> for JClass<'local>

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

fn from(other: JObject<'_>) -> Self

Converts to this type from the input type.

impl<'local> From<JObject<'local>> for JObjectArray<'local>

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

fn from(other: JObject<'_>) -> Self

Converts to this type from the input type.

impl<'local, T: TypeArray> From<JObject<'local>> for JPrimitiveArray<'local, T>

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

fn from(other: JObject<'_>) -> Self

Converts to this type from the input type.

impl<'local> From<JObject<'local>> for JString<'local>

fn from(other: JObject<'_>) -> Self

Converts to this type from the input type.

impl<'local> From<JObject<'local>> for JThrowable<'local>

fn from(other: JObject<'_>) -> Self

Converts to this type from the input type.

impl<'local> From<JObjectArray<'local>> for JObject<'local>

fn from(other: JObjectArray<'_>) -> JObject<'_>

Converts to this type from the input type.

impl<'local, T: TypeArray> From<JPrimitiveArray<'local, T>> for JObject<'local>

fn from(other: JPrimitiveArray<'local, T>) -> JObject<'_>

Converts to this type from the input type.

impl<'local> From<JString<'local>> for JObject<'local>

fn from(other: JString<'_>) -> JObject<'_>

Converts to this type from the input type.

impl<'local> From<JThrowable<'local>> for JObject<'local>

fn from(other: JThrowable<'_>) -> JObject<'_>

Converts to this type from the input type.

impl<'local> TryFrom<JValueGen<JObject<'local>>> for JObject<'local>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: JValueOwned<'local>) -> Result<Self>

Performs the conversion.

impl Send for JObject<'static>

impl Sync for JObject<'static>