Struct HttpReceiver 

pub struct HttpReceiver { /* private fields */ }

Implementations

impl HttpReceiver

pub fn new<T: AsRef<str>>(host: T) -> Self

Creates a new HttpReceiver instance bound to the specified host address. Example: 127.0.0.1:8080.

pub fn tls<T: AsRef<Path>>( self, tls_server_cert_path: T, tls_server_key_path: T, ) -> Self

Enables TLS for incoming connections using the provided server certificate and private key in .pem format and configures the TLS context and sets supported ALPN protocols to allow HTTP/2 and HTTP/1.1.

pub fn route<T, Fut, S>(self, path: S, callback: T) -> Self

where T: Fn(String, HttpRequest) -> Fut + Send + Sync + 'static, Fut: Future<Output = HttpResponse> + Send + 'static, S: AsRef<str>,

Registers a route with a path, associating it with a handler callback.

pub fn on_event<T, Fut>(self, handler: T) -> Self

where T: Fn(HttpReceiverEvent) -> Fut + Send + Sync + 'static, Fut: Future<Output = ()> + Send + 'static,

Registers an asynchronous event handler callback for incoming HttpReceiverEventSignals.

This sets up a background task that listens for system signals (SIGTERM, SIGINT) and incoming events from the internal event channel.

pub async fn receive(self)

Starts the HTTP server and begins listening for incoming TCP connections (optionally over TLS).

This method binds to the configured host address and enters a loop to accept new TCP connections. It also listens for system termination signals (SIGINT, SIGTERM) to gracefully shut down the server.