Struct riker::actor::Props

pub struct Props;

Provides instances of ActorProducer for use when creating Actors (actor_of).

Actors are not created directly. Instead you provide an ActorProducer that allows the ActorSystem to start an actor when actor_of is used, or when an actor fails and a supervisor requests an actor to be restarted.

ActorProducer can hold values required by the actor's factory method parameters.

Methods

impl Props

pub fn new<A, F>(creator: F) -> Arc<Mutex<impl ActorProducer<Actor = A>>> where
    A: Actor + Send + 'static,
    F: Fn() -> A + Send + 'static, 

Creates an ActorProducer with no factory method parameters.

Examples

struct User;

impl User {
    fn actor() -> Self {
        User
    }
}

// main
let sys = ActorSystem::new().unwrap();

let props = Props::new(User::actor);

// start the actor and get an `ActorRef`
let actor = sys.actor_of(props, "user").unwrap();

pub fn new_args<A, Args, F>(
    creator: F,
    args: Args
) -> Arc<Mutex<impl ActorProducer<Actor = A>>> where
    A: Actor + Send + 'static,
    Args: ActorArgs + 'static,
    F: Fn(Args) -> A + Send + 'static, 

Creates an ActorProducer with one or more factory method parameters.

Examples

An actor requiring a single parameter.

struct User {
    name: String,
}

impl User {
    fn actor(name: String) -> Self {
        User {
            name
        }
    }
}

// main
let sys = ActorSystem::new().unwrap();

let props = Props::new_args(User::actor, "Naomi Nagata".into());

let actor = sys.actor_of(props, "user").unwrap();

An actor requiring multiple parameters.

struct BankAccount {
    name: String,
    number: String,
}

impl BankAccount {
    fn actor((name, number): (String, String)) -> Self {
        BankAccount {
            name,
            number
        }
    }
}

// main
let sys = ActorSystem::new().unwrap();

let props = Props::new_args(BankAccount::actor,
                            ("James Holden".into(), "12345678".into()));

// start the actor and get an `ActorRef`
let actor = sys.actor_of(props, "bank_account").unwrap();