serviceless 0.5.9

An simple actor model in rust, like actix
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

use futures_util::TryFutureExt;
use std::future::Future;

use crate::{
    envelop::Envelope,
    runtime::{OneshotReceiver, Runtime, UnboundedSender},
    Error, Handler, Message, Result, RoutedTopic, RuntimedService, RuntimedTopicAllHandle, Topic,
};

/// Address of Service
///
/// This address can clone.
pub struct ServiceAddress<S>
where
    S: RuntimedService,
{
    pub(crate) sender: <S::Runtime as Runtime>::UnboundedSender<Envelope<S>>,
}

impl<S> Clone for ServiceAddress<S>
where
    S: RuntimedService,
{
    fn clone(&self) -> Self {
        Self {
            sender: self.sender.clone(),
        }
    }
}

impl<S> ServiceAddress<S>
where
    S: RuntimedService,
{
    /// Return true when service stopped.
    pub fn is_stop(&self) -> bool {
        self.sender.is_closed()
    }

    /// Close the service channel
    pub fn close_service(&self) {
        let _ = self.sender.send(Envelope::StopService);
    }
}

impl<S> ServiceAddress<S>
where
    S: RuntimedService,
{
    /// Call service's handler and get result
    pub async fn call<M>(&self, message: M) -> Result<M::Result>
    where
        M: Message + Send + 'static,
        M::Result: Send,
        S: Handler<M>,
    {
        let (sender, receiver) = <S::Runtime as Runtime>::oneshot::<M::Result>();

        let env = Envelope::new_with_result_channel(message, Some(sender));

        self.sender.send(env).map_err(|_| Error::ServiceStoped)?;

        receiver.recv().await.map_err(|_| Error::ServiceStoped)
    }

    pub fn call_raw<M>(
        &self,
        message: M,
    ) -> Result<<S::Runtime as Runtime>::OneshotReceiver<M::Result>>
    where
        M: Message + Send + 'static,
        M::Result: Send,
        S: Handler<M>,
    {
        let (sender, receiver) = <S::Runtime as Runtime>::oneshot::<M::Result>();

        let env = Envelope::new_with_result_channel(message, Some(sender));

        self.sender.send(env).map_err(|_| Error::ServiceStoped)?;

        Ok(receiver)
    }

    /// Call service's handler without result
    ///
    /// Because this function don't need result, so it can call without async.
    pub fn send<M>(&self, message: M) -> Result<()>
    where
        M: Message + Send + 'static,
        M::Result: Send,
        S: Handler<M>,
    {
        let env = Envelope::new(message);

        self.sender.send(env).map_err(|_| Error::ServiceStoped)?;

        Ok(())
    }

    /// Subscribe once to a specific topic value.
    ///
    /// One call waits for one future publication.
    pub fn subscribe<T>(&self, topic: T) -> Result<impl Future<Output = Result<T::Item>> + Send>
    where
        T: Topic + RoutedTopic<S>,
    {
        let (sender, receiver) = <S::Runtime as Runtime>::oneshot::<T::Item>();
        let env = Envelope::<S>::new_subscribe_topic::<T>(topic, sender);

        self.sender.send(env).map_err(|_| Error::ServiceStoped)?;

        Ok(receiver.recv().map_err(|_| Error::ServiceStoped))
    }

    pub fn subscribe_all<T>(&self, topic: T) -> Result<RuntimedTopicAllHandle<T, S::Runtime>>
    where
        T: Topic + RoutedTopic<S>,
    {
        let (sender, receiver) = <S::Runtime as Runtime>::unbounded::<T::Item>();
        let env = Envelope::<S>::new_subscribe_all_topic::<T>(topic, sender);
        self.sender.send(env).map_err(|_| Error::ServiceStoped)?;
        Ok(RuntimedTopicAllHandle::new(receiver))
    }
}