Struct Client 

pub struct Client<C = HttpConnector> { /* private fields */ }

HTTP client with connection pooling, redirect handling, and retry support.

The default type parameter C = HttpConnector gives a plain HTTP-only client. Use HttpsClient (feature tls) for a TLS-capable client.

Created via Client::builder().build() or Client::builder().build_https().

Implementations

impl Client<HttpConnector>

Provide builder() only on the default Client<HttpConnector> variant so that type-inference works without annotation at call sites.

pub fn builder() -> ClientBuilder

Return a ClientBuilder for configuring a new client.

impl<C> Client<C>

where C: Connect + Clone + Send + Sync + 'static,

pub fn get(&self, url: &str) -> Result<RequestBuilder<C>, OxiHttpError>

Build a GET request for the given URL.

pub fn post(&self, url: &str) -> Result<RequestBuilder<C>, OxiHttpError>

Build a POST request for the given URL.

pub fn put(&self, url: &str) -> Result<RequestBuilder<C>, OxiHttpError>

Build a PUT request for the given URL.

pub fn delete(&self, url: &str) -> Result<RequestBuilder<C>, OxiHttpError>

Build a DELETE request for the given URL.

pub fn patch(&self, url: &str) -> Result<RequestBuilder<C>, OxiHttpError>

Build a PATCH request for the given URL.

pub fn head(&self, url: &str) -> Result<RequestBuilder<C>, OxiHttpError>

Build a HEAD request for the given URL.

pub async fn execute( &self, req: Request<Full<Bytes>>, ) -> Result<Response, OxiHttpError>

Execute a pre-built http::Request.

pub async fn get_bytes(&self, url: &str) -> Result<Bytes, OxiHttpError>

Convenience: GET the URL and return the response body as bytes.

pub async fn get_json<T: DeserializeOwned>( &self, url: &str, ) -> Result<T, OxiHttpError>

Convenience: GET the URL and deserialize the JSON response body.

pub async fn post_json<T: Serialize, R: DeserializeOwned>( &self, url: &str, body: &T, ) -> Result<R, OxiHttpError>

Convenience: POST JSON and deserialize the response.

pub fn retry_policy(&self) -> Option<&RetryPolicy>

Returns a reference to the retry policy, if configured.

pub fn connect_timeout(&self) -> Option<Duration>

Returns a reference to the connect timeout, if set.

pub fn read_timeout(&self) -> Option<Duration>

Returns a reference to the read timeout, if set.

Trait Implementations

impl<C: Clone> Clone for Client<C>

fn clone(&self) -> Client<C>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C> Debug for Client<C>

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

Formats the value using the given formatter.