Struct jni::Executor [−][src]
Thread attachment manager. It allows to execute closures in attached threads with automatic
local references management done with with_local_frame
. It combines the performance benefits
of permanent attaches whilst removing the risk of local references leaks if used consistently.
Although all locals are freed on closure exit, it might be needed to manually free locals inside the closure if an unbounded number of them is created (e.g., in a loop). See "Local Reference Management" for details.
Threads using the Executor are attached on the first invocation as daemons, hence they do not block JVM exit. Finished threads detach automatically.
Example
let exec = Executor::new(jvm); let val: jint = exec.with_attached(|env| { let x = JValue::from(-10); let val: jint = env.call_static_method("java/lang/Math", "abs", "(I)I", &[x])? .i()?; Ok(val) })?; assert_eq!(val, 10);
Implementations
impl Executor
[src]
pub fn new(vm: Arc<JavaVM>) -> Self
[src]
Creates new Executor with specified JVM.
pub fn with_attached_capacity<F, R>(&self, capacity: i32, f: F) -> Result<R> where
F: FnOnce(&JNIEnv<'_>) -> Result<R>,
[src]
F: FnOnce(&JNIEnv<'_>) -> Result<R>,
Executes a provided closure, making sure that the current thread is attached to the JVM. Additionally ensures that local object references are freed after call.
Allocates a local frame with the specified capacity.
pub fn with_attached<F, R>(&self, f: F) -> Result<R> where
F: FnOnce(&JNIEnv<'_>) -> Result<R>,
[src]
F: FnOnce(&JNIEnv<'_>) -> Result<R>,
Executes a provided closure, making sure that the current thread is attached to the JVM. Additionally ensures that local object references are freed after call.
Allocates a local frame with the default capacity.
Trait Implementations
Auto Trait Implementations
impl RefUnwindSafe for Executor
[src]
impl Send for Executor
[src]
impl Sync for Executor
[src]
impl Unpin for Executor
[src]
impl UnwindSafe for Executor
[src]
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,