Struct ConnectionInfo 

pub struct ConnectionInfo {
    pub client: Address,
    pub server: Address,
    pub request_size: i64,
    pub sni_hostname: Option<String>,
    pub tls: bool,
}

Network context for the current connection, passed into every Controller.

Fields

client: Address

Client (peer) address.

server: Address

Server (local) address.

request_size: i64

Bytes allocated for reading the request.

sni_hostname: Option<String>

SNI hostname sent by the client during the TLS handshake, if any. None for plain-HTTP connections or when the client omits SNI.

tls: bool

The client connected over TLS (HTTPS, HTTP/2 over TLS, HTTP/3). Proxies send it on as X-Forwarded-Proto (18.9.0).

Implementations

impl ConnectionInfo

pub fn new(client: Address, server: Address) -> Self

A connection from client to server; plain (not TLS), no SNI, the default request allocation size. Set tls/sni_hostname after.

pub fn peer_addr(&self) -> Option<SocketAddr>

Parse the client address into a std::net::SocketAddr, if the stored IP and port are valid. Returns None if parsing fails.

Trait Implementations

impl Clone for ConnectionInfo

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ConnectionInfo

fn default() -> Self

Unknown addresses (0.0.0.0:0), no SNI, not TLS: for building one with ..Default::default() in tests and adapters.