This has been done for the purpose of abstracting away the handling of express on my rest services. As this code would be unnecessary and cluttering the real code.
This this is a small packages depending on express, systemd and body-parser for the purpose to directly mount my route-handlers and hook some middleware before it.
All routes are mounted for POST. As I want allmighty JSON RPCs for everything and nothing else.
Also by default proxy trust is set to 1. As it is mainly made for a nodejs service waiting behind a NGINX reverse-proxy to termine SSL. For information about proxy trust see here.
Also by default etag is disabled.
prepareAndExpose = (middleWare, routes, port = 3333)
getExpressApp = () -> expressApplicationroutes is an object which actually is a map of route -> function
routes = {}
routes.requestOne = (req, res) ->
# req.body is our json
# handle
res.send("The Response!")
routes.requestTwo = (re1, res) ->
# req.body is our json
# handle
res.send("The other Response!")
- Could be a single function
- or an array of functions
These will be mounted before we mount the routes. e.G authorization
When there is process.env.SOCKETMODE == true then we will listen on systemd socket.
Otherwise when there is process.env.PORT != 0 then we will listen on that port.
Ony when we donot specify these environment variables the port we provide would be listened on.
If we provide nothing then the default is port 3333.
Be aware this service is primarily thought to stay behind an nginx who terminates ssl for it - therefore proxypass to socket ;-).
So we donot use SSL here which might be a security concern to be aware of.
By default we set
-
proxy_trusttotrue -
etagtofalse
This is because we are always running behind our trusted nginx reverse proxy. Also we never deliver a ressource where caching could make sense.
Use getExpressApp() for any manual configuration.
See here.
All sorts of inputs are welcome, thanks!