Struct ConnectionKey 

pub struct ConnectionKey {
    pub peer: SocketAddr,
    pub transport: TransportKind,
    pub identity: Option<Arc<str>>,
    pub path: Option<Arc<str>>,
}

What makes two connections the same connection.

Not the address alone, and each of the other two fields earns its place.

The transport, because TCP, TLS and QUIC to one address are not interchangeable: a sips: request riding a cleartext socket has silently become what it asked not to be. With WebSocket in the mix the case stops being theoretical — WS and TCP can and do share a port.

The URI authority/verified identity, because two names resolving to one address are still distinct TLS identities and distinct WebSocket HTTP authorities. Reusing one for another either throws away certificate verification or sends traffic on an upgrade granted to a different virtual host. None on a connection a peer opened: sipx selected no outbound authority.

The WebSocket resource, for the same reason one step down: a socket upgraded at /ws was accepted by whatever serves /ws, and handing it traffic that asked for /other ignores the only thing the target said about where it wanted to go. None everywhere the question does not arise — every other transport, and every connection a peer opened.

Fields

peer: SocketAddr

The far end.

transport: TransportKind

Which transport it speaks.

identity: Option<Arc<str>>

Original URI host: verified for TLS/WSS and used as authority for WS/WSS.

path: Option<Arc<str>>

The resource the upgrade asked for, for WebSocket connections sipx opened.

Implementations

impl ConnectionKey

pub fn new(peer: SocketAddr, transport: TransportKind) -> Self

A connection with nothing verified about it and no resource named — anything a peer opened, and every cleartext transport.

pub fn ws_path(&self) -> &str

The resource a WebSocket handshake for this connection asks for.

/ when the target named none, which is what RFC 6455 §3 requires of a request-target that would otherwise be empty and what every server serving SIP at its root expects.

Trait Implementations

impl Clone for ConnectionKey

fn clone(&self) -> ConnectionKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectionKey

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

Formats the value using the given formatter.

impl Hash for ConnectionKey

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ConnectionKey

fn eq(&self, other: &ConnectionKey) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ConnectionKey

impl StructuralPartialEq for ConnectionKey