Struct bdrck::http::client::Client

pub struct Client { /* fields omitted */ }

Client is the standard, non-testing implementation of AbstractClient. If debug assersions are enabled, then this structure also provides a mechanism for recording an HTTP session.

Methods

impl Client

pub fn new() -> Self

Initialize a new client.

pub fn new_with_recording<P: AsRef<Path>>(recording_output: P) -> Self

Initialize a new client, which will record its HTTP session and write the result to the given path once it is destructed.

Trait Implementations

impl AbstractClient for Client

fn execute(&self, request: Request) -> Result<(ResponseMetadata, Vec<u8>)>

Execute (send) a previously-constructed HTTP request.

fn get(&self, url: Url) -> RequestBuilder

Returns a builder for an HTTP GET request.

fn post(&self, url: Url) -> RequestBuilder

Returns a builder for an HTTP POST request.

fn put(&self, url: Url) -> RequestBuilder

Returns a builder for an HTTP PUT request.

fn patch(&self, url: Url) -> RequestBuilder

Returns a builder for an HTTP PATCH request.

fn delete(&self, url: Url) -> RequestBuilder

Returns a builder for an HTTP DELETE request.

fn head(&self, url: Url) -> RequestBuilder

Returns a builder for an HTTP HEAD request.

fn sleep(&self, sleep: fn(_: Duration), duration: Duration)

This function calls the given custom sleep function with the given Duration. This can be overridden by a trait implementor to add extra logic, if needed.

fn execute_with_retries(
    &self,
    max_retries: usize,
    add_jitter: bool,
    method: Method,
    url: Url,
    headers: Option<&HeaderMap>,
    body: Option<&[u8]>
) -> Result<(ResponseMetadata, Vec<u8>)>

Execute (send) a previously-constructed HTTP request. In the case of a retryable failure (a 5xx error), we'll retry up to max_retries with exponential backoff between each attempt.

fn execute_with_retries_custom_sleep(
    &self,
    sleep: fn(_: Duration),
    max_retries: usize,
    add_jitter: bool,
    method: Method,
    url: Url,
    headers: Option<&HeaderMap>,
    body: Option<&[u8]>
) -> Result<(ResponseMetadata, Vec<u8>)>

This is the same as execute_with_retries, but you can specify a custom sleep function (as opposed to std::thread::sleep).

impl Drop for Client

fn drop(&mut self)

Executes the destructor for this type.