Struct ServeHandle 

pub struct ServeHandle { /* private fields */ }

Control handle for one endpoint serve cycle.

Clones control the same cycle and carry the same internal token. The common server path stores one clone in the endpoint before returning another to an adapter, making adapter registration an idempotent confirmation.

Implementations

impl ServeHandle

pub fn shutdown(&self)

Gracefully stop the serve loop: stop accepting new connections, drain in-flight requests (up to drain_timeout), then close the remaining active connections so no request is served after the loop has stopped.

pub fn shutdown_and_close(&self)

Stop the accept loop and force every active connection closed immediately, without waiting for the graceful drain.

Unlike [shutdown], which drains in-flight requests before closing connections, this severs the connections up front so remote peers must reconnect right away. Used when a serve loop is being replaced on the same endpoint (#336).

pub async fn drain(self)

pub fn abort(&self)

pub fn drain_timeout(&self) -> Duration

pub fn subscribe_done(&self) -> Receiver<bool>

Subscribe to the serve-loop-done signal.

The returned receiver resolves (changes to true) once the serve task has fully exited, including the drain phase.

Trait Implementations

impl Clone for ServeHandle

fn clone(&self) -> ServeHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.