Your server is my stage -- dirt simple URL routing for Node.js. Easy to use, easy to understand. Sinatra-style API.
(This has been tested with Node.js v0.2.0-v0.4.8. Should work with all subsequent versions too.)
Get npm if you don't already have it,
and then just run npm install choreographer
.
Dirt simple:
var http = require('http'),
router = require('choreographer').router();
router.get('/chatroom/*/messages', function(req, res, room) {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('No messages in ' + room + '.\n');
})
.post('/chatroom/*/message', function(req, res, room) {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Posted message to ' + room + '.\n');
})
.notFound(function(req, res) {
res.writeHead(404, {'Content-Type': 'text/plain'});
res.end('404: This server is just a skeleton for a chat server.\n' +
'I\'m afraid ' + req.url + ' cannot be found here.\n');
});
http.createServer(router).listen(80);
Routes are easily made case-insensitive with the optional ignoreCase
flag:
router.get('/HelloWorld', true, function(req, res) {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Hello, World!\n');
});
Routes default to case-sensitive without the flag, but you can change that:
//routes defined up 'til now defaulted to case-sensitive if flag omitted
router.ignoreCase = true;
//routes defined following default to case-insensitive if flag omitted
A star *
in a route matches anything up to a slash /
, but if you want to
match slashes too you can simply use two stars **
:
router.get('/static/**', function(req, res, path) {
serveStaticFiles(path); //path could be 'file.ext' or 'folders/file.ext'
});
Most flexibly, regular expressions may also be used as routes:
router.get(/^\/hw(\d+)$/i, function(req, res, hwNum) {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Homework '+hwNum+' isn\'t available yet.\n');
});
There's also put
, delete
and head
, and that's it! That's the entire
API, simple and easy to use.
As in Sinatra, routes are first-come, first-serve (only the callback for the
first route to be matched by a request is invoked, and routes are matched in
the order they are defined). Also as in Sinatra, creating get
routes
automatically creates head
routes.
Notice that router
is just an event listener for the request
event on
http.createServer
, so if you want a listener that does more than routing:
http.createServer(function(req, res) {
//do middleware stuff before routing
router.apply(this, arguments);
//do more stuff
}).listen(80);
The code is just as simple: first half is the router, second half is the routes. Lightweight and easy to understand.
The entire architecture is designed around the philosophy of being so simple it obviously has no bugs, rather than so complicated it has no obvious bugs.