Skip to main content

Module manager

Module manager 

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

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

Enums§

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