Struct OnionAsyncHandle

pub struct OnionAsyncHandle { /* private fields */ }

Onion 异步任务句柄。

封装异步任务的状态与结果，支持线程安全的并发访问。 通过内部弱引用缓存任务结果，避免循环引用导致的内存泄漏。

字段

• inner: (弱引用结果, 完成状态) 的互斥封装

Implementations

impl OnionAsyncHandle

pub fn new(gc: &mut GC<OnionObjectCell>) -> (Arc<Self>, GCArcStorage)

创建一个新的异步句柄（未完成状态）。

参数

• gc: Onion GC 管理器，用于分配初始结果对象

返回

• (Arc<Self>, GCArcStorage): 新的异步句柄和对应的 GC 存储

pub fn is_finished(&self) -> bool

检查异步任务是否已完成。

返回

• true: 任务已完成
• false: 任务仍在进行中

pub fn set_result(&self, result: &OnionObject) -> Result<(), RuntimeError>

设置异步任务的结果。

线程安全地将结果写入内部缓存，并标记为完成。 幂等操作，多次调用只会以最后一次为准。

参数

• result: 要设置的任务结果对象

返回

• Ok(()): 设置成功
• Err(RuntimeError): 异步句柄已失效或引用断裂

pub fn set_finished(&self)

仅设置任务为完成状态，不写入结果。

适用于无返回值的异步任务。

Trait Implementations

impl Debug for OnionAsyncHandle

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

Formats the value using the given formatter.

impl GCTraceable<OnionObjectCell> for OnionAsyncHandle

fn collect(&self, queue: &mut VecDeque<GCArcWeak<OnionObjectCell>>)

collects all reachable objects and adds them to the provided queue.

impl OnionObjectExt for OnionAsyncHandle

fn as_any(&self) -> &dyn Any

fn repr(&self, _ptrs: &Vec<*const OnionObject>) -> Result<String, RuntimeError>

fn equals(&self, _other: &OnionObject) -> Result<bool, RuntimeError>

fn upgrade(&self, collected: &mut Vec<GCArc<OnionObjectCell>>)

fn to_boolean(&self) -> Result<bool, RuntimeError>

fn type_of(&self) -> Result<String, RuntimeError>

fn value_of(&self) -> Result<OnionStaticObject, RuntimeError>

fn to_string( &self, ptrs: &Vec<*const OnionObject>, ) -> Result<String, RuntimeError>

fn with_attribute( &self, key: &OnionObject, f: &mut dyn FnMut(&OnionObject) -> Result<(), RuntimeError>, ) -> Result<(), RuntimeError>

fn to_integer(&self) -> Result<i64, RuntimeError>

fn to_float(&self) -> Result<f64, RuntimeError>

fn to_bytes(&self) -> Result<Box<[u8]>, RuntimeError>

fn len(&self) -> Result<OnionStaticObject, RuntimeError>

fn contains(&self, other: &OnionObject) -> Result<bool, RuntimeError>

fn apply(&self, value: &OnionObject) -> Result<OnionStaticObject, RuntimeError>

fn key_of(&self) -> Result<OnionStaticObject, RuntimeError>

fn binary_eq(&self, other: &OnionObject) -> Result<bool, RuntimeError>

fn binary_lt(&self, other: &OnionObject) -> Result<bool, RuntimeError>

fn binary_gt(&self, other: &OnionObject) -> Result<bool, RuntimeError>

fn binary_add( &self, other: &OnionObject, ) -> Result<OnionStaticObject, RuntimeError>

fn binary_sub( &self, other: &OnionObject, ) -> Result<OnionStaticObject, RuntimeError>

fn binary_mul( &self, other: &OnionObject, ) -> Result<OnionStaticObject, RuntimeError>

fn binary_div( &self, other: &OnionObject, ) -> Result<OnionStaticObject, RuntimeError>

fn binary_mod( &self, other: &OnionObject, ) -> Result<OnionStaticObject, RuntimeError>

fn binary_pow( &self, other: &OnionObject, ) -> Result<OnionStaticObject, RuntimeError>

fn binary_and( &self, other: &OnionObject, ) -> Result<OnionStaticObject, RuntimeError>

fn binary_or( &self, other: &OnionObject, ) -> Result<OnionStaticObject, RuntimeError>

fn binary_xor( &self, other: &OnionObject, ) -> Result<OnionStaticObject, RuntimeError>

fn binary_shl( &self, other: &OnionObject, ) -> Result<OnionStaticObject, RuntimeError>

fn binary_shr( &self, other: &OnionObject, ) -> Result<OnionStaticObject, RuntimeError>

fn unary_neg(&self) -> Result<OnionStaticObject, RuntimeError>

fn unary_plus(&self) -> Result<OnionStaticObject, RuntimeError>

fn unary_not(&self) -> Result<OnionStaticObject, RuntimeError>