// Copyright 2015, 2016 Ethcore (UK) Ltd. // This file is part of Parity. // Parity is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // Parity is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // You should have received a copy of the GNU General Public License // along with Parity. If not, see . //! `WebSockets` server. use ws; use std; use std::thread; use std::default::Default; use std::ops::Drop; use std::sync::Arc; use std::net::SocketAddr; use util::panics::{PanicHandler, OnPanicListener, MayPanic}; use jsonrpc_core::{IoHandler, IoDelegate}; use rpc::{Extendable, ConfirmationsQueue}; mod session; /// Signer startup error #[derive(Debug)] pub enum ServerError { /// Wrapped `std::io::Error` IoError(std::io::Error), /// Other `ws-rs` error WebSocket(ws::Error) } impl From for ServerError { fn from(err: ws::Error) -> Self { match err.kind { ws::ErrorKind::Io(e) => ServerError::IoError(e), _ => ServerError::WebSocket(err), } } } /// Builder for `WebSockets` server pub struct ServerBuilder { queue: Arc, handler: Arc, } impl Extendable for ServerBuilder { fn add_delegate(&self, delegate: IoDelegate) { self.handler.add_delegate(delegate); } } impl ServerBuilder { /// Creates new `ServerBuilder` pub fn new(queue: Arc) -> Self { ServerBuilder { queue: queue, handler: Arc::new(IoHandler::new()), } } /// Starts a new `WebSocket` server in separate thread. /// Returns a `Server` handle which closes the server when droped. pub fn start(self, addr: SocketAddr) -> Result { Server::start(addr, self.handler, self.queue) } } /// `WebSockets` server implementation. pub struct Server { handle: Option>>, broadcaster_handle: Option>, queue: Arc, panic_handler: Arc, } impl Server { /// Starts a new `WebSocket` server in separate thread. /// Returns a `Server` handle which closes the server when droped. fn start(addr: SocketAddr, handler: Arc, queue: Arc) -> Result { let config = { let mut config = ws::Settings::default(); config.max_connections = 5; config.method_strict = true; config }; // Create WebSocket let ws = try!(ws::Builder::new().with_settings(config).build(session::Factory::new(handler))); let panic_handler = PanicHandler::new_in_arc(); let ph = panic_handler.clone(); let broadcaster = ws.broadcaster(); // Spawn a thread with event loop let handle = thread::spawn(move || { ph.catch_panic(move || { ws.listen(addr).unwrap() }).unwrap() }); // Spawn a thread for broadcasting let ph = panic_handler.clone(); let q = queue.clone(); let broadcaster_handle = thread::spawn(move || { ph.catch_panic(move || { q.start_listening(|_message| { // TODO [ToDr] Some better structure here for messages. broadcaster.send("new_message").unwrap(); }).expect("It's the only place we are running start_listening. It shouldn't fail."); broadcaster.shutdown().expect("Broadcaster should close gently.") }).unwrap() }); // Return a handle Ok(Server { handle: Some(handle), broadcaster_handle: Some(broadcaster_handle), queue: queue, panic_handler: panic_handler, }) } } impl MayPanic for Server { fn on_panic(&self, closure: F) where F: OnPanicListener { self.panic_handler.on_panic(closure); } } impl Drop for Server { fn drop(&mut self) { self.queue.finish(); self.broadcaster_handle.take().unwrap().join().unwrap(); self.handle.take().unwrap().join().unwrap(); } }