Struct StateUnits

pub struct StateUnits { /* private fields */ }

A set of state units.

Implementations

impl StateUnits

pub fn new() -> Self

Creates a new instance with no initial units.

pub fn inspector(&self) -> StateUnitsInspector

Returns an inspector that can be used to inspect the state units while state transitions are in process.

pub fn add(&self, name: impl Into<Arc<str>>) -> UnitBuilder<'_>

Save and restore will use name as the save ID, so this forms part of the saved state.

Note that the added unit will not be running after it is built/spawned, even if the other units are running. Call StateUnits::start_stopped_units when finished adding units.

pub fn is_running(&self) -> bool

Check if state units are currently running.

pub async fn start_stopped_units(&mut self)

Starts any units that are individually stopped, because they were added via StateUnits::add while the VM was running.

Does nothing if all units are stopped, via StateUnits::stop.

pub async fn start(&mut self)

Starts all the state units.

pub async fn stop(&mut self)

Stops all the state units.

pub async fn reset(&mut self) -> Result<(), StateTransitionError>

Resets all the state units.

Panics if running.

pub async fn save( &mut self, ) -> Result<Vec<SavedStateUnit>, StateTransitionError>

Saves all the state units.

Panics if running.

pub async fn restore( &mut self, states: Vec<SavedStateUnit>, ) -> Result<(), StateTransitionError>

Restores all the state units.

Panics if running.

Trait Implementations

impl Debug for StateUnits

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Inspect for StateUnits

fn inspect(&self, req: Request<'_>)

Inspects the object.