Struct Connected

pub struct Connected { /* private fields */ }

Available on crate features client and client-legacy only.

Extra information about the connected transport.

This can be used to inform recipients about things like if ALPN was used, or if connected to an HTTP proxy.

Implementations

impl Connected

pub fn new() -> Connected

Create new Connected type with empty metadata.

pub fn proxy(self, is_proxied: bool) -> Connected

Set whether the connected transport is to an HTTP proxy.

This setting will affect if HTTP/1 requests written on the transport will have the request-target in absolute-form or origin-form:

• When proxy(false):

GET /guide HTTP/1.1

• When proxy(true):

GET http://hyper.rs/guide HTTP/1.1

Default is false.

pub fn is_proxied(&self) -> bool

Determines if the connected transport is to an HTTP proxy.

pub fn extra<T: Clone + Send + Sync + 'static>(self, extra: T) -> Connected

Set extra connection information to be set in the extensions of every Response.

pub fn get_extras(&self, extensions: &mut Extensions)

Copies the extra connection information into an Extensions map.

pub fn negotiated_h2(self) -> Connected

Set that the connected transport negotiated HTTP/2 as its next protocol.

pub fn is_negotiated_h2(&self) -> bool

Determines if the connected transport negotiated HTTP/2 as its next protocol.

pub fn poison(&self)

Poison this connection

A poisoned connection will not be reused for subsequent requests by the pool

Trait Implementations

impl Debug for Connected

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

Formats the value using the given formatter.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 32 bytes