Struct ActorRef 

pub struct ActorRef<A: Actor> {
    pub label: String,
    pub node_id: String,
    /* private fields */
}

A serializable, typed reference to an actor. Can be embedded in messages and sent across the wire to other nodes.

Usage

// Create from context inside a handler
let my_ref = ctx.actor_ref();

// Or create directly
let actor_ref = ActorRef::<CounterActor>::new("counter/main", "node-1");

// Serialize and send across the wire (e.g., in a message field)
let encoded = bincode::serde::encode_to_vec(&actor_ref, bincode::config::standard())?;

// On the receiving side, resolve to a live endpoint
let endpoint = actor_ref.resolve(&receptionist).unwrap();
let count = endpoint.send(GetCount).await?;

Fields

label: String

node_id: String

Implementations

impl<A: Actor + 'static> ActorRef<A>

pub fn new(label: impl Into<String>, node_id: impl Into<String>) -> Self

Create a new ActorRef with the given label and node ID.

pub fn resolve(&self, receptionist: &Receptionist) -> Option<Endpoint<A>>

Resolve this reference to a live Endpoint via the receptionist. Returns None if the actor is not registered or has a different type.

Trait Implementations

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

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<A: Debug + Actor> Debug for ActorRef<A>

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

Formats the value using the given formatter.

impl<'de, A: Actor> Deserialize<'de> for ActorRef<A>

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl<A: Actor> Serialize for ActorRef<A>

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.