Skip to main content

spawn_thread

Function spawn_thread 

Source
pub fn spawn_thread<A, F>(name: &str, factory: F) -> ActorHandle<A>
where A: ThreadActor + 'static, F: FnOnce() -> A + Send + 'static,
Expand description

在一条新线程上启动 actor。

§为什么是工厂而不是实例

!Send 的 actor 无法被搬进 std::thread 的闭包(E0277),所以 actor 必须在 新线程内部构造。传给闭包的只有构造它所需的数据,那些必须是 Send。

主线程                     新线程
spawn_thread(name, f)  →  let actor = f();     ← !Send 资源在这里出生
                           ctx/handle 建好
recv(handle) ←──────────── handle 回传

返回前会阻塞等 handle 回传(μs 级),所以返回的 handle 一定带着初始化好的 state。

如果你的 actor 是 Send 的,也可以用更顺手的方法形式:ThreadActor::spawn_thread。

§Panic

启动失败会 panic(expect),需要优雅处理请改用 try_spawn_thread。 run 里的 panic 不会传播:被 catch_unwind 兜住,只记一条 error 日志, 之后 ActorHandle::is_alive 变 false、send_cmd 返回 Err。