▼Web Server: Racket HTTP Server
►1 Dispatching Server
On this page:
1.1 Dispatching Server Signatures
dispatch-server^
serve
serve-ports
dispatch-server-config^
port
listen-ip
max-waiting
initial-connection-timeout
read-request
dispatch
1.2 Dispatching Server Unit
dispatch-server@
1.3 Threads and Custodians
  top← prev  up  next → 

1 Dispatching Server

The Web Server is just a configuration of a dispatching server.

1.1 Dispatching Server Signatures

 (require web-server/private/dispatch-server-sig)
The web-server/private/dispatch-server-sig library provides two signatures.

dispatch-server^ : signature

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

(serve) → (-> void)
Runs the server and returns a procedure that shuts down the server.

(serve-ports ip op) → void
  ip : input-port?
  op : output-port?
Serves a single connection represented by the ports ip and op.

dispatch-server-config^ : signature

port : port-number?
Specifies the port to serve on.
listen-ip : (or/c string? false/c)
Passed to tcp-listen.
max-waiting : integer?
Passed to tcp-accept.
initial-connection-timeout : integer?
Specifies the initial timeout given to a connection.
(read-request c p port-addresses) → 
any/c boolean?
  c : connection?
  p : port-number?
  port-addresses : (input-port? . -> . (values string? string?))
Defines the way the server reads requests off connections to be passed to dispatch.
dispatch : (-> connection? any/c void)
How to handle requests.

1.2 Dispatching Server Unit

 (require web-server/private/dispatch-server-unit)
The web-server/private/dispatch-server-unit module provides the unit that actually implements a dispatching server.

dispatch-server@ : 
(unit/c (import tcp^ dispatch-server-config^)
        (export dispatch-server^))
Runs the dispatching server config in a very basic way, except that it uses Connection Manager to manage connections.

1.3 Threads and Custodians

The dispatching server runs in a dedicated thread. Every time a connection is initiated, a new thread is started to handle it. Connection threads are created inside a dedicated custodian that is a child of the server’s custodian. When the server is used to provide servlets, each servlet also receives a new custodian that is a child of the server’s custodian not the connection custodian.

  top← prev  up  next →