bromine 0.22.1

A flexible ipc protocol (previously rmp-ipc)
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

use super::handle_connection;
use crate::error::Result;
use crate::events::event_handler::EventHandler;
use crate::ipc::context::{Context, ReplyListeners};
use crate::ipc::stream_emitter::StreamEmitter;
use crate::namespaces::namespace::Namespace;

#[cfg(feature = "serialize")]
use crate::payload::DynamicSerializer;

use crate::protocol::{AsyncProtocolStreamSplit, AsyncStreamProtocolListener};
use std::collections::HashMap;
use std::sync::Arc;
use std::time::Duration;
use tokio::sync::RwLock;
use trait_bound_typemap::SendSyncTypeMap;

/// The IPC Server listening for connections.
/// Use the [IPCBuilder](crate::builder::IPCBuilder) to create a server.
/// Usually one does not need to use the IPCServer object directly.
pub struct IPCServer {
    pub(crate) handler: EventHandler,
    pub(crate) namespaces: HashMap<String, Namespace>,
    pub(crate) data: SendSyncTypeMap,
    pub(crate) timeout: Duration,

    #[cfg(feature = "serialize")]
    pub(crate) default_serializer: DynamicSerializer,
}

impl IPCServer {
    /// Starts the IPC Server.
    /// Invoked by [IPCBuilder::build_server](crate::builder::IPCBuilder::build_server)
    #[tracing::instrument(skip(self, options))]
    pub async fn start<L: AsyncStreamProtocolListener>(
        self,
        address: L::AddressType,
        options: L::ListenerOptions,
    ) -> Result<()> {
        let listener = L::protocol_bind(address.clone(), options).await?;
        let handler = Arc::new(self.handler);
        let namespaces = Arc::new(self.namespaces);
        let data = Arc::new(RwLock::new(self.data));
        tracing::info!("address = {:?}", address);

        while let Ok((stream, remote_address)) = listener.protocol_accept().await {
            tracing::debug!("remote_address = {:?}", remote_address);
            let handler = Arc::clone(&handler);
            let namespaces = Arc::clone(&namespaces);
            let data = Arc::clone(&data);
            let timeout = self.timeout;
            #[cfg(feature = "serialize")]
            let default_serializer = self.default_serializer.clone();

            tokio::spawn(async move {
                let (read_half, write_half) = stream.protocol_into_split();

                let emitter = StreamEmitter::new::<L::Stream>(write_half);

                let reply_listeners = ReplyListeners::default();

                #[cfg(feature = "serialize")]
                let ctx = Context::new(
                    emitter,
                    data,
                    None,
                    reply_listeners,
                    timeout.into(),
                    default_serializer.clone(),
                );
                #[cfg(not(feature = "serialize"))]
                let ctx = Context::new(emitter, data, None, reply_listeners, timeout);

                handle_connection::<L::Stream>(namespaces, handler, read_half, ctx).await;
            });
        }

        Ok(())
    }
}