Struct Context 

pub struct Context<M: Message, L = M> {
    pub id: ActorId,
    pub episode: Uuid,
    /* private fields */
}

The ways out of an actor: what a Behavior may do besides answer.

A behavior owns one of these, and the actor keeps the mailbox, so messages reach the behavior one step at a time.

L is what this actor logs. It defaults to the message type, which is what most actors log.

Fields

id: ActorId

This actor’s name, as the other actors know it.

episode: Uuid

The episode this actor is in, stamped on everything it logs.

Implementations

impl<M: Message, L> Context<M, L>

pub fn log(&self, payload: L)

Log payload as an event stamped now. The event reaches the log when this actor holds a logger and the log is listening; otherwise it is dropped, and the actor carries on either way.

pub fn send(&self, message: M, to: HashSet<ActorId>) -> Result<()>

Send the statement message to every actor in to. An actor that has already stopped is skipped. An actor may send to itself: the message waits in its own mailbox for the current step to finish.

Errors

Fails before anything is sent when to names an actor outside those this one may send to.

pub async fn request( &self, message: M, to: HashSet<ActorId>, ) -> Result<HashMap<ActorId, Vec<M>>>

Ask every actor in to the same thing and collect their replies. A recipient that has stopped, before or after receiving the request, is left out of the result.

Errors

Fails before anything is sent when to names an actor outside those this one may send to, or names this actor itself, which is busy with this very step.

pub fn stop(&self, who: &ActorId) -> Result<()>

Stop another actor at once, wherever it is in its step.

Errors

Fails when who is outside the actors this one may shut down.

pub fn shutdown(&self)

Shut this actor down. The step that calls this is abandoned at its next await, so a behavior with last words says them first. The actor then stops, leaving whatever is in its mailbox there.