Struct Object

pub struct Object<'env> { /* private fields */ }

A type representing the java.lang.Object class – the root class of Java’s class hierarchy.

Object javadoc

Implementations

impl<'env> Object<'env>

pub unsafe fn raw_object(&self) -> jobject

Get the raw object pointer.

This function provides low-level access to the Java object and thus is unsafe.

pub fn env(&self) -> &'env JniEnv<'env>

Get the JniEnv this object is bound to.

pub fn class(&self, _token: &NoException<'_>) -> Class<'env>

Get the object’s class.

JNI documentation

pub fn is_same_as(&self, other: &Object<'_>, _token: &NoException<'_>) -> bool

Compare with another Java object by reference.

JNI documentation

pub fn is_instance_of( &self, class: &Class<'_>, _token: &NoException<'_>, ) -> bool

Check if the object is an instance of the class.

JNI documentation

pub fn clone(&self, token: &NoException<'env>) -> JavaResult<'env, Object<'env>>

Clone the Object. This is not a deep clone of the Java object, but a Rust-like clone of the value. Since Java objects are reference counted, this will increment the reference count.

This method has a different signature from the one in the Clone trait because cloning a Java object is only safe when there is no pending exception and because cloning a java object cat throw an exception.

JNI documentation

impl<'env> Object<'env>

pub fn get_class( env: &'env JniEnv<'env>, token: &NoException<'env>, ) -> JavaResult<'env, Class<'env>>

Get the Java class object for Object .

Object::getClass javadoc

pub fn to_string( &self, token: &NoException<'env>, ) -> JavaResult<'env, String<'env>>

Convert the object to a string.

Object::toString javadoc

pub fn equals( &self, other: &Object<'_>, token: &NoException<'env>, ) -> JavaResult<'env, bool>

Compare to another Java object.

Object::equals

Trait Implementations

impl<'env> Cast<'env, Object<'env>> for Class<'env>

Make Class castable to Object.

fn cast<'a>(&'a self) -> &'a Object<'env>

Cast the object to itself or one of it’s superclasses.

impl<'env> Cast<'env, Object<'env>> for Object<'env>

Make Object castable to itself.

fn cast<'a>(&'a self) -> &'a Object<'env>

Cast the object to itself or one of it’s superclasses.

impl<'env> Cast<'env, Object<'env>> for String<'env>

Make String castable to Object.

fn cast<'a>(&'a self) -> &'a Object<'env>

Cast the object to itself or one of it’s superclasses.

impl<'env> Cast<'env, Object<'env>> for Throwable<'env>

Make Throwable castable to Object.

fn cast<'a>(&'a self) -> &'a Object<'env>

Cast the object to itself or one of it’s superclasses.

impl<'env> Debug for Object<'env>

Allow displaying Java objects for debug purposes.

Object::toString

This is mostly a convenience for debugging. Always prefer using to_string to printing the object as is, because the former checks for a pending exception in compile-time rather than the run-time.

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

Formats the value using the given formatter.

impl<'env> Display for Object<'env>

Allow displaying Java objects.

Object::toString javadoc

This is mostly a convenience for debugging. Always prefer using to_string to printing the object as is, because the former checks for a pending exception in compile-time rather than the run-time.

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

Formats the value using the given formatter.

impl<'env> Drop for Object<'env>

Make Object-s reference be deleted when the value is dropped.

JNI documentation

fn drop(&mut self)

Executes the destructor for this type.

impl<'env, T> PartialEq<T> for Object<'env>

where T: Cast<'env, Object<'env>>,

Allow comparing Object to Java objects. Java objects are compared by-reference to preserve original Java semantics. To compare objects by value, call the equals method.

Will panic if there is a pending exception in the current thread.

This is mostly a convenience for using assert_eq!() in tests. Always prefer using is_same_as to comparing with ==, because the former checks for a pending exception in compile-time rather than the run-time.

fn eq(&self, other: &T) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'env> Eq for Object<'env>

Allow comparing Object to Java objects. Java objects are compared by-reference to preserve original Java semantics. To compare objects by value, call the equals method.

Will panic if there is a pending exception in the current thread.

This is mostly a convenience for using assert_eq!() in tests. Always prefer using is_same_as to comparing with ==, because the former checks for a pending exception in compile-time rather than the run-time.

impl<'a> JavaType for Object<'a>

Make Object mappable to jobject.