Struct Instance

pub struct Instance<A: Actor> { /* private fields */ }

An actor instance. This is responsible for managing a running actor, including its full lifecycle, supervision, signal management, etc. Instances can represent a managed actor or a “client” actor that has joined the proc.

Implementations

impl<A: Actor> Instance<A>

pub fn self_id(&self) -> &ActorId

This instance’s actor ID.

pub fn stop(&self) -> Result<(), ActorError>

Signal the actor to stop.

pub fn open_port<M: Message>(&self) -> (PortHandle<M>, PortReceiver<M>)

Open a new port that accepts M-typed messages. The returned port may be freely cloned, serialized, and passed around. The returned receiver should only be retained by the actor responsible for processing the delivered messages.

pub fn open_once_port<M: Message>( &self, ) -> (OncePortHandle<M>, OncePortReceiver<M>)

Open a new one-shot port that accepts M-typed messages. The returned port may be used to send a single message; ditto the receiver may receive a single message.

pub fn post(&self, port_id: PortId, headers: Attrs, message: Serialized)

Send a message to the actor running on the proc.

pub fn self_message_with_delay<M>( &self, message: M, delay: Duration, ) -> Result<(), ActorError>

where M: Message, A: Handler<M>,

Send a message to the actor itself with a delay usually to trigger some event.

pub fn port<M: Message>(&self) -> PortHandle<M>

where A: Handler<M>,

Return a handle port handle representing the actor’s message handler for M-typed messages.

pub fn handle(&self) -> ActorHandle<A>

The ActorHandle corresponding to this instance.

pub fn bind<R: Binds<A>>(&self) -> ActorRef<R>

The owning actor ref.

pub fn clock(&self) -> &(impl Clock + use<A>)

A reference to the proc’s clock

pub fn proc(&self) -> &Proc

The owning proc.

Trait Implementations

impl<A: Actor> Drop for Instance<A>

fn drop(&mut self)

Executes the destructor for this type.