NNet::TWebServer< TSocket > Class Template Reference

HTTP/1.1 server that accepts connections and dispatches to a router. More...

#include <httpd.hpp>

Public Member Functions
	TWebServer (TSocket &&serverSocket, IRouter &router, std::function< void(const std::string &)> logger={})
	Constructs the server.
TVoidTask	Start ()
	Starts the accept loop as a detached TVoidTask.

Detailed Description

template<typename TSocket>
class NNet::TWebServer< TSocket >

HTTP/1.1 server that accepts connections and dispatches to a router.

Takes ownership of a bound, listening socket. Call Start() to launch the accept loop as a detached TVoidTask.

Template Parameters

TSocket

A bound+listening socket type (e.g. TDefaultPoller::TSocket).

using TSocket = TDefaultPoller::TSocket;
TSocket sock(loop.Poller(), addr.Domain());
sock.Bind(addr); sock.Listen();
 
MyRouter router;
TWebServer<TSocket> server(std::move(sock), router);
server.Start();
loop.Loop();

Constructor & Destructor Documentation

TWebServer()

template<typename TSocket>

NNet::TWebServer< TSocket >::TWebServer ( TSocket && serverSocket, IRouter & router, std::function< void(const std::string &)> logger = {} )

inline

Constructs the server.

Parameters

serverSocket	Bound, listening socket (moved in; owned by the server).
router	Request handler; must outlive this server.
logger	Optional nginx-style access-log callback.

Member Function Documentation

Start()

template<typename TSocket>

TVoidTask NNet::TWebServer< TSocket >::Start ( )

inline

Starts the accept loop as a detached TVoidTask.

Runs forever, accepting connections and spawning a per-connection handler coroutine for each. Returns immediately (the loop is detached).

Accept errors are reported only to the logger, so without one they are silent. After an error that is not transient the loop sleeps 100 ms and accepts again.

---

The documentation for this class was generated from the following file:

• coroio/http/httpd.hpp