5d3c472228
**The `Error` is now an opaque struct**, which allows for more variants to be added freely, and the internal representation to change without being breaking changes. For inspecting an `Error`, there are several `is_*` methods to check for certain classes of errors, such as `Error::is_parse()`. The `cause` can also be inspected, like before. This likely seems like a downgrade, but more inspection can be added as needed! The `Error` now knows about more states, which gives much more context around when a certain error occurs. This is also expressed in the description and `fmt` messages. **Most places where a user would provide an error to hyper can now pass any error type** (`E: Into<Box<std::error::Error>>`). This error is passed back in relevant places, and can be useful for logging. This should make it much clearer about what error a user should provide to hyper: any it feels is relevant! Closes #1128 Closes #1130 Closes #1431 Closes #1338 BREAKING CHANGE: `Error` is no longer an enum to pattern match over, or to construct. Code will need to be updated accordingly. For body streams or `Service`s, inference might be unable to determine what error type you mean to return. Starting in Rust 1.26, you could just label that as `!` if you never return an error.
702 lines
21 KiB
Rust
702 lines
21 KiB
Rust
//! HTTP Client
|
|
|
|
use std::fmt;
|
|
use std::io;
|
|
use std::marker::PhantomData;
|
|
use std::sync::Arc;
|
|
use std::time::Duration;
|
|
|
|
use futures::{Async, Future, Poll};
|
|
use futures::future::{self, Executor};
|
|
use futures::sync::oneshot;
|
|
use http::{Method, Request, Response, Uri, Version};
|
|
use http::header::{Entry, HeaderValue, HOST};
|
|
use http::uri::Scheme;
|
|
use tokio::reactor::Handle;
|
|
use tokio_executor::spawn;
|
|
pub use tokio_service::Service;
|
|
|
|
use proto::body::{Body, Entity};
|
|
use proto;
|
|
use self::pool::Pool;
|
|
|
|
pub use self::connect::{Connect, HttpConnector};
|
|
|
|
use self::background::{bg, Background};
|
|
use self::connect::Destination;
|
|
|
|
pub mod conn;
|
|
pub mod connect;
|
|
pub(crate) mod dispatch;
|
|
mod dns;
|
|
mod pool;
|
|
#[cfg(test)]
|
|
mod tests;
|
|
|
|
/// A Client to make outgoing HTTP requests.
|
|
pub struct Client<C, B = proto::Body> {
|
|
connector: Arc<C>,
|
|
executor: Exec,
|
|
h1_writev: bool,
|
|
pool: Pool<PoolClient<B>>,
|
|
retry_canceled_requests: bool,
|
|
set_host: bool,
|
|
}
|
|
|
|
impl Client<HttpConnector, proto::Body> {
|
|
/// Create a new Client with the default config.
|
|
#[inline]
|
|
pub fn new(handle: &Handle) -> Client<HttpConnector, proto::Body> {
|
|
Config::default().build(handle)
|
|
}
|
|
}
|
|
|
|
impl Default for Client<HttpConnector, proto::Body> {
|
|
fn default() -> Client<HttpConnector, proto::Body> {
|
|
Client::new(&Handle::current())
|
|
}
|
|
}
|
|
|
|
impl Client<HttpConnector, proto::Body> {
|
|
/// Configure a Client.
|
|
///
|
|
/// # Example
|
|
///
|
|
/// ```no_run
|
|
/// # extern crate hyper;
|
|
/// # extern crate tokio;
|
|
///
|
|
/// # fn main() {
|
|
/// # let runtime = tokio::runtime::Runtime::new().unwrap();
|
|
/// # let handle = runtime.handle();
|
|
/// let client = hyper::Client::configure()
|
|
/// .keep_alive(true)
|
|
/// .build(&handle);
|
|
/// # drop(client);
|
|
/// # }
|
|
/// ```
|
|
#[inline]
|
|
pub fn configure() -> Config<UseDefaultConnector, proto::Body> {
|
|
Config::default()
|
|
}
|
|
}
|
|
|
|
impl<C, B> Client<C, B> {
|
|
#[inline]
|
|
fn configured(config: Config<C, B>, exec: Exec) -> Client<C, B> {
|
|
Client {
|
|
connector: Arc::new(config.connector),
|
|
executor: exec,
|
|
h1_writev: config.h1_writev,
|
|
pool: Pool::new(config.keep_alive, config.keep_alive_timeout),
|
|
retry_canceled_requests: config.retry_canceled_requests,
|
|
set_host: config.set_host,
|
|
}
|
|
}
|
|
}
|
|
|
|
impl<C, B> Client<C, B>
|
|
where C: Connect + Sync + 'static,
|
|
C::Transport: 'static,
|
|
C::Future: 'static,
|
|
B: Entity + Send + 'static,
|
|
B::Data: Send,
|
|
{
|
|
|
|
/// Send a `GET` request to the supplied `Uri`.
|
|
///
|
|
/// # Note
|
|
///
|
|
/// This requires that the `Entity` type have a `Default` implementation.
|
|
/// It *should* return an "empty" version of itself, such that
|
|
/// `Entity::is_end_stream` is `true`.
|
|
pub fn get(&self, uri: Uri) -> FutureResponse
|
|
where
|
|
B: Default,
|
|
{
|
|
let body = B::default();
|
|
if !body.is_end_stream() {
|
|
warn!("default Entity used for get() does not return true for is_end_stream");
|
|
}
|
|
|
|
let mut req = Request::new(body);
|
|
*req.uri_mut() = uri;
|
|
self.request(req)
|
|
}
|
|
|
|
/// Send a constructed Request using this Client.
|
|
pub fn request(&self, mut req: Request<B>) -> FutureResponse {
|
|
// TODO(0.12): do this at construction time.
|
|
//
|
|
// It cannot be done in the constructor because the Client::configured
|
|
// does not have `B: 'static` bounds, which are required to spawn
|
|
// the interval. In 0.12, add a static bounds to the constructor,
|
|
// and move this.
|
|
self.schedule_pool_timer();
|
|
|
|
match req.version() {
|
|
Version::HTTP_10 |
|
|
Version::HTTP_11 => (),
|
|
other => {
|
|
error!("Request has unsupported version \"{:?}\"", other);
|
|
//TODO: replace this with a proper variant
|
|
return FutureResponse(Box::new(future::err(::Error::new_user_unsupported_version())));
|
|
}
|
|
}
|
|
|
|
if req.method() == &Method::CONNECT {
|
|
debug!("Client does not support CONNECT requests");
|
|
return FutureResponse(Box::new(future::err(::Error::new_user_unsupported_request_method())));
|
|
}
|
|
|
|
let uri = req.uri().clone();
|
|
let domain = match (uri.scheme_part(), uri.authority_part()) {
|
|
(Some(scheme), Some(auth)) => {
|
|
format!("{}://{}", scheme, auth)
|
|
}
|
|
_ => {
|
|
//TODO: replace this with a proper variant
|
|
return FutureResponse(Box::new(future::err(::Error::new_io(
|
|
io::Error::new(
|
|
io::ErrorKind::InvalidInput,
|
|
"invalid URI for Client Request"
|
|
)
|
|
))));
|
|
}
|
|
};
|
|
|
|
if self.set_host {
|
|
if let Entry::Vacant(entry) = req.headers_mut().entry(HOST).expect("HOST is always valid header name") {
|
|
let hostname = uri.host().expect("authority implies host");
|
|
let host = if let Some(port) = uri.port() {
|
|
let s = format!("{}:{}", hostname, port);
|
|
HeaderValue::from_str(&s)
|
|
} else {
|
|
HeaderValue::from_str(hostname)
|
|
}.expect("uri host is valid header value");
|
|
entry.insert(host);
|
|
}
|
|
}
|
|
|
|
|
|
let client = self.clone();
|
|
let uri = req.uri().clone();
|
|
let fut = RetryableSendRequest {
|
|
client: client,
|
|
future: self.send_request(req, &domain),
|
|
domain: domain,
|
|
uri: uri,
|
|
};
|
|
FutureResponse(Box::new(fut))
|
|
}
|
|
|
|
//TODO: replace with `impl Future` when stable
|
|
fn send_request(&self, mut req: Request<B>, domain: &str) -> Box<Future<Item=Response<Body>, Error=ClientError<B>> + Send> {
|
|
let url = req.uri().clone();
|
|
let checkout = self.pool.checkout(domain);
|
|
let connect = {
|
|
let executor = self.executor.clone();
|
|
let pool = self.pool.clone();
|
|
let pool_key = Arc::new(domain.to_string());
|
|
let h1_writev = self.h1_writev;
|
|
let connector = self.connector.clone();
|
|
let dst = Destination {
|
|
uri: url,
|
|
};
|
|
future::lazy(move || {
|
|
connector.connect(dst)
|
|
.map_err(::Error::new_connect)
|
|
.and_then(move |(io, connected)| {
|
|
conn::Builder::new()
|
|
.h1_writev(h1_writev)
|
|
.handshake_no_upgrades(io)
|
|
.and_then(move |(tx, conn)| {
|
|
executor.execute(conn.map_err(|e| debug!("client connection error: {}", e)));
|
|
Ok(pool.pooled(pool_key, PoolClient {
|
|
is_proxied: connected.is_proxied,
|
|
tx: tx,
|
|
}))
|
|
})
|
|
})
|
|
})
|
|
};
|
|
|
|
let race = checkout.select(connect)
|
|
.map(|(pooled, _work)| pooled)
|
|
.map_err(|(e, _checkout)| {
|
|
// the Pool Checkout cannot error, so the only error
|
|
// is from the Connector
|
|
// XXX: should wait on the Checkout? Problem is
|
|
// that if the connector is failing, it may be that we
|
|
// never had a pooled stream at all
|
|
ClientError::Normal(e)
|
|
});
|
|
|
|
let executor = self.executor.clone();
|
|
let resp = race.and_then(move |mut pooled| {
|
|
let conn_reused = pooled.is_reused();
|
|
set_relative_uri(req.uri_mut(), pooled.is_proxied);
|
|
let fut = pooled.tx.send_request_retryable(req)
|
|
.map_err(move |(err, orig_req)| {
|
|
if let Some(req) = orig_req {
|
|
ClientError::Canceled {
|
|
connection_reused: conn_reused,
|
|
reason: err,
|
|
req,
|
|
}
|
|
} else {
|
|
ClientError::Normal(err)
|
|
}
|
|
})
|
|
.and_then(move |mut res| {
|
|
// when pooled is dropped, it will try to insert back into the
|
|
// pool. To delay that, spawn a future that completes once the
|
|
// sender is ready again.
|
|
//
|
|
// This *should* only be once the related `Connection` has polled
|
|
// for a new request to start.
|
|
//
|
|
// It won't be ready if there is a body to stream.
|
|
if pooled.tx.is_ready() {
|
|
drop(pooled);
|
|
} else if !res.body().is_empty() {
|
|
let (delayed_tx, delayed_rx) = oneshot::channel();
|
|
res.body_mut().delayed_eof(delayed_rx);
|
|
executor.execute(
|
|
future::poll_fn(move || {
|
|
pooled.tx.poll_ready()
|
|
})
|
|
.then(move |_| {
|
|
// At this point, `pooled` is dropped, and had a chance
|
|
// to insert into the pool (if conn was idle)
|
|
drop(delayed_tx);
|
|
Ok(())
|
|
})
|
|
);
|
|
}
|
|
Ok(res)
|
|
});
|
|
|
|
fut
|
|
});
|
|
|
|
Box::new(resp)
|
|
}
|
|
|
|
fn schedule_pool_timer(&self) {
|
|
self.pool.spawn_expired_interval(&self.executor);
|
|
}
|
|
}
|
|
|
|
impl<C, B> Service for Client<C, B>
|
|
where C: Connect + 'static,
|
|
C::Future: 'static,
|
|
B: Entity + Send + 'static,
|
|
B::Data: Send,
|
|
{
|
|
type Request = Request<B>;
|
|
type Response = Response<Body>;
|
|
type Error = ::Error;
|
|
type Future = FutureResponse;
|
|
|
|
fn call(&self, req: Self::Request) -> Self::Future {
|
|
self.request(req)
|
|
}
|
|
}
|
|
|
|
impl<C, B> Clone for Client<C, B> {
|
|
fn clone(&self) -> Client<C, B> {
|
|
Client {
|
|
connector: self.connector.clone(),
|
|
executor: self.executor.clone(),
|
|
h1_writev: self.h1_writev,
|
|
pool: self.pool.clone(),
|
|
retry_canceled_requests: self.retry_canceled_requests,
|
|
set_host: self.set_host,
|
|
}
|
|
}
|
|
}
|
|
|
|
impl<C, B> fmt::Debug for Client<C, B> {
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
f.debug_struct("Client")
|
|
.finish()
|
|
}
|
|
}
|
|
|
|
/// A `Future` that will resolve to an HTTP Response.
|
|
#[must_use = "futures do nothing unless polled"]
|
|
pub struct FutureResponse(Box<Future<Item=Response<Body>, Error=::Error> + Send + 'static>);
|
|
|
|
impl fmt::Debug for FutureResponse {
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
f.pad("Future<Response>")
|
|
}
|
|
}
|
|
|
|
impl Future for FutureResponse {
|
|
type Item = Response<Body>;
|
|
type Error = ::Error;
|
|
|
|
fn poll(&mut self) -> Poll<Self::Item, Self::Error> {
|
|
self.0.poll()
|
|
}
|
|
}
|
|
|
|
struct RetryableSendRequest<C, B> {
|
|
client: Client<C, B>,
|
|
domain: String,
|
|
future: Box<Future<Item=Response<Body>, Error=ClientError<B>> + Send>,
|
|
uri: Uri,
|
|
}
|
|
|
|
impl<C, B> Future for RetryableSendRequest<C, B>
|
|
where
|
|
C: Connect + 'static,
|
|
C::Future: 'static,
|
|
B: Entity + Send + 'static,
|
|
B::Data: Send,
|
|
{
|
|
type Item = Response<Body>;
|
|
type Error = ::Error;
|
|
|
|
fn poll(&mut self) -> Poll<Self::Item, Self::Error> {
|
|
loop {
|
|
match self.future.poll() {
|
|
Ok(Async::Ready(resp)) => return Ok(Async::Ready(resp)),
|
|
Ok(Async::NotReady) => return Ok(Async::NotReady),
|
|
Err(ClientError::Normal(err)) => return Err(err),
|
|
Err(ClientError::Canceled {
|
|
connection_reused,
|
|
mut req,
|
|
reason,
|
|
}) => {
|
|
if !self.client.retry_canceled_requests || !connection_reused {
|
|
// if client disabled, don't retry
|
|
// a fresh connection means we definitely can't retry
|
|
return Err(reason);
|
|
}
|
|
|
|
trace!("unstarted request canceled, trying again (reason={:?})", reason);
|
|
*req.uri_mut() = self.uri.clone();
|
|
self.future = self.client.send_request(req, &self.domain);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
struct PoolClient<B> {
|
|
is_proxied: bool,
|
|
tx: conn::SendRequest<B>,
|
|
}
|
|
|
|
impl<B> self::pool::Closed for PoolClient<B>
|
|
where
|
|
B: 'static,
|
|
{
|
|
fn is_closed(&self) -> bool {
|
|
self.tx.is_closed()
|
|
}
|
|
}
|
|
|
|
enum ClientError<B> {
|
|
Normal(::Error),
|
|
Canceled {
|
|
connection_reused: bool,
|
|
req: Request<B>,
|
|
reason: ::Error,
|
|
}
|
|
}
|
|
|
|
fn set_relative_uri(uri: &mut Uri, is_proxied: bool) {
|
|
if is_proxied && uri.scheme_part() != Some(&Scheme::HTTPS) {
|
|
return;
|
|
}
|
|
let path = match uri.path_and_query() {
|
|
Some(path) => {
|
|
let mut parts = ::http::uri::Parts::default();
|
|
parts.path_and_query = Some(path.clone());
|
|
Uri::from_parts(parts).expect("path is valid uri")
|
|
},
|
|
None => {
|
|
"/".parse().expect("/ is valid path")
|
|
}
|
|
};
|
|
*uri = path;
|
|
}
|
|
|
|
/// Configuration for a Client
|
|
pub struct Config<C, B> {
|
|
_body_type: PhantomData<B>,
|
|
//connect_timeout: Duration,
|
|
connector: C,
|
|
keep_alive: bool,
|
|
keep_alive_timeout: Option<Duration>,
|
|
h1_writev: bool,
|
|
//TODO: make use of max_idle config
|
|
max_idle: usize,
|
|
retry_canceled_requests: bool,
|
|
set_host: bool,
|
|
}
|
|
|
|
/// Phantom type used to signal that `Config` should create a `HttpConnector`.
|
|
#[derive(Debug, Clone, Copy)]
|
|
pub struct UseDefaultConnector(());
|
|
|
|
impl Default for Config<UseDefaultConnector, proto::Body> {
|
|
fn default() -> Config<UseDefaultConnector, proto::Body> {
|
|
Config {
|
|
_body_type: PhantomData::<proto::Body>,
|
|
connector: UseDefaultConnector(()),
|
|
keep_alive: true,
|
|
keep_alive_timeout: Some(Duration::from_secs(90)),
|
|
h1_writev: true,
|
|
max_idle: 5,
|
|
retry_canceled_requests: true,
|
|
set_host: true,
|
|
}
|
|
}
|
|
}
|
|
|
|
impl<C, B> Config<C, B> {
|
|
/// Set the body stream to be used by the `Client`.
|
|
///
|
|
/// # Example
|
|
///
|
|
/// ```rust
|
|
/// # use hyper::client::Config;
|
|
/// let cfg = Config::default()
|
|
/// .body::<hyper::Body>();
|
|
/// # drop(cfg);
|
|
#[inline]
|
|
pub fn body<BB>(self) -> Config<C, BB> {
|
|
Config {
|
|
_body_type: PhantomData::<BB>,
|
|
connector: self.connector,
|
|
keep_alive: self.keep_alive,
|
|
keep_alive_timeout: self.keep_alive_timeout,
|
|
h1_writev: self.h1_writev,
|
|
max_idle: self.max_idle,
|
|
retry_canceled_requests: self.retry_canceled_requests,
|
|
set_host: self.set_host,
|
|
}
|
|
}
|
|
|
|
/// Set the `Connect` type to be used.
|
|
#[inline]
|
|
pub fn connector<CC>(self, val: CC) -> Config<CC, B> {
|
|
Config {
|
|
_body_type: self._body_type,
|
|
connector: val,
|
|
keep_alive: self.keep_alive,
|
|
keep_alive_timeout: self.keep_alive_timeout,
|
|
h1_writev: self.h1_writev,
|
|
max_idle: self.max_idle,
|
|
retry_canceled_requests: self.retry_canceled_requests,
|
|
set_host: self.set_host,
|
|
}
|
|
}
|
|
|
|
/// Enable or disable keep-alive mechanics.
|
|
///
|
|
/// Default is enabled.
|
|
#[inline]
|
|
pub fn keep_alive(mut self, val: bool) -> Config<C, B> {
|
|
self.keep_alive = val;
|
|
self
|
|
}
|
|
|
|
/// Set an optional timeout for idle sockets being kept-alive.
|
|
///
|
|
/// Pass `None` to disable timeout.
|
|
///
|
|
/// Default is 90 seconds.
|
|
#[inline]
|
|
pub fn keep_alive_timeout(mut self, val: Option<Duration>) -> Config<C, B> {
|
|
self.keep_alive_timeout = val;
|
|
self
|
|
}
|
|
|
|
/// Set whether HTTP/1 connections should try to use vectored writes,
|
|
/// or always flatten into a single buffer.
|
|
///
|
|
/// Note that setting this to false may mean more copies of body data,
|
|
/// but may also improve performance when an IO transport doesn't
|
|
/// support vectored writes well, such as most TLS implementations.
|
|
///
|
|
/// Default is `true`.
|
|
#[inline]
|
|
pub fn http1_writev(mut self, val: bool) -> Config<C, B> {
|
|
self.h1_writev = val;
|
|
self
|
|
}
|
|
|
|
/// Set whether to retry requests that get disrupted before ever starting
|
|
/// to write.
|
|
///
|
|
/// This means a request that is queued, and gets given an idle, reused
|
|
/// connection, and then encounters an error immediately as the idle
|
|
/// connection was found to be unusable.
|
|
///
|
|
/// When this is set to `false`, the related `FutureResponse` would instead
|
|
/// resolve to an `Error::Cancel`.
|
|
///
|
|
/// Default is `true`.
|
|
#[inline]
|
|
pub fn retry_canceled_requests(mut self, val: bool) -> Config<C, B> {
|
|
self.retry_canceled_requests = val;
|
|
self
|
|
}
|
|
|
|
/// Set whether to automatically add the `Host` header to requests.
|
|
///
|
|
/// If true, and a request does not include a `Host` header, one will be
|
|
/// added automatically, derived from the authority of the `Uri`.
|
|
///
|
|
/// Default is `true`.
|
|
#[inline]
|
|
pub fn set_host(mut self, val: bool) -> Config<C, B> {
|
|
self.set_host = val;
|
|
self
|
|
}
|
|
}
|
|
|
|
impl<C, B> Config<C, B>
|
|
where C: Connect,
|
|
C::Transport: 'static,
|
|
C::Future: 'static,
|
|
B: Entity + Send,
|
|
B::Data: Send,
|
|
{
|
|
/// Construct the Client with this configuration.
|
|
#[inline]
|
|
pub fn build(self) -> Client<C, B> {
|
|
Client::configured(self, Exec::Default)
|
|
}
|
|
|
|
/// Construct a Client with this configuration and an executor.
|
|
///
|
|
/// The executor will be used to spawn "background" connection tasks
|
|
/// to drive requests and responses.
|
|
pub fn executor<E>(self, executor: E) -> Client<C, B>
|
|
where
|
|
E: Executor<Background> + Send + Sync + 'static,
|
|
{
|
|
Client::configured(self, Exec::new(executor))
|
|
}
|
|
}
|
|
|
|
impl<B> Config<UseDefaultConnector, B>
|
|
where
|
|
B: Entity + Send,
|
|
B::Data: Send,
|
|
{
|
|
/// Construct the Client with this configuration.
|
|
#[inline]
|
|
pub fn build(self, handle: &Handle) -> Client<HttpConnector, B> {
|
|
let mut connector = HttpConnector::new(4, handle);
|
|
if self.keep_alive {
|
|
connector.set_keepalive(self.keep_alive_timeout);
|
|
}
|
|
self.connector(connector).build()
|
|
}
|
|
|
|
/// Construct a Client with this configuration and an executor.
|
|
///
|
|
/// The executor will be used to spawn "background" connection tasks
|
|
/// to drive requests and responses.
|
|
pub fn build_with_executor<E>(self, handle: &Handle, executor: E) -> Client<HttpConnector, B>
|
|
where
|
|
E: Executor<Background> + Send + Sync + 'static,
|
|
{
|
|
let mut connector = HttpConnector::new(4, handle);
|
|
if self.keep_alive {
|
|
connector.set_keepalive(self.keep_alive_timeout);
|
|
}
|
|
self.connector(connector).executor(executor)
|
|
}
|
|
}
|
|
|
|
impl<C, B> fmt::Debug for Config<C, B> {
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
f.debug_struct("Config")
|
|
.field("keep_alive", &self.keep_alive)
|
|
.field("keep_alive_timeout", &self.keep_alive_timeout)
|
|
.field("http1_writev", &self.h1_writev)
|
|
.field("max_idle", &self.max_idle)
|
|
.field("set_host", &self.set_host)
|
|
.finish()
|
|
}
|
|
}
|
|
|
|
impl<C: Clone, B> Clone for Config<C, B> {
|
|
fn clone(&self) -> Config<C, B> {
|
|
Config {
|
|
connector: self.connector.clone(),
|
|
.. *self
|
|
}
|
|
}
|
|
}
|
|
|
|
// ===== impl Exec =====
|
|
|
|
#[derive(Clone)]
|
|
enum Exec {
|
|
Default,
|
|
Executor(Arc<Executor<Background> + Send + Sync>),
|
|
}
|
|
|
|
|
|
impl Exec {
|
|
pub(crate) fn new<E: Executor<Background> + Send + Sync + 'static>(executor: E) -> Exec {
|
|
Exec::Executor(Arc::new(executor))
|
|
}
|
|
|
|
fn execute<F>(&self, fut: F)
|
|
where
|
|
F: Future<Item=(), Error=()> + Send + 'static,
|
|
{
|
|
match *self {
|
|
Exec::Default => spawn(fut),
|
|
Exec::Executor(ref e) => {
|
|
let _ = e.execute(bg(Box::new(fut)))
|
|
.map_err(|err| {
|
|
panic!("executor error: {:?}", err.kind());
|
|
});
|
|
},
|
|
}
|
|
}
|
|
}
|
|
|
|
// ===== impl Background =====
|
|
|
|
// The types inside this module are not exported out of the crate,
|
|
// so they are in essence un-nameable.
|
|
mod background {
|
|
use futures::{Future, Poll};
|
|
|
|
// This is basically `impl Future`, since the type is un-nameable,
|
|
// and only implementeds `Future`.
|
|
#[allow(missing_debug_implementations)]
|
|
pub struct Background {
|
|
inner: Box<Future<Item=(), Error=()> + Send>,
|
|
}
|
|
|
|
pub fn bg(fut: Box<Future<Item=(), Error=()> + Send>) -> Background {
|
|
Background {
|
|
inner: fut,
|
|
}
|
|
}
|
|
|
|
impl Future for Background {
|
|
type Item = ();
|
|
type Error = ();
|
|
|
|
fn poll(&mut self) -> Poll<Self::Item, Self::Error> {
|
|
self.inner.poll()
|
|
}
|
|
}
|
|
}
|
|
|