Data.IterIO.Server.TCPServer

Generic building blocks for creating TCP Servers based on IterIO

Documentation

data TCPServer inp m

TCPServer holds all the information necessary to run bind to a sock and respond to TCP requests from the network.

Constructors

TCPServer

Fields

serverPort :: PortNumber

The TCP port the server will listen for incomming connections on.

serverHandler :: Inum inp inp m ()

This Inum implements the actual functionality of the server. The input and output of the Inum correspond to the input and output of the socket.

serverAcceptor :: Socket -> m (Iter inp m (), Onum inp m ())

A function to transform an accept incomming connection into an iter and onum. Most servers should just use defaultSocketAcceptor but this can be used for special cases, e.g. accepting SSL connections with iterSSL.

serverResultHandler :: m () -> IO ()

Must execute the monadic result. Servers operating in the IO Monad can use id.

Instances

Show (TCPServer inp m)

runTCPServer :: (ListLikeIO inp e, ChunkData inp, Monad m) => TCPServer inp m -> IO ()

Runs a TCPServer in a loop.

defaultServerAcceptor :: (ListLikeIO inp e, ChunkData inp, MonadIO m) => Socket -> m (Iter inp m (), Onum inp m a)

This acceptor creates an Iter and Onum using handleI and enumHandle respectively.

minimalTCPServer :: (ListLikeIO inp e, ChunkData inp) => TCPServer inp IO

For convenience, a TCPServer in the IO Monad with null defaults:

• Port 0 (next availabel port)
• Handler set to inumNop
• Acceptor set to defaultServerAcceptor
• Request handler set to id (noop)

simpleHttpServer :: PortNumber -> HttpRequestHandler IO () -> TCPServer ByteString IO

Creates a simple HTTP server from an HTTPRequestHandler.

echoServer :: PortNumber -> TCPServer String IO

Creates a TCPServer that echoes each line from the client until EOF.