Skip to main content

ThreadActor

Trait ThreadActor 

Source
pub trait ThreadActor: ActorCore {
    // Required method
    fn run(self, ctx: ActorContext<Self>);

    // Provided method
    fn spawn_thread(self, name: &str) -> ActorHandle<Self>
       where Self: Send + 'static { ... }
}
Expand description

actor 的线程壳。允许 !Send 的资源(GPU 句柄、Rc<RefCell<_>>、阻塞式第三方库)。

不用 Send:整个 actor 只会被搬到一条新线程的栈上,从不跨线程移动。

Required Methods§

Source

fn run(self, ctx: ActorContext<Self>)

actor 的主循环,阻塞签名。

典型写法:

impl ThreadActor for Player {
    fn run(self, mut ctx: ActorContext<Self>) {
        loop {
            match ctx.recv_cmd_timeout(Duration::from_millis(8)) {
                Ok(_cmd) => { /* 处理命令 */ }
                Err(CmdWait::Timeout) => { /* 周期性工作:出帧 / 上报进度 */ }
                Err(CmdWait::Closed) => break,   // stop() 或所有 handle 都没了
                _ => break,                      // CmdWait 是 non_exhaustive,留个兜底
            }
        }
    }
}

Provided Methods§

Source

fn spawn_thread(self, name: &str) -> ActorHandle<Self>
where Self: Send + 'static,

在一条新线程上启动 actor,返回控制端。

只对 Send 的 actor 可用。 !Send 的 actor(Rc<...>、GPU 句柄、 阻塞式第三方运行时)不能这样起 —— 实例没法搬进 std::thread 的闭包 (error[E0277]: cannot be sent between threads safely), 请改用 spawn_thread 传工厂,让 actor 在新线程内部构造。

// Worker 是 Send(没有 Rc 之类)→ 可以直接用方法形式
let handle = Worker.spawn_thread("worker");
handle.stop();

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors§