Struct j4rs::Jvm

pub struct Jvm { /* fields omitted */ }

Holds the assets for the JVM

Methods

impl Jvm

pub fn new(
    jvm_options: &[String],
    lib_name_to_load: Option<String>
) -> Result<Jvm>

Creates a new Jvm.

pub fn attach_thread() -> Result<Jvm>

Attaches the current thread to an active JavaVM

pub fn detach_thread_on_drop(&mut self, detach: bool)

If true, the thread will not be detached when the Jvm is eing dropped. This is useful when creating a Jvm while on a Thread that is created in the Java world. When this Jvm is dropped, we don't want to detach the thread from the Java VM.

It prevents errors like: attempting to detach while still running code

pub fn try_from(jni_environment: *mut JNIEnv) -> Result<Jvm>

pub fn create_instance(
    &self,
    class_name: &str,
    inv_args: &[InvocationArg]
) -> Result<Instance>

Creates an Instance of the class class_name, passing an array of InvocationArgs to construct the instance.

pub fn invoke(
    &self,
    instance: &Instance,
    method_name: &str,
    inv_args: &[InvocationArg]
) -> Result<Instance>

Invokes the method method_name of a created Instance, passing an array of InvocationArgs. It returns an Instance as the result of the invocation.

pub fn invoke_async(
    &self,
    instance: &Instance,
    method_name: &str,
    inv_args: &[InvocationArg],
    callback: Callback
) -> Result<()>

Deprecated since 0.2.0:

please use invoke_to_channel instead

Invokes asynchronously the method method_name of a created Instance, passing an array of InvocationArgs. It returns void and the Instance of the result of the async invocation will come in the defined callback.

pub fn invoke_to_channel(
    &self,
    instance: &Instance,
    method_name: &str,
    inv_args: &[InvocationArg]
) -> Result<InstanceReceiver>

Invokes the method method_name of a created Instance, passing an array of InvocationArgs. It returns a Result of InstanceReceiver that may be used to get an underlying Receiver<Instance>. The result of the invocation will come via this Receiver.

pub fn init_callback_channel(
    &self,
    instance: &Instance
) -> Result<InstanceReceiver>

pub fn invoke_static(
    &self,
    class_name: &str,
    method_name: &str,
    inv_args: &[InvocationArg]
) -> Result<Instance>

Invokes the static method method_name of the class class_name, passing an array of InvocationArgs. It returns an Instance as the result of the invocation.

pub fn clone_instance(&self, instance: &Instance) -> Result<Instance>

Creates a clone of the provided Instance

pub fn cast(&self, from_instance: &Instance, to_class: &str) -> Result<Instance>

Invokes the static method method_name of the class class_name, passing an array of InvocationArgs. It returns an Instance as the result of the invocation.

pub fn to_rust<T>(&self, instance: Instance) -> Result<T> where
    T: DeserializeOwned, 

Returns the Rust representation of the provided instance

pub fn to_rust_string(&self, java_string: jstring) -> Result<String>

Trait Implementations

impl Clone for Jvm

fn clone(&self) -> Jvm

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Drop for Jvm

fn drop(&mut self)

Executes the destructor for this type.