HTTP Abstraction Layers

Created 2015-10-07 / Edited 2015-10-07

These are protocols or APIs or libraries that roughly abstract away HTTP serving from your application. Most of them take the form of:

function(request_environment) {
   # Look at the request environment, build some output
   return [ 200, { "Content-Type": "text/html" }, [ some_output ] ]
 }
 </code>

Which is to say, an "application" is defined as a function that takes in a request and returns a response. The request is typically key-value pairs that should then be further parsed into actual parameters and POST payload. The response is typically an HTTP status, a set of headers, and a body.

Variations are mostly around the body. Instead of a static string, several of these adapters allow a callback or promise of some sort, allowing for chunked or streaming results, and possibly even server-push results.

One of the coolest things this abstraction provides is an easy concept of "middleware". All you have to do is wrap this function (your "applicaiton") with another function that filters the input (request), calls your applicaiton-function, and then filters the response. This makes it easy to do lots of things neutral to your main application -- from logging to validating.

Note that some of these languages have multiple choices of API, and some have multiple implementations of the same API.

* Common Lisp - Clack
* Clojure - Ring
* Elixir - Plug
* Haskell - Hack2
* Java - Servlets. Kinda.
* Javascript - JSGI
* Lua - WSAPI
* .NET - [OWIN](http://owin.org/)
* Perl - PSGI
* Perl6 - P6SGI
* Python - WSGI
* Ruby - Rack
* Scala - SSGI
* Multiple - uWSGI