Struct ActorRef

pub struct ActorRef { /* private fields */ }

An ActorRef is the way used to interract with something that acts as an actor.

This can represent either an ACtor, a Future or Cthulhu (the original actor) whether distant or local.

It gives the Actor API, it can receive messages, be told to send messages, be asked something and give its ActorPath.

Implementations

impl ActorRef

pub fn new_distant(path: Arc<ActorPath>) -> ActorRef

Creates a new ActorRef to a distant actor, with the given ActorPath.

pub fn with_cthulhu(cthulhu: Cthulhu) -> ActorRef

Creates a new ActorRef to Cthulhu, this should only be called once.

pub fn with_cell(cell: ActorCell, path: Arc<ActorPath>) -> ActorRef

Creates a new ActorRef for a local Actor, with the given ActorCell.

pub fn receive_system_message(&self, system_message: SystemMessage)

Receives a system message such as Start, Restart or a Failure(ActorRef), puts it in the system mailbox and schedules the actor if needed.

pub fn receive(&self, message: InnerMessage, sender: ActorRef)

Receives a regular message and puts it in the mailbox and schedules the actor if needed.

pub fn handle(&self)

Handles a messages by calling the receive method of the underlying actor.

pub fn path(&self) -> Arc<ActorPath>

Gives a clone of the ActorPath.

pub fn tell_to<MessageTo: Message>(&self, to: ActorRef, message: MessageTo)

Makes this ActorRef send a message to anther ActorRef.

Trait Implementations

impl Clone for ActorRef

fn clone(&self) -> ActorRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.