use crate::proto::{self, EnvelopedMessage, MessageStream, RequestMessage}; use anyhow::{anyhow, Result}; use async_lock::{Mutex, RwLock}; use futures::{ future::{BoxFuture, Either}, AsyncRead, AsyncWrite, FutureExt, }; use postage::{ barrier, mpsc, oneshot, prelude::{Sink, Stream}, }; use std::{ any::TypeId, collections::{HashMap, HashSet}, future::Future, pin::Pin, sync::{ atomic::{self, AtomicU32}, Arc, }, }; type BoxedWriter = Pin>; #[derive(Clone, Copy, PartialEq, Eq, Hash, Debug)] pub struct ConnectionId(u32); struct Connection { writer: Mutex>, response_channels: Mutex>>, next_message_id: AtomicU32, } type MessageHandler = Box< dyn Send + Sync + Fn(&mut Option, ConnectionId) -> Option>, >; pub struct TypedEnvelope { id: u32, connection_id: ConnectionId, payload: T, } impl TypedEnvelope { pub fn connection_id(&self) -> ConnectionId { self.connection_id } pub fn payload(&self) -> &T { &self.payload } } pub struct Peer { connections: RwLock, barrier::Sender)>>, message_handlers: RwLock>, handler_types: Mutex>, next_connection_id: AtomicU32, } impl Peer { pub fn new() -> Arc { Arc::new(Self { connections: Default::default(), message_handlers: Default::default(), handler_types: Default::default(), next_connection_id: Default::default(), }) } pub async fn add_message_handler( &self, ) -> mpsc::Receiver> { if !self.handler_types.lock().await.insert(TypeId::of::()) { panic!("duplicate handler type"); } let (tx, rx) = mpsc::channel(256); self.message_handlers .write() .await .push(Box::new(move |envelope, connection_id| { if envelope.as_ref().map_or(false, T::matches_envelope) { let envelope = Option::take(envelope).unwrap(); let mut tx = tx.clone(); Some( async move { tx.send(TypedEnvelope { id: envelope.id, connection_id, payload: T::from_envelope(envelope).unwrap(), }) .await .is_err() } .boxed(), ) } else { None } })); rx } pub async fn add_connection( self: &Arc, conn: Conn, ) -> (ConnectionId, impl Future>) where Conn: Clone + AsyncRead + AsyncWrite + Unpin + Send + 'static, { let connection_id = ConnectionId( self.next_connection_id .fetch_add(1, atomic::Ordering::SeqCst), ); let (close_tx, mut close_rx) = barrier::channel(); let connection = Arc::new(Connection { writer: Mutex::new(MessageStream::new(Box::pin(conn.clone()))), response_channels: Default::default(), next_message_id: Default::default(), }); self.connections .write() .await .insert(connection_id, (connection.clone(), close_tx)); let this = self.clone(); let handler_future = async move { let closed = close_rx.recv(); futures::pin_mut!(closed); let mut stream = MessageStream::new(conn); loop { let read_message = stream.read_message(); futures::pin_mut!(read_message); match futures::future::select(read_message, &mut closed).await { Either::Left((Ok(incoming), _)) => { if let Some(responding_to) = incoming.responding_to { let channel = connection .response_channels .lock() .await .remove(&responding_to); if let Some(mut tx) = channel { tx.send(incoming).await.ok(); } else { log::warn!( "received RPC response to unknown request {}", responding_to ); } } else { let mut envelope = Some(incoming); let mut handler_index = None; let mut handler_was_dropped = false; for (i, handler) in this.message_handlers.read().await.iter().enumerate() { if let Some(future) = handler(&mut envelope, connection_id) { handler_was_dropped = future.await; handler_index = Some(i); break; } } if let Some(handler_index) = handler_index { if handler_was_dropped { drop(this.message_handlers.write().await.remove(handler_index)); } } else { log::warn!("unhandled message: {:?}", envelope.unwrap().payload); } } } Either::Left((Err(error), _)) => { log::warn!("received invalid RPC message: {}", error); Err(error)?; } Either::Right(_) => return Ok(()), } } }; (connection_id, handler_future) } pub async fn disconnect(&self, connection_id: ConnectionId) { self.connections.write().await.remove(&connection_id); } pub fn request( self: &Arc, connection_id: ConnectionId, req: T, ) -> impl Future> { let this = self.clone(); let (tx, mut rx) = oneshot::channel(); async move { let connection = this.connection(connection_id).await?; let message_id = connection .next_message_id .fetch_add(1, atomic::Ordering::SeqCst); connection .response_channels .lock() .await .insert(message_id, tx); connection .writer .lock() .await .write_message(&req.into_envelope(message_id, None)) .await?; let response = rx .recv() .await .expect("response channel was unexpectedly dropped"); T::Response::from_envelope(response) .ok_or_else(|| anyhow!("received response of the wrong type")) } } pub fn send( self: &Arc, connection_id: ConnectionId, message: T, ) -> impl Future> { let this = self.clone(); async move { let connection = this.connection(connection_id).await?; let message_id = connection .next_message_id .fetch_add(1, atomic::Ordering::SeqCst); connection .writer .lock() .await .write_message(&message.into_envelope(message_id, None)) .await?; Ok(()) } } pub fn respond( self: &Arc, request: TypedEnvelope, response: T::Response, ) -> impl Future> { let this = self.clone(); async move { let connection = this.connection(request.connection_id).await?; let message_id = connection .next_message_id .fetch_add(1, atomic::Ordering::SeqCst); connection .writer .lock() .await .write_message(&response.into_envelope(message_id, Some(request.id))) .await?; Ok(()) } } async fn connection(&self, id: ConnectionId) -> Result> { Ok(self .connections .read() .await .get(&id) .ok_or_else(|| anyhow!("unknown connection: {}", id.0))? .0 .clone()) } } #[cfg(test)] mod tests { use super::*; use smol::{ io::AsyncWriteExt, net::unix::{UnixListener, UnixStream}, }; use std::io; use tempdir::TempDir; #[test] fn test_request_response() { smol::block_on(async move { // create socket let socket_dir_path = TempDir::new("test-request-response").unwrap(); let socket_path = socket_dir_path.path().join("test.sock"); let listener = UnixListener::bind(&socket_path).unwrap(); // create 2 clients connected to 1 server let server = Peer::new(); let client1 = Peer::new(); let client2 = Peer::new(); let (client1_conn_id, f1) = client1 .add_connection(UnixStream::connect(&socket_path).await.unwrap()) .await; let (client2_conn_id, f2) = client2 .add_connection(UnixStream::connect(&socket_path).await.unwrap()) .await; let (_, f3) = server .add_connection(listener.accept().await.unwrap().0) .await; let (_, f4) = server .add_connection(listener.accept().await.unwrap().0) .await; smol::spawn(f1).detach(); smol::spawn(f2).detach(); smol::spawn(f3).detach(); smol::spawn(f4).detach(); // define the expected requests and responses let request1 = proto::OpenWorktree { worktree_id: 101, access_token: "first-worktree-access-token".to_string(), }; let response1 = proto::OpenWorktreeResponse { worktree: Some(proto::Worktree { paths: vec![b"path/one".to_vec()], }), }; let request2 = proto::OpenWorktree { worktree_id: 102, access_token: "second-worktree-access-token".to_string(), }; let response2 = proto::OpenWorktreeResponse { worktree: Some(proto::Worktree { paths: vec![b"path/two".to_vec(), b"path/three".to_vec()], }), }; let request3 = proto::OpenBuffer { worktree_id: 102, path: b"path/two".to_vec(), }; let response3 = proto::OpenBufferResponse { buffer: Some(proto::Buffer { id: 1001, path: b"path/two".to_vec(), content: b"path/two content".to_vec(), history: vec![], }), }; let request4 = proto::OpenBuffer { worktree_id: 101, path: b"path/one".to_vec(), }; let response4 = proto::OpenBufferResponse { buffer: Some(proto::Buffer { id: 1002, path: b"path/one".to_vec(), content: b"path/one content".to_vec(), history: vec![], }), }; // on the server, respond to two requests for each client let mut open_buffer_rx = server.add_message_handler::().await; let mut open_worktree_rx = server.add_message_handler::().await; let (mut server_done_tx, mut server_done_rx) = oneshot::channel::<()>(); smol::spawn({ let request1 = request1.clone(); let request2 = request2.clone(); let request3 = request3.clone(); let request4 = request4.clone(); let response1 = response1.clone(); let response2 = response2.clone(); let response3 = response3.clone(); let response4 = response4.clone(); async move { let msg = open_worktree_rx.recv().await.unwrap(); assert_eq!(msg.payload, request1); server.respond(msg, response1.clone()).await.unwrap(); let msg = open_worktree_rx.recv().await.unwrap(); assert_eq!(msg.payload, request2.clone()); server.respond(msg, response2.clone()).await.unwrap(); let msg = open_buffer_rx.recv().await.unwrap(); assert_eq!(msg.payload, request3.clone()); server.respond(msg, response3.clone()).await.unwrap(); let msg = open_buffer_rx.recv().await.unwrap(); assert_eq!(msg.payload, request4.clone()); server.respond(msg, response4.clone()).await.unwrap(); server_done_tx.send(()).await.unwrap(); } }) .detach(); assert_eq!( client1.request(client1_conn_id, request1).await.unwrap(), response1 ); assert_eq!( client2.request(client2_conn_id, request2).await.unwrap(), response2 ); assert_eq!( client2.request(client2_conn_id, request3).await.unwrap(), response3 ); assert_eq!( client1.request(client1_conn_id, request4).await.unwrap(), response4 ); client1.disconnect(client1_conn_id).await; client2.disconnect(client1_conn_id).await; server_done_rx.recv().await.unwrap(); }); } #[test] fn test_disconnect() { smol::block_on(async move { let socket_dir_path = TempDir::new("drop-client").unwrap(); let socket_path = socket_dir_path.path().join(".sock"); let listener = UnixListener::bind(&socket_path).unwrap(); let client_conn = UnixStream::connect(&socket_path).await.unwrap(); let (mut server_conn, _) = listener.accept().await.unwrap(); let client = Peer::new(); let (connection_id, handler) = client.add_connection(client_conn).await; smol::spawn(handler).detach(); client.disconnect(connection_id).await; // Try sending an empty payload over and over, until the client is dropped and hangs up. loop { match server_conn.write(&[]).await { Ok(_) => {} Err(err) => { if err.kind() == io::ErrorKind::BrokenPipe { break; } } } } }); } #[test] fn test_io_error() { smol::block_on(async move { let socket_dir_path = TempDir::new("io-error").unwrap(); let socket_path = socket_dir_path.path().join(".sock"); let _listener = UnixListener::bind(&socket_path).unwrap(); let mut client_conn = UnixStream::connect(&socket_path).await.unwrap(); client_conn.close().await.unwrap(); let client = Peer::new(); let (connection_id, handler) = client.add_connection(client_conn).await; smol::spawn(handler).detach(); let err = client .request( connection_id, proto::Auth { user_id: 42, access_token: "token".to_string(), }, ) .await .unwrap_err(); assert_eq!( err.downcast_ref::().unwrap().kind(), io::ErrorKind::BrokenPipe ); }); } }