listenHTTP

Starts a HTTP server listening on the specified port.

request_handler will be called for each HTTP request that is made. The res parameter of the callback then has to be filled with the response data.

request_handler can be either HTTPServerRequestDelegate/HTTPServerRequestFunction or a class/struct with a member function 'handleRequest' that has the same signature.

Note that if the application has been started with the --disthost command line switch, listenHTTP() will automatically listen on the specified VibeDist host instead of locally. This allows for a seamless switch from single-host to multi-host scenarios without changing the code. If you need to listen locally, use listenHTTPPlain() instead.

Parameters

settings Settings

Customizes the HTTP servers functionality (host string or HTTPServerSettings object)

request_handler HTTPServerRequestHandlerS

This callback is invoked for each incoming request and is responsible for generating the response.

Return Value

A handle is returned that can be used to stop listening for further HTTP requests with the supplied settings. Another call to listenHTTP can be used afterwards to start listening again.

Meta