A black and white image of the author Kolja Dummann

event driven webserver with F#.

I am always open to experiemt with new stuff, so this time I did something I wanted to do for a long time: play a bit with F#. I read some book about it in the past, but never had the chance to really do something with it. I was always fascinated by the expressiv code that you are able to create with it. Since my current spare time poject is using a webserver I thought it would be a nice idea to implement some stuff for it with F#. I am now rewriting the hole server component of the trainmonitor in F# to get a feeling for it. Here is the first part of code I wrote that is nothing more that a wrapper around the HttpListener of the .Net framework. I have written similar stuff in C# to get a async event based server for C#, but what I alway felt ugly about was the way the controlflow was distibuted all over the place. Wouldn’t it be nice to just write code like this:

server.Get |>  Observable.add greeting

Which simply replies “hello world” to any get request? Ok this is a little trick since “greeting” is a function that does the hard work but even if I write it more verbose is looks like this:

server.Get |>  Observable.add (fun(ctx) -> response ctx |> write "hello world" |> close)

Still quite nice? And even if you don’t know much about the language or how the methods are implemented you can read whats going on. It observes the servers “Get” event then it extracts the response, writes “hello world” and closes the response. Ok now how it works? Lets have a look at the hole code:

open logv.http
[<EntryPoint>]
let main argv =
    let server = new Server("localhost", 13337)

    server.Start()

    server.Get |>  Observable.add (fun(ctx) -> response ctx |> write "hello world" |> close)
    System.Console.ReadLine() |> ignore
    server.Stop()

The magic seems to happen in the logv.http module. This is a module written by me that offers some methods and a server class to interact with the HttpListener of the framework in a more sophisticated way. Due to the nature of F# and its lightwight syntax it offer sime kind of mirco domain specific language to work with. E.g. the “response” keyword is a function for real that extracts the response from a HttpListenerContext and the write function writes a string to such a response combined together it looks like they would be part of the language. If you are interested in the hole code you can find it a the end of this post. Since I just started porting the code I will keep posting my experience in a small series of blog posts in the near future.

namespace logv
     module http =
        open System.Net

        /// <summary>Extracts the response from HttpListenerContext</summary>
        /// <param name="ctx">The HttpListenerContext to extract the response from</param>
        ///<returns>The HttpListenerResponse from the Context</returns>
        let response (ctx : HttpListenerContext) = ctx.Response
        /// <summary>Extracts the reqeust from HttpListenerContext</summary>
        /// <param name="ctx">The HttpListenerContext to extract the request from</param>
        ///<returns>The HttpListenerRequest from the Context</returns>
        let request (ctx : HttpListenerContext) = ctx.Request
        let body (req : HttpListenerRequest) = async {
                let decode b = req.ContentEncoding.GetString(b)

                let stream = req.InputStream
                let! bytes = stream.AsyncRead((int)stream.Length)
                return decode bytes
            }

        let writeCode501 (res : HttpListenerResponse) =
            res.StatusCode <- 501
            res

        let write (data : string) (res : HttpListenerResponse) =
            let bytes = System.Text.Encoding.UTF8.GetBytes(data)
            let stream = res.OutputStream
            stream.Write(bytes, 0 , bytes.Length)
            res

        let requestUrl (ctx :HttpListenerContext) = ctx.Request.RawUrl
        let endsWith(pattern : string) (target : string) = target.EndsWith(pattern)
        let startsWith(pattern : string) (target : string) = target.StartsWith(pattern)
        let contains (pattern : string) (target : string)  = target.Contains(pattern)
        let matches (pattern : string) (target : string) = System.Text.RegularExpressions.Regex.IsMatch(target, pattern)

        let close (res : HttpListenerResponse) = res.Close()

        type Server(host : string, port : int) = class
            let cts = new System.Threading.CancellationTokenSource()
            let listener = new HttpListener()
            let getEvent = new Event<_>()
            let postEvent = new Event<_>()
            let putEvent = new Event<_>()
            let deleteEvent = new Event<_>()
            let patchEvent = new Event<_>()

            let handleContext(ctx :HttpListenerContext) =
                match ctx.Request.HttpMethod with
                | "GET" -> getEvent.Trigger(ctx)
                | "POST" -> postEvent.Trigger(ctx)
                | "PUT" -> putEvent.Trigger(ctx)
                | "DELETE" -> deleteEvent.Trigger(ctx)
                | "PATCH" -> patchEvent.Trigger(ctx)
                | _ -> response ctx |> writeCode501 |> close

            let mailbox = MailboxProcessor.Start(fun inbox ->
                let loop =
                    async {
                    while true do
                        let! ctx = inbox.Receive()
                        handleContext ctx
                    }
                loop
                )
            let rec requestLoop(token : System.Threading.CancellationToken) = async {
                let! context = Async.FromBeginEnd(listener.BeginGetContext, listener.EndGetContext)
                mailbox.Post(context)
                if token.IsCancellationRequested = false then
                    return! requestLoop(token)
             }

            member val Host = host with get
            member val Port = port with get
            ///Starts the webserver
            member this.Start() =
                listener.Prefixes.Add("http://" + host + ":" + port.ToString() + "/")
                listener.Start()
                Async.Start(requestLoop(cts.Token))
            ///Stops the webserver
            member x.Stop() =
                cts.Cancel()
                listener.Stop()
            ///Event for handling a GET request
            member x.Get = getEvent.Publish
            ///Event for handling a POST request
            member x.Post = postEvent.Publish
            ///Event for handling a PUT request
            member x.Put = putEvent.Publish
            ///Event for handling a DELETE request
            member x.Delete = deleteEvent.Publish
            ///Event for handling a PATCH request
            member x.Patch = patchEvent.Publish
        end