Struct Context 

pub struct Context<S: Service<Context = Self>> { /* private fields */ }

A service context.

Any service that is spawned onto a Runtime needs to have this type as context.

Implementations

impl<S: Service<Context = Self>> Context<S>

pub fn this(&self) -> Addr<S>

Get the address of this service.

Beware that if you use this to send a message to yourself (with Addr::send), you will encounter a deadlock because to handle a message you need send a message, which just makes the message handler never finish.

pub fn spawn<F: Future + 'static>(&self, fut: F) -> JoinHandle<F::Output>

Spawn a future onto the current arbiter.

pub async fn try_singleton<T: Service<Context = Context<T>> + Any>( &self, ) -> Result<Addr<T>, SingletonError>

Try to retrieve the address of a singleton service T. If there are more than one or no instances of T running, this method will return a SingletonError.

pub async fn singleton<T: Service<Context = Context<T>> + Any>(&self) -> Addr<T>

Retrieve an address to the singleton service T. This method panics if the service wasn’t running or there were more than one instance of it.

Examples found in repository

examples/ping.rs (line 67)

    async fn call(&mut self, _ping: Ping, cx: &mut Self::Context) -> Result<Pong, Self::Error> {
        cx.singleton::<Printer>()
            .await
            .send(format!("ping #{}", self.count))
            .await?;

        self.count += 1;

        Ok(Pong(self.count))
    }