Struct acteur::Assistant

pub struct Assistant<A: Actor> { /* fields omitted */ }

This object is provided to the handle method in the Receive trait for each message that an Actor receives. The Actor's assistant allows to send messages and to execute some task over the system.

#[derive(Debug)]
struct SalaryChanged(u32);

#[derive(Debug)]
struct SayByeForever(String);

#[async_trait]
impl Receive<SalaryChanged> for Employee {
    async fn handle(&mut self, message: SalaryChanged, assistant: &Assistant<Employee>) {
        if self.salary > message.0 {
            assistant.send::<Manager, SayByeForever>(self.manager_id, SayByeForever("Betrayer!".to_string()));
        }
         
        self.salary = message.0;
    }
}

Methods

impl<A: Actor> Assistant<A>

pub async fn send<'_, A2: Actor + Receive<M>, M: Debug + Send + 'static>(
    &'_ self,
    actor_id: A2::Id,
    message: M
)

Sends a message to the Actor with the specified Id. If the Actor is not loaded, it will load the actor before, calling its method activate

pub async fn call<'_, '_, A2: Actor + Respond<M>, M: Debug + Send + 'static>(
    &'_ self,
    actor_id: A2::Id,
    message: M
) -> Result<<A2 as Respond<M>>::Response, &'_ str>

Sends a message to the Actor with the specified Id and waits the actor's response . If the Actor is not loaded, it will load the actor before, calling its method activate

pub async fn stop<'_>(&'_ self)

Enqueues a end command in the Actor messages queue. The actor will consume all mesages before ending. Keep in mind that event is an actor is stopped, a new message in the future can wake up the actor.

pub fn stop_system(&self)

Send an stop message to all actors in the system. Actors will process all the enqued messages before stop

Trait Implementations

impl<A: Actor> Clone for Assistant<A>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<A: Actor> Debug for Assistant<A>

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

Formats the value using the given formatter.