Struct HttpClient 

pub struct HttpClient<S, D> { /* private fields */ }

HTTP client. S = socket (BlockingSocketFactory), D = DNS (DnsResolver).

Clone shares the connection pool (and cookie store when enabled) via Arc.

use barehttp::HttpClient;

let client = HttpClient::new();
let response = client.get("http://example.com").call()?;

Implementations

impl HttpClient<OsBlockingSocket, OsDnsResolver>

pub fn new() -> Self

OS socket + DNS, default config.

pub fn with_config(config: Config) -> Self

OS socket + DNS, custom config.

impl<S, D> HttpClient<S, D>

where S: BlockingSocketFactory, D: DnsResolver,

pub fn with_adapters(dns: D, config: Config) -> Self

Custom DNS + config. Socket type S comes from S::new() at connect time (HttpClient::<OsBlockingSocket, _>::with_adapters(dns, config)).

pub fn method( &self, method: Method, url: impl AsRef<str>, ) -> ClientRequestBuilder<S, D>

Request with an arbitrary method.

pub fn get(&self, url: impl AsRef<str>) -> ClientRequestBuilder<S, D>

GET (no body).

pub fn post(&self, url: impl AsRef<str>) -> ClientRequestBuilder<S, D>

POST (body via ClientRequestBuilder::send / ClientRequestBuilder::call).

pub fn put(&self, url: impl AsRef<str>) -> ClientRequestBuilder<S, D>

PUT (body via ClientRequestBuilder::send / ClientRequestBuilder::call).

pub fn delete(&self, url: impl AsRef<str>) -> ClientRequestBuilder<S, D>

DELETE (no request body).

pub fn head(&self, url: impl AsRef<str>) -> ClientRequestBuilder<S, D>

HEAD (no body).

pub fn patch(&self, url: impl AsRef<str>) -> ClientRequestBuilder<S, D>

PATCH (body via ClientRequestBuilder::send / ClientRequestBuilder::call).

pub fn cookie_store(&self) -> &CookieStore

Shared cookie store (cookie-jar feature).

Borrow of the store (not Arc); clone the client (or call again) to share without depending on the internal shared-ownership shape.

pub fn config(&self) -> &Config

Shared client config.

pub fn request( &self, method: Method, url: impl AsRef<str>, custom_headers: &Headers, body: Option<impl AsRef<[u8]>>, ) -> Result<Response, Error>

Redirect loop; each hop connect / write / read.

Body is copied once into an owned buffer (needed for redirect replay). Pass None::<&[u8]> when there is no body.

Errors

Error::InvalidRequest for Method::Connect (no tunnel API), Error::InvalidUrl, Error::Dns, Error::Socket, Error::Parse, redirect / TLS / size-limit variants, or Error::HttpStatus when configured.

pub fn request_with_config( &self, config: &Config, method: Method, url: impl AsRef<str>, custom_headers: &Headers, body: Option<impl AsRef<[u8]>>, ) -> Result<Response, Error>

Self::request with a caller-supplied config.

Body is copied once into an owned buffer (needed for redirect replay). Pass None::<&[u8]> when there is no body.

Errors

Same as Self::request.

Trait Implementations

impl<S, D> Clone for HttpClient<S, D>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S, D> Debug for HttpClient<S, D>

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

Formats the value using the given formatter.

impl Default for HttpClient<OsBlockingSocket, OsDnsResolver>

fn default() -> Self

Returns the “default value” for a type.