Struct hyper::client::Config

pub struct Config<C, B> { /* fields omitted */ }

Configuration for a Client

Methods

impl<C, B> Config<C, B>

fn body<BB>(self) -> Config<C, BB>

Set the body stream to be used by the Client.

Example

let cfg = Config::default()
    .body::<hyper::Body>();

fn connector<CC>(self, val: CC) -> Config<CC, B>

Set the Connect type to be used.

fn keep_alive(self, val: bool) -> Config<C, B>

Enable or disable keep-alive mechanics.

Default is enabled.

fn keep_alive_timeout(self, val: Option<Duration>) -> Config<C, B>

Set an optional timeout for idle sockets being kept-alive.

Pass None to disable timeout.

Default is 90 seconds.

fn http1_writev(self, val: bool) -> Config<C, B>

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.

fn retry_canceled_requests(self, val: bool) -> Config<C, B>

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.

impl<C, B> Config<C, B> where
    C: Connect,
    B: Stream<Error = Error>,
    B::Item: AsRef<[u8]>, 

fn build(self, handle: &Handle) -> Client<C, B>

Construct the Client with this configuration.

fn executor<E>(self, executor: E) -> Client<C, B> where
    E: Executor<Background> + 'static, 

Construct a Client with this configuration and an executor.

The executor will be used to spawn "background" connection tasks to drive requests and responses.

impl<B> Config<UseDefaultConnector, B> where
    B: Stream<Error = Error>,
    B::Item: AsRef<[u8]>, 

fn build(self, handle: &Handle) -> Client<HttpConnector, B>

Construct the Client with this configuration.

Trait Implementations

impl Default for Config<UseDefaultConnector, Body>

fn default() -> Config<UseDefaultConnector, Body>

Returns the "default value" for a type.

impl<C, B> Debug for Config<C, B>

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<C: Clone, B> Clone for Config<C, B>

fn clone(&self) -> Config<C, B>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.