Struct Server 

pub struct Server { /* private fields */ }

A bound listener that has not started accepting yet.

Binding is separated from serving so the caller can learn the address — which matters when binding port 0 — without racing the accept loop.

Implementations

impl Server

pub async fn bind(addr: impl ToSocketAddrs) -> Result<Self>

Binds a listener without accepting anything yet.

Errors

Returns std::io::Error if the address cannot be bound.

pub const fn with_config(self, config: ServeConfig) -> Self

Applies limits to this server.

pub fn local_addr(&self) -> Result<SocketAddr>

The address actually bound, which is the only way to learn the port when binding to 0.

Errors

Returns std::io::Error if the socket cannot report its address.

pub async fn serve_with_shutdown( self, dispatcher: impl Dispatcher, shutdown: impl Future<Output = ()> + Send, ) -> ServeReport

Accepts until shutdown resolves, then drains.

Returns once every connection has finished or drain_timeout expires, whichever comes first — never before one of the two, which is the whole point of it existing.

Trait Implementations

impl Debug for Server

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

Formats the value using the given formatter.