Struct HttpServer 

pub struct HttpServer { /* private fields */ }

A running server spawned onto the tokio runtime. Dropping the handle aborts the accept loop (mirrors relay::RelayServer). The handler must be Send; the interpreter’s !Send handler uses Listener/Conn directly instead.

The handle also carries the Lifecycle, so an embedder can flip readiness (HttpServer::set_ready) and drain gracefully (HttpServer::drain) exactly as an orchestrator’s SIGTERM handler would.

Implementations

impl HttpServer

pub fn addr(&self) -> SocketAddr

The bound address (resolve :0 to its real port for clients).

pub fn url(&self) -> String

The http://… base URL a client dials.

pub fn set_ready(&self, ready: bool)

Flip the readiness gate: false sheds new requests with 503 (a load balancer stops routing), true serves them — independent of liveness (the accept loop stays up either way).

pub fn is_ready(&self) -> bool

Whether the server is currently serving (ready and not draining).

pub async fn drain(&self, deadline: Duration) -> DrainOutcome

Gracefully drain: stop accepting new connections (new requests shed with 503), wait up to deadline for in-flight requests to finish, and return the still-running count as DrainOutcome::dropped (0 = every in-flight request completed). Never hangs past deadline.

pub fn lifecycle(&self) -> &Lifecycle

The shared lifecycle handle (for advanced embedders).

Trait Implementations

impl Drop for HttpServer

fn drop(&mut self)

Executes the destructor for this type.