Journeyman
thin wrapper for middleware with node's http server
Example
var Journeyman = require('journeyman');
var port = 3000,
server = new Journeyman(port);
server.use(function(req, res) {
res.writeHead(200);
res.end(res.params);
});
server.use(function(req, res, next) { next(); });
server.use(function(req, res, next) {
res.params = 'WHERE AM I??';
next();
});
server.listen();
going to http://localhost:3000 will render out a success with the contents "WHERE AM I??"
SSL support
Pass the path to both the ssl key and certificate
var journeyman = new Journeyman(3001, { key: 'path/to/key', cert: 'path/to/certificate' });
Now with time profiling
Journeyman will emit events at the start and end of every request-response cycle
Start
Event
The server.on('start', function(req, res) {
console.log('********************************');
console.log('Response started');
console.log('********************************');
});
End
Event
The server.on('end', function(req, res, time) {
console.log('********************************');
console.log('Response completed in ' + time + ' seconds');
console.log('********************************');
});
Middleware error handling
The Middleware function has access to Journeyman itself through this
.
In your middleware you should handle errors by calling 'this.handleError' with request, response and an error string.
Middleware time profiling
Journeyman will also emit events at the beginning and end of each middleware
server.use(function(req, res, next) {
res.params = 'WHERE AM I??';
next();
}, 'middleware name');
Middleware name will default to 'default' if it is not set.
startMiddleware
Event
The server.on('startMiddleware', function(req, res, name) {
console.log('********************************');
console.log('Middleware: ' + name + ' has started');
console.log('********************************');
});
endMiddleware
Event
The server.on('endMiddleware', function(req, res, name, time) {
console.log('********************************');
console.log('Middleware: ' + name + ' completed in ' + time + ' seconds');
console.log('********************************');
});
Available middleware
- rivulet -- For easy server sent events
- lightning_strike -- For serving static content
- rudder -- For http routing