Struct ListenerHandle 

pub struct ListenerHandle { /* private fields */ }

Handle to a running listener (SRV-001).

stop performs the graceful shutdown: the accept loop ends, every connection finishes its in-flight requests, drains its writer and closes; stop resolves when the last connection is gone. Dropping the handle signals the same shutdown without waiting.

Implementations

impl ListenerHandle

pub fn local_addr(&self) -> SocketAddr

The bound address (resolves port 0 binds).

pub fn snapshot(&self) -> MetricsSnapshot

Point-in-time metrics (SRV-030).

pub async fn stop(self)

Graceful shutdown (SRV-001): stop accepting, let every connection drain its in-flight responses, and resolve once all of them closed.

Trait Implementations

impl Debug for ListenerHandle

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

Formats the value using the given formatter.

impl Drop for ListenerHandle

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.