Struct actix_web::client::ClientBuilder

pub struct ClientBuilder { /* fields omitted */ }

An HTTP Client builder

This type can be used to construct an instance of Client through a builder-like pattern.

Methods

impl ClientBuilder

pub fn new() -> ClientBuilder

pub fn connector<T>(self, connector: T) -> ClientBuilder where
    T: Service<Request = Connect, Error = ConnectError> + 'static,
    <T as Service>::Response: Connection,
    <<T as Service>::Response as Connection>::Future: 'static,
    <T as Service>::Future: 'static, 

Use custom connector service.

pub fn timeout(self, timeout: Duration) -> ClientBuilder

Set request timeout

Request timeout is the total time before a response must be received. Default value is 5 seconds.

pub fn disable_timeout(self) -> ClientBuilder

Disable request timeout.

pub fn disable_redirects(self) -> ClientBuilder

Do not follow redirects.

Redirects are allowed by default.

pub fn max_redirects(self, num: usize) -> ClientBuilder

Set max number of redirects.

Max redirects is set to 10 by default.

pub fn no_default_headers(self) -> ClientBuilder

Do not add default request headers. By default Date and User-Agent headers are set.

pub fn header<K, V>(self, key: K, value: V) -> ClientBuilder where
    V: IntoHeaderValue,
    HeaderName: HttpTryFrom<K>,
    <HeaderName as HttpTryFrom<K>>::Error: Debug,
    <V as IntoHeaderValue>::Error: Debug, 

Add default header. Headers added by this method get added to every request.

pub fn basic_auth<U>(self, username: U, password: Option<&str>) -> ClientBuilder where
    U: Display, 

Set client wide HTTP basic authorization header

pub fn bearer_auth<T>(self, token: T) -> ClientBuilder where
    T: Display, 

Set client wide HTTP bearer authentication header

pub fn finish(self) -> Client

Finish build process and create Client instance.