package resto-cohttp-server

A handle on the server worker.

A callback passed to Cohttp_lwt_unix.Server.make_response_action. Callbacks are exposed in order to give users a way to modify the arguments of the callback used to launch the server, or add some behaviour.

Initializes the server

resto_callback server is the default callback for resto. It can be used as is so the server simply handles requests. For example:

let server = Server.init_server ~media_types directory in
let callback = Server.resto_callback server in
Server.launch server ~callback (`TCP (`Port port))

Which, as resto_callback is the default, is equivalent to:

let server = Server.init_server ~media_types directory in
Server.launch server (`TCP (`Port port))

Optionally, it can be transformed in order to provide additional functionalities. For example:

let server = Server.init_server ~media_types directory in
let callback = Server.resto_callback server in
let auth_callback conn req bod =
  if check_auth req bod then
    callback con req bod
  else Lwt.return @@ `Response ... (* some form of response with 401 or 403 *)
in
Server.launch server ~callback:auth_callback (`TCP (`Port port)) >>= fun () ->
...

launch server ?conn_closed ?callback listening_protocol starts the given resto server initiating the listening loop using the listening_protocol.

• parameter [callback]

  overwrites (if given) the default handler of resto each http query will be treated by.

• parameter [conn_closed]

  is an optional function that is called when a connection is closed.

Initializes the server using the given arguments and starts it using resto_callback http handler. This is a condensed form of init_server, resto_callback, and launch.

configure the access list for this server

Kill an RPC server.