Struct rust_jni::java::lang::Throwable

pub struct Throwable<'env> { /* fields omitted */ }

A type representing a Java Throwable.

Methods

impl<'env> Throwable<'env>

pub fn throw(self, token: NoException) -> Exception<'env>

Throw the exception. Transfers ownership of the object to Java.

JNI documentation

impl<'env> Throwable<'env>

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

Get the Java class object for Throwable .

Object::getClass javadoc

pub fn new(     env: &'env JniEnv<'env>,     message: &String<'env>,     token: &NoException<'env> ) -> JavaResult<'env, Self>

Create a new Throwable with a message.

Throwable(String) javadoc

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

Get the exception message.

Throwable::getMessage javadoc.

impl<'env> Throwable<'env>

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

Clone the Throwable . 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

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

Convert the object to a string.

Object::toString javadoc

Methods from Deref<Target = 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

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> Debug for Throwable<'env>

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

Formats the value using the given formatter.

impl<'a> JavaType for Throwable<'a>

Make Throwable mappable to jobject.

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

Make Throwable castable to itself.

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

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

impl<'env> Eq for Throwable<'env>

Allow comparing Throwable 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<'env> Deref for Throwable<'env>

Allow Throwable to be used in place of an Object.

type Target = Object<'env>

The resulting type after dereferencing.

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

Dereferences the value.

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, T> PartialEq<T> for Throwable<'env> where     T: Cast<'env, Object<'env>>,

Allow comparing Throwable 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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl<'env> Display for Throwable<'env>

Allow displaying Throwable .

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.