Struct Client 

pub struct Client { /* private fields */ }

Shared settings for outbound requests.

Implementations

impl Client

pub fn new() -> Self

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

pub fn retries(self, retries: u32) -> Self

Retry connection failures and timeouts, with exponential backoff.

Only transport failures are retried; a 500 is not, because the request may already have had an effect on the server.

pub fn breaker(self, breaker: CircuitBreaker) -> Self

Stop calling a host that is failing, and probe it before resuming.

Pass one breaker to every client that shares an upstream, so what one of them learns the others act on. See crate::breaker.

pub fn circuit(&self) -> Option<&CircuitBreaker>

The breaker this client is using, to ask about a host’s state.

pub fn default_header(self, name: &str, value: impl Into<String>) -> Self

pub fn faking(self, fake: Fake) -> Self

Answer from a script instead of the network, for tests.

This is Http::fake() — an application’s tests should never depend on a third-party API being up.

pub fn fake(&self) -> Option<&Arc<Fake>>

pub fn request(&self, method: Method, url: impl Into<String>) -> RequestBuilder

pub fn get(&self, url: impl Into<String>) -> RequestBuilder

pub fn post(&self, url: impl Into<String>) -> RequestBuilder

pub fn put(&self, url: impl Into<String>) -> RequestBuilder

pub fn patch(&self, url: impl Into<String>) -> RequestBuilder

pub fn delete(&self, url: impl Into<String>) -> RequestBuilder

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Client

fn default() -> Self

Returns the “default value” for a type.