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 fn metrics(&self) -> MetricsRef

A clonable metrics reader that does not carry lifecycle.

Hand this to an exporter task instead of sharing the handle itself, so the handle keeps single ownership and graceful stop stays available.

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.

Takes &self so an Arc<ListenerHandle> can still drain — sharing the handle must not cost the graceful path. Calling it twice is safe: the second call observes the shutdown the first one completed.

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.