Expand description
Actor 管理器模块。
ActorManager 是一个特殊的 Actor,它管理一组同类型的子 actor,
并聚合它们的状态、进度和事件,对外暴露为单一 actor 接口。
§架构
ActorManager (本身也是 Actor)
├── 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
let manager = ActorManager::<MyActor>::new();
let handle = manager.spawn();
// 启动一个子 actor
handle.send_cmd(ManagerCmd::SpawnActor(MyActor)).await.unwrap();
// 读取所有子 actor 的状态
let state: ManagerState<()> = handle.get_state();
assert_eq!(state.len(), 1);
// 向指定子 actor 转发命令
handle.send_cmd(ManagerCmd::Forward { id: 1, cmd: () }).await.unwrap();
// 停止指定子 actor
handle.send_cmd(ManagerCmd::StopActor(1)).await.unwrap();Structs§
- Actor
Manager - 子 actor 管理器。
- Manager
Progress - 管理器聚合的所有子 actor 进度。
- Manager
State - 管理器聚合的所有子 actor 状态。
Enums§
- Manager
Cmd - 管理器的命令枚举。
- Manager
Event - 管理器发出的事件枚举。