Struct PooledClient 

pub struct PooledClient<'a> { /* private fields */ }

A pool-owned handle to an HttpClient.

Borrows the pool exclusively while alive; derefs to &mut HttpClient. On drop, the guard inspects HttpClient::peer_will_close and recycles its slot (closes the underlying connection and marks the slot for lazy reconnect) when the peer has signalled close — avoiding the request-smuggling-class hazard of sending a fresh request on a connection the server is about to close.

Implementations

impl PooledClient<'_>

pub fn slot(&self) -> usize

Index of the underlying slot in the pool. Useful for callers that want to explicitly recycle (e.g., on an application-level error the guard’s peer_will_close check would not catch).

Methods from Deref<Target = HttpClient>

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.

Trait Implementations

impl Deref for PooledClient<'_>

type Target = HttpClient

The resulting type after dereferencing.

fn deref(&self) -> &HttpClient

Dereferences the value.

impl DerefMut for PooledClient<'_>

fn deref_mut(&mut self) -> &mut HttpClient

Mutably dereferences the value.

impl Drop for PooledClient<'_>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.