¤ simpleHttpServer, SimpleHttpRequest, et al

Types

simpleHttpServer :: (a -> SimpleHttpRequest -> (a, SimpleHttpResponse)) -> a -> Port -> IO ()
type SimpleHttpRequest = (Host, CalendarTime, HttpRequest String)
data SimpleHttpResponse
replyWith :: HttpResponse -> SimpleHttpResponse
replyWithFile :: FilePath -> SimpleHttpResponse
saveThen :: (FilePath, String) -> SimpleHttpResponse -> SimpleHttpResponse

Synopsis

simpleHttpServer serverFunc initialState port

Description

Arguments

serverFunc :: a -> SimpleHttpRequest -> (a, SimpleHttpResponse)

This is the function that implements your server. When applied to the current state and a request, it should return a new state and a response.

initialState :: a

The initial state of the server. For stateless servers, you can use ().

port :: Port

The number of the port the server will be listening for requests at. Web servers usually use port 80, but servers started by users without special privileges may be restricted to port numbers above 1024. Often 8080 is used, which means the server will be available at URL http://myhost:8080/, if started on a computer named myhost.

A SimpleHttpRequest contains the name of the host connecting to the server, the time at which the connection was made, and the HttpRequest received from the client (browser). In the request, the URL is represented as a string.

There are three ways to construct SimpleHttpResponse to be returned by the server:

• To return a document generated by the server itself, use replyWith, e.g. replyWith (okResponse html) to return a normal HTML web page.
• To return the contents of a file, use replyWithFile applied to the file name. The extention of the file name determines the Mime type of the returned document. The server has builtin support for the most common types of documents (html, xml, txt, jpg, gif, png, pdf, ps, mp3, ...), others are labelled with the type application/octet-stream.
• To save some information in a file before returning a response, use saveThen. (This can be used to save the current state of the server, to allow it to be read back in if the server is restarted.)

See Also

Request and response types: HttpRequest and HttpResponse.

Functions for analysing requests: getQuery et al.

Functions for constructing server respones: okResponse et al.