// Copyright 2015-2018 Parity Technologies (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 . //! Tokio Core Reactor wrapper. extern crate futures; extern crate tokio_core; use std::{fmt, thread}; use std::sync::mpsc; use std::time::Duration; use futures::{Future, IntoFuture}; pub use tokio_core::reactor::{Remote as TokioRemote, Handle, Timeout}; /// Event Loop for futures. /// Wrapper around `tokio::reactor::Core`. /// Runs in a separate thread. pub struct EventLoop { remote: Remote, handle: EventLoopHandle, } impl EventLoop { /// Spawns a new thread with `EventLoop` with given handler. pub fn spawn() -> Self { let (stop, stopped) = futures::oneshot(); let (tx, rx) = mpsc::channel(); let handle = thread::spawn(move || { let mut el = tokio_core::reactor::Core::new().expect("Creating an event loop should not fail."); tx.send(el.remote()).expect("Rx is blocking upper thread."); let _ = el.run(futures::empty().select(stopped)); }); let remote = rx.recv().expect("tx is transfered to a newly spawned thread."); EventLoop { remote: Remote { inner: Mode::Tokio(remote), }, handle: EventLoopHandle { close: Some(stop), handle: Some(handle), }, } } /// Returns this event loop raw remote. /// /// Deprecated: Exists only to connect with current JSONRPC implementation. pub fn raw_remote(&self) -> TokioRemote { if let Mode::Tokio(ref remote) = self.remote.inner { remote.clone() } else { panic!("Event loop is never initialized in other mode then Tokio.") } } /// Returns event loop remote. pub fn remote(&self) -> Remote { self.remote.clone() } } #[derive(Clone)] enum Mode { Tokio(TokioRemote), Sync, ThreadPerFuture, } impl fmt::Debug for Mode { fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result { use self::Mode::*; match *self { Tokio(_) => write!(fmt, "tokio"), Sync => write!(fmt, "synchronous"), ThreadPerFuture => write!(fmt, "thread per future"), } } } #[derive(Debug, Clone)] pub struct Remote { inner: Mode, } impl Remote { /// Remote for existing event loop. /// /// Deprecated: Exists only to connect with current JSONRPC implementation. pub fn new(remote: TokioRemote) -> Self { Remote { inner: Mode::Tokio(remote), } } /// Synchronous remote, used mostly for tests. pub fn new_sync() -> Self { Remote { inner: Mode::Sync, } } /// Spawns a new thread for each future (use only for tests). pub fn new_thread_per_future() -> Self { Remote { inner: Mode::ThreadPerFuture, } } /// Spawn a future to this event loop pub fn spawn(&self, r: R) where R: IntoFuture + Send + 'static, R::Future: 'static, { match self.inner { Mode::Tokio(ref remote) => remote.spawn(move |_| r), Mode::Sync => { let _= r.into_future().wait(); }, Mode::ThreadPerFuture => { thread::spawn(move || { let _= r.into_future().wait(); }); }, } } /// Spawn a new future returned by given closure. pub fn spawn_fn(&self, f: F) where F: FnOnce(&Handle) -> R + Send + 'static, R: IntoFuture, R::Future: 'static, { match self.inner { Mode::Tokio(ref remote) => remote.spawn(move |handle| f(handle)), Mode::Sync => { let mut core = tokio_core::reactor::Core::new().expect("Creating an event loop should not fail."); let handle = core.handle(); let _ = core.run(f(&handle).into_future()); }, Mode::ThreadPerFuture => { thread::spawn(move || { let mut core = tokio_core::reactor::Core::new().expect("Creating an event loop should not fail."); let handle = core.handle(); let _ = core.run(f(&handle).into_future()); }); }, } } /// Spawn a new future and wait for it or for a timeout to occur. pub fn spawn_with_timeout(&self, f: F, duration: Duration, on_timeout: T) where T: FnOnce() -> () + Send + 'static, F: FnOnce(&Handle) -> R + Send + 'static, R: IntoFuture, R::Future: 'static, { match self.inner { Mode::Tokio(ref remote) => remote.spawn(move |handle| { let future = f(handle).into_future(); let timeout = Timeout::new(duration, handle).expect("Event loop is still up."); future.select(timeout.then(move |_| { on_timeout(); Ok(()) })).then(|_| Ok(())) }), Mode::Sync => { let mut core = tokio_core::reactor::Core::new().expect("Creating an event loop should not fail."); let handle = core.handle(); let future = f(&handle).into_future(); let timeout = Timeout::new(duration, &handle).expect("Event loop is still up."); let _: Result<(), ()> = core.run(future.select(timeout.then(move |_| { on_timeout(); Ok(()) })).then(|_| Ok(()))); }, Mode::ThreadPerFuture => { thread::spawn(move || { let mut core = tokio_core::reactor::Core::new().expect("Creating an event loop should not fail."); let handle = core.handle(); let future = f(&handle).into_future(); let timeout = Timeout::new(duration, &handle).expect("Event loop is still up."); let _: Result<(), ()> = core.run(future.select(timeout.then(move |_| { on_timeout(); Ok(()) })).then(|_| Ok(()))); }); }, } } } /// A handle to running event loop. Dropping the handle will cause event loop to finish. pub struct EventLoopHandle { close: Option>, handle: Option> } impl From for EventLoopHandle { fn from(el: EventLoop) -> Self { el.handle } } impl Drop for EventLoopHandle { fn drop(&mut self) { self.close.take().map(|v| v.send(())); } } impl EventLoopHandle { /// Blocks current thread and waits until the event loop is finished. pub fn wait(mut self) -> thread::Result<()> { self.handle.take() .expect("Handle is taken only in `wait`, `wait` is consuming; qed").join() } /// Finishes this event loop. pub fn close(mut self) { let _ = self.close.take() .expect("Close is taken only in `close` and `drop`. `close` is consuming; qed") .send(()); } }