Skip to main content

Module manager

Module manager 

Source
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§

ActorManager
子 actor 管理器。
ManagerProgress
管理器聚合的所有子 actor 进度。
ManagerState
管理器聚合的所有子 actor 状态。

Enums§

ManagerCmd
管理器的命令枚举。
ManagerEvent
管理器发出的事件枚举。