Struct SupervisorState

pub struct SupervisorState {
    pub child_specs: Vec<ChildSpec>,
    pub child_failure_state: HashMap<String, ChildFailureState>,
    pub restart_log: Vec<RestartLog>,
    pub options: SupervisorOptions,
}

Holds the supervisor’s live state: which children are running, how many times each child has failed, etc.

Important

The child_specs vector maintains the startup order of children which is critical for strategies like RestForOne that rely on child ordering.

Fields

child_specs: Vec<ChildSpec>

The original child specs (each child’s config).

child_failure_state: HashMap<String, ChildFailureState>

Tracks how many times each child has failed and the last time it failed.

restart_log: Vec<RestartLog>

Rolling log of all restarts in the meltdown window.

options: SupervisorOptions

Supervisor meltdown options.

Implementations

impl SupervisorState

pub async fn spawn_child( &mut self, child_spec: &ChildSpec, myself: ActorRef<SupervisorMsg>, ) -> Result<(), ActorProcessingErr>

pub async fn spawn_all_children( &mut self, myself: ActorRef<SupervisorMsg>, ) -> Result<(), ActorProcessingErr>

Spawn all children in the order they were defined in SupervisorArguments::child_specs.

pub async fn perform_one_for_one_spawn( &mut self, child_id: &str, myself: ActorRef<SupervisorMsg>, ) -> Result<(), ActorProcessingErr>

OneForOne: meltdown-check first, then spawn just the failing child.

pub async fn perform_one_for_all_spawn( &mut self, child_id: &str, myself: ActorRef<SupervisorMsg>, ) -> Result<(), ActorProcessingErr>

OneForAll: meltdown-check first, then stop all children, re-spawn them all.

pub async fn perform_rest_for_one_spawn( &mut self, child_id: &str, myself: ActorRef<SupervisorMsg>, ) -> Result<(), ActorProcessingErr>

RestForOne: meltdown-check first, then stop the failing child and all subsequent children, re-spawn them.

Trait Implementations

impl Clone for SupervisorState

fn clone(&self) -> SupervisorState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl SupervisorCore for SupervisorState

type Message = SupervisorMsg

type Options = SupervisorOptions

type Strategy = SupervisorStrategy

fn child_failure_state(&mut self) -> &mut HashMap<String, ChildFailureState>

fn restart_log(&mut self) -> &mut Vec<RestartLog>

fn options(&self) -> &SupervisorOptions

fn restart_msg( &self, child_spec: &ChildSpec, strategy: SupervisorStrategy, _myself: ActorRef<SupervisorMsg>, ) -> SupervisorMsg

fn prepare_child_failure( &mut self, child_spec: &ChildSpec, ) -> Result<(), ActorProcessingErr>

Increments the failure count for a given child.
Resets the child’s restart_count to 0 if the time since last fail >= child’s reset_after duration.

fn handle_child_exit( &mut self, child_spec: &ChildSpec, abnormal: bool, ) -> Result<bool, ActorProcessingErr>

Called when a child terminates or fails.

fn handle_child_restart( &mut self, child_spec: &ChildSpec, abnormal: bool, myself: ActorRef<Self::Message>, reason: &ExitReason, ) -> Result<(), ActorProcessingErr>

Called when a child exits abnormally or normally.

fn track_global_restart( &mut self, child_id: &str, ) -> Result<(), ActorProcessingErr>

Updates meltdown log and checks meltdown thresholds.

fn schedule_restart( &mut self, child_spec: &ChildSpec, strategy: Self::Strategy, myself: ActorRef<Self::Message>, ) -> Result<(), ActorProcessingErr>

Schedule a future spawn for a child, respecting any child-level backoff_fn.