Struct actix::registry::Registry

pub struct Registry { /* fields omitted */ }

Actors registry

An Actor can register itself as a service. A Service can be defined as an ArbiterService, which is unique per arbiter, or a SystemService, which is unique per system.

If an arbiter service is used outside of a running arbiter, it panics.

Examples

use actix::prelude::*;

#[derive(Message)]
#[rtype(result = "()")]
struct Ping;

#[derive(Default)]
struct MyActor1;

impl Actor for MyActor1 {
    type Context = Context<Self>;
}
impl actix::Supervised for MyActor1 {}

impl ArbiterService for MyActor1 {
   fn service_started(&mut self, ctx: &mut Context<Self>) {
      println!("Service started");
   }
}

impl Handler<Ping> for MyActor1 {
   type Result = ();

   fn handle(&mut self, _: Ping, ctx: &mut Context<Self>) {
      println!("ping");
   }
}

struct MyActor2;

impl Actor for MyActor2 {
   type Context = Context<Self>;

   fn started(&mut self, _: &mut Context<Self>) {
      // get MyActor1 address from the registry
      let act = MyActor1::from_registry();
      act.do_send(Ping);
   }
}

fn main() {
    // initialize system
    let code = System::new().block_on(async {
        // Start MyActor2 in new Arbiter
        Arbiter::new().spawn_fn(|| {
            MyActor2.start();
        });
    });
}

Implementations

impl Registry

pub fn get<A: ArbiterService + Actor<Context = Context<A>>>(&self) -> Addr<A>

Query registry for specific actor. Returns address of the actor. If actor is not registered, starts new actor and return address of newly created actor.

pub fn query<A: ArbiterService + Actor<Context = Context<A>>>(
    &self
) -> Option<Addr<A>>

Check if actor is in registry, if so, return its address

pub fn set<A: ArbiterService + Actor<Context = Context<A>>>(addr: Addr<A>)

Add new actor to the registry by address, panic if actor is already running

Trait Implementations

impl Clone for Registry

fn clone(&self) -> Registry

Returns a copy of the value.

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

Performs copy-assignment from source.