Struct Client 

pub struct Client { /* private fields */ }

A scoped caller context.

Dropping the last clone of a client closes its mailbox. Messages already accepted into port receivers remain available; later deliveries to the client’s ports fail as ordinary closed-mailbox deliveries.

Implementations

impl Client

pub fn self_addr(&self) -> &ActorAddr

This client’s actor address.

pub fn proc(&self) -> &Proc

The proc that owns this client.

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

Open a new port that accepts M-typed messages.

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

Open a new one-shot port that accepts an M-typed message.

pub fn bind_handler_port<M: RemoteMessage>( &self, ) -> (PortHandle<M>, PortReceiver<M>)

Bind a handler port to this client.

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

Bind this client as an actor ref.

pub fn child(&self) -> Client

Create a new direct child client.

pub fn spawn<A: Actor>(&self, actor: A) -> ActorHandle<A>

Spawn a child actor with a fresh uid labeled from the actor type.

pub fn spawn_with_label<A: Actor>( &self, label: &str, actor: A, ) -> ActorHandle<A>

Spawn a child actor with a fresh uid carrying a display label.

pub fn spawn_with_uid<A: Actor>( &self, uid: Uid, actor: A, ) -> Result<ActorHandle<A>>

Spawn a child actor using an explicit uid.

pub async fn gspawn( &self, actor_type: &str, params: Data, ) -> Result<AnyActorHandle>

Spawn a registered actor as this client’s child.

pub async fn gspawn_uid( &self, actor_type: &str, uid: Uid, params: Data, ) -> Result<AnyActorHandle>

Spawn a registered actor as this client’s child using an explicit uid.

pub fn sequencer(&self) -> &Sequencer

Return this client’s sequencer.

pub fn status(&self) -> Receiver<ActorStatus>

The client’s lifecycle status.

Trait Implementations

impl Actor for &Client

type A = ClientActor

The type of actor associated with this context.

fn instance(&self) -> &Instance<ClientActor>

The instance associated with this context.

fn spawn<C: Actor>(&self, actor: C) -> ActorHandle<C>

where Self: Sized,

Spawn a child actor under this actor context.

fn spawn_with_label<C: Actor>(&self, label: &str, actor: C) -> ActorHandle<C>

where Self: Sized,

Spawn a child actor with a fresh uid carrying a display label.

fn spawn_with_uid<C: Actor>(&self, uid: Uid, actor: C) -> Result<ActorHandle<C>>

where Self: Sized,

Spawn a child actor using an explicit uid.

fn headers(&self) -> &Flattrs

The inbound message headers associated with this context, if any.

impl Actor for Client

type A = ClientActor

The type of actor associated with this context.

fn instance(&self) -> &Instance<ClientActor>

The instance associated with this context.

fn spawn<C: Actor>(&self, actor: C) -> ActorHandle<C>

where Self: Sized,

Spawn a child actor under this actor context.

fn spawn_with_label<C: Actor>(&self, label: &str, actor: C) -> ActorHandle<C>

where Self: Sized,

Spawn a child actor with a fresh uid carrying a display label.

fn spawn_with_uid<C: Actor>(&self, uid: Uid, actor: C) -> Result<ActorHandle<C>>

where Self: Sized,

Spawn a child actor using an explicit uid.

fn headers(&self) -> &Flattrs

The inbound message headers associated with this context, if any.

impl Clone for Client

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.

impl Mailbox for &Client

fn mailbox(&self) -> &Mailbox

The mailbox associated with this context

impl Mailbox for Client

fn mailbox(&self) -> &Mailbox

The mailbox associated with this context