Struct chttp::client::Client

source ·

pub struct Client { /* private fields */ }

Expand description

An HTTP client for making requests.

The client maintains a connection pool internally and is expensive to create, so we recommend re-using your clients instead of discarding and recreating them.

Implementations

source

impl Client

source

pub fn new() -> Result<Self, Error>

Create a new HTTP client using the default configuration.

If the client fails to initialize, an error will be returned.

source

pub fn builder() -> ClientBuilder

Create a new builder for building a custom client.

source

pub fn get(&self, uri: U) -> Result<Response<Body>, Error>where
Uri: HttpTryFrom,

Sends an HTTP GET request.

The response body is provided as a stream that may only be consumed once.

source

pub fn head(&self, uri: U) -> Result<Response<Body>, Error>where
Uri: HttpTryFrom,

Sends an HTTP HEAD request.

source

pub fn post(
 &self,
 uri: U,
 body: impl Into<Body>
) -> Result<Response<Body>, Error>where
 Uri: HttpTryFrom,

Sends an HTTP POST request.

The response body is provided as a stream that may only be consumed once.

source

pub fn put(
 &self,
 uri: U,
 body: impl Into<Body>
) -> Result<Response<Body>, Error>where
 Uri: HttpTryFrom,

Sends an HTTP PUT request.

The response body is provided as a stream that may only be consumed once.

source

pub fn delete(&self, uri: U) -> Result<Response<Body>, Error>where
Uri: HttpTryFrom,

Sends an HTTP DELETE request.

The response body is provided as a stream that may only be consumed once.

source

pub fn send<B: Into<Body>>(
&self,
request: Request
) -> Result<Response<Body>, Error>

Sends a request and returns the response.

The request may include extensions to customize how it is sent. If the request contains an Options struct as an extension, then those options will be used instead of the default options this client is configured with.

The response body is provided as a stream that may only be consumed once.