Struct HttpListener 

pub struct HttpListener { /* private fields */ }

A running HTTP server that routes all inbound requests to a handler actor via StableAddr<HttpRequest>.

The listener runs as a Tokio background task. If the handler actor is restarted by its supervisor, the StableAddr transparently routes to the new incarnation — no listener reconfiguration required.

Drop or call shutdown to stop the server.

Implementations

impl HttpListener

pub async fn bind( addr: SocketAddr, handler: StableAddr<HttpRequest>, config: ListenerConfig, ) -> Result<Self, HttpError>

Bind a TCP port and begin routing requests to handler.

Preferred form: the StableAddr survives handler actor restarts.

pub async fn bind_plain( addr: SocketAddr, handler: Addr<HttpRequest>, config: ListenerConfig, ) -> Result<Self, HttpError>

Bind using a plain palladium_actor::Addr.

Equivalent to bind(addr, StableAddr::from_addr(handler), config). Requests will fail if the actor is restarted; prefer [bind].

pub fn local_addr(&self) -> SocketAddr

Returns the local address the listener is bound to.

pub async fn shutdown(self)

Gracefully shut down the listener.

Waits for in-flight requests to complete before returning.