Expand description
Actor 管理器模块。
ActorManager 是一个特殊的 AsyncActor,它管理一组同类型的子 actor,
并聚合它们的状态、进度和事件,对外暴露为单一 actor 接口。
§架构
ActorManager (本身也是 AsyncActor)
├── Child Actor 0 (id=1)
├── Child Actor 1 (id=2)
└── Child Actor 2 (id=3)- 每个子 actor 由
ActorManager启动并分配一个唯一id。 - 管理器自动监听子 actor 的状态、进度和事件,并聚合到自身的
ManagerState和ManagerProgress中。 - 外部通过
ManagerCmd向管理器发送命令:启动/停止子 actor,或转发命令给某个子 actor。
§限制
manager 及其子 actor 目前都要求异步壳(AsyncActor):子 actor 走 tokio::spawn,
聚合用的 tokio::time::interval 也依赖 runtime。因此整个 manager 必须跑在 tokio runtime 里。
§示例
// 创建并启动 manager
let manager = ActorManager::<MyActor>::new();
let handle = manager.spawn();
let (id_tx,id_rx) = tokio::sync::oneshot::channel();
handle.send_cmd(ManagerCmd::SpawnActor{actor:MyActor,id_tx:Some(id_tx)}).unwrap();
let id = id_rx.await.unwrap();
// 读取所有子 actor 的状态
let state: ManagerState<()> = handle.get_state();
assert_eq!(state.len(), 1);
// 向指定子 actor 转发命令
handle.send_cmd(ManagerCmd::Forward { id: 1, cmd: () }).unwrap();
// 停止指定子 actor
handle.send_cmd(ManagerCmd::StopActor(1)).unwrap();Structs§
- Actor
Manager - 子 actor 管理器。
- Manager
Progress - 管理器聚合的所有子 actor 进度。
- Manager
State - 管理器聚合的所有子 actor 状态。
Enums§
- Manager
Cmd - 管理器的命令枚举。
- Manager
Event - 管理器发出的事件枚举。