// 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::path::PathBuf; 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, authcodes_path: PathBuf, skip_origin_validation: bool, } 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, authcodes_path: PathBuf) -> Self { ServerBuilder { queue: queue, handler: Arc::new(IoHandler::new()), authcodes_path: authcodes_path, skip_origin_validation: false, } } /// If set to `true` server will not verify Origin of incoming requests. /// Not recommended. Use only for development. pub fn skip_origin_validation(mut self, skip: bool) -> Self { self.skip_origin_validation = skip; self } /// 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, self.authcodes_path, self.skip_origin_validation) } } /// `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, authcodes_path: PathBuf, skip_origin_validation: bool) -> Result { let config = { let mut config = ws::Settings::default(); // accept only handshakes beginning with GET config.method_strict = true; // Was shutting down server when suspending on linux: config.shutdown_on_interrupt = false; config }; // Create WebSocket let origin = format!("{}", addr); let ws = try!(ws::Builder::new().with_settings(config).build( session::Factory::new(handler, origin, authcodes_path, skip_origin_validation) )); 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 || { match ws.listen(addr).map_err(ServerError::from) { Err(ServerError::IoError(io)) => die(format!( "Signer: Could not start listening on specified address. Make sure that no other instance is running on Signer's port. Details: {:?}", io )), Err(any_error) => die(format!( "Signer: Unknown error occurred when starting Signer. Details: {:?}", any_error )), Ok(server) => server, } }).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."); let res = broadcaster.shutdown(); if let Err(e) = res { warn!("Signer: Broadcaster was not closed cleanly. Details: {:?}", e); } }).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(); } } fn die(msg: String) -> ! { println!("ERROR: {}", msg); std::process::exit(1); }