Struct HttpClient 

pub struct HttpClient { /* private fields */ }

HTTP client supporting both HTTP/2 and HTTP/1.1 connections.

Example

let mut client = HttpClient::connect_h2(addr, "example.com").await?;
let resp = client.get("/api/data").header("authorization", "Bearer tok").send().await?;
assert_eq!(resp.status(), 200);

Implementations

impl HttpClient

pub async fn connect_h2(addr: SocketAddr, host: &str) -> Result<Self, HttpError>

Connect using HTTP/2 over TLS.

pub async fn connect_h2_with_timeout( addr: SocketAddr, host: &str, timeout_ms: u64, ) -> Result<Self, HttpError>

Connect using HTTP/2 over TLS with a timeout (milliseconds).

pub async fn connect_h1(addr: SocketAddr, host: &str) -> Result<Self, HttpError>

Connect using HTTP/1.1 over TLS.

pub async fn connect_h1_plain( addr: SocketAddr, host: &str, ) -> Result<Self, HttpError>

Connect using HTTP/1.1 over plaintext TCP.

pub fn get(&mut self, path: &str) -> RequestBuilder<'_>

Build a GET request.

pub fn post(&mut self, path: &str) -> RequestBuilder<'_>

Build a POST request.

pub fn put(&mut self, path: &str) -> RequestBuilder<'_>

Build a PUT request.

pub fn delete(&mut self, path: &str) -> RequestBuilder<'_>

Build a DELETE request.

pub fn close(&self)

Close the underlying connection.

pub fn peer_will_close(&self) -> bool

Whether the peer has signalled the connection will close. For H1 this reflects Connection: close on the most recent response (or the HTTP/1.0 default); for H2 this reflects a GOAWAY frame. The Pool honours this automatically via the guard returned by Pool::client.