remoc 0.18.3

🦑 Remote multiplexed objects, channels, observable collections and RPC making remote interactions seamless. Provides multiple remote channels and RPC over TCP, TLS or any other transport.
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

//! Messages exchanged between read/write locks and the owner.

use serde::{Deserialize, Serialize};

use crate::{
    RemoteSend, codec,
    rch::{mpsc, oneshot, watch},
};

/// A read request from a lock to the owner.
#[derive(Debug, Serialize, Deserialize)]
#[serde(bound(serialize = "T: RemoteSend, Codec: codec::Codec"))]
#[serde(bound(deserialize = "T: RemoteSend, Codec: codec::Codec"))]
pub struct ReadRequest<T, Codec> {
    /// Channel for sending the value.
    pub(crate) value_tx: oneshot::Sender<Value<T, Codec>, Codec>,
}

/// A write request from a lock to the owner.
#[derive(Debug, Serialize, Deserialize)]
#[serde(bound(serialize = "T: RemoteSend, Codec: codec::Codec"))]
#[serde(bound(deserialize = "T: RemoteSend, Codec: codec::Codec"))]
pub struct WriteRequest<T, Codec> {
    /// Channel for sending current value.
    pub(crate) value_tx: oneshot::Sender<T, Codec>,
    /// Channel for receiving modified value.
    pub(crate) new_value_rx: oneshot::Receiver<T, Codec>,
    /// Channel for confirming that modified value has been stored.
    pub(crate) confirm_tx: oneshot::Sender<(), Codec>,
}

/// A value together with invalidation channels.
#[derive(Clone, Serialize, Deserialize)]
#[serde(bound(serialize = "T: RemoteSend, Codec: codec::Codec"))]
#[serde(bound(deserialize = "T: RemoteSend, Codec: codec::Codec"))]
pub struct Value<T, Codec> {
    /// The shared value.
    pub(crate) value: T,
    /// Notification channel that all instances of this value have been dropped.
    pub(crate) dropped_tx: mpsc::Sender<(), Codec, 1>,
    /// Notification channel that value has been invalidated by the owner.
    pub(crate) invalid_rx: watch::Receiver<bool, Codec>,
}

impl<T, Codec> Value<T, Codec>
where
    T: RemoteSend,
    Codec: codec::Codec,
{
    /// True, if value is valid.
    pub(crate) fn is_valid(&self) -> bool {
        if self.dropped_tx.is_closed() {
            return false;
        }

        match self.invalid_rx.borrow() {
            Ok(invalid) if !*invalid => (),
            _ => return false,
        }

        true
    }
}