signature dispatch-server^ : signature

The dispatch-server^ signature is an alias for web-server^.

procedure (serve)

→ (->* () (#:confirmation-channel (or/c false/c async-channel?)) (-> void))

Runs the server—the confirmation channel will be send an exception if one occurs starting the server or the port number if there is none—and returns a procedure that shuts down the server.

procedure (serve-ports ip op) → void

ip : input-port?

op : output-port?

Serves a single connection represented by the ports ip and op.

signature dispatch-server-connect^ : signature

The dispatch-server-connect^ signature abstracts the conversion of connection ports (e.g., to implement SSL) as used by the dispatch server.

procedure (port->real-ports ip op)   →   input-port?   output-port?

ip : input-port?

op : output-port?

Converts connection ports as necessary.

The connection ports are normally TCP ports, but an alternate implementation of tcp^ linked to the dispatcher can supply different kinds of ports.

signature dispatch-server-config^ : signature

value port : listen-port-number?

Specifies the port to serve on.

value listen-ip : (or/c string? false/c)

Passed to tcp-listen.

value max-waiting : exact-nonnegative-integer?

Passed to tcp-listen.

value initial-connection-timeout : integer?

Specifies the initial timeout given to a connection.

procedure (read-request c p port-addresses)   →   any/c   boolean?

c : connection?

p : listen-port-number?

port-addresses : (input-port? . -> . (values string? string?))

Defines the way the server reads requests off connections to be passed to dispatch.

value dispatch : (-> connection? any/c void)

How to handle requests.

value dispatch-server-with-connect@

:  (unit/c (import tcp^                 dispatch-server-connect^                 dispatch-server-config^)         (export dispatch-server^))