2013-08-17 07:15:57 +00:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Module dependencies.
|
|
|
|
|
*/
|
|
|
|
|
|
2013-08-28 04:23:11 +00:00
|
|
|
var debug = require('debug')('koa:application');
|
2013-08-17 07:15:57 +00:00
|
|
|
var Emitter = require('events').EventEmitter;
|
|
|
|
|
var compose = require('koa-compose');
|
2013-08-17 22:36:51 +00:00
|
|
|
var context = require('./context');
|
2013-08-21 04:51:14 +00:00
|
|
|
var Cookies = require('cookies');
|
2013-08-17 07:15:57 +00:00
|
|
|
var Stream = require('stream');
|
|
|
|
|
var http = require('http');
|
|
|
|
|
var co = require('co');
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Application prototype.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
var app = Application.prototype;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Expose `Application`.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
exports = module.exports = Application;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Initialize a new `Application`.
|
|
|
|
|
*
|
|
|
|
|
* @api public
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
function Application() {
|
|
|
|
|
if (!(this instanceof Application)) return new Application;
|
|
|
|
|
this.env = process.env.NODE_ENV || 'development';
|
2013-09-08 16:37:33 +00:00
|
|
|
this.on('error', this.onerror);
|
2013-08-22 02:48:47 +00:00
|
|
|
this.outputErrors = 'test' != this.env;
|
2013-08-17 07:15:57 +00:00
|
|
|
this.subdomainOffset = 2;
|
|
|
|
|
this.poweredBy = true;
|
|
|
|
|
this.jsonSpaces = 2;
|
|
|
|
|
this.middleware = [];
|
2013-10-05 19:27:15 +00:00
|
|
|
this.Context = createContext();
|
2013-08-17 22:36:51 +00:00
|
|
|
this.context(context);
|
2013-08-17 07:15:57 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Inherit from `Emitter.prototype`.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
Application.prototype.__proto__ = Emitter.prototype;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Shorthand for:
|
|
|
|
|
*
|
|
|
|
|
* http.createServer(app.callback()).listen(...)
|
|
|
|
|
*
|
|
|
|
|
* @param {Mixed} ...
|
|
|
|
|
* @return {Server}
|
|
|
|
|
* @api public
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
app.listen = function(){
|
|
|
|
|
var server = http.createServer(this.callback());
|
|
|
|
|
return server.listen.apply(server, arguments);
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Use the given middleware `fn`.
|
|
|
|
|
*
|
|
|
|
|
* @param {Function} fn
|
|
|
|
|
* @return {Application} self
|
|
|
|
|
* @api public
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
app.use = function(fn){
|
2013-08-28 04:23:11 +00:00
|
|
|
debug('use %s', fn.name || '-');
|
2013-08-17 07:15:57 +00:00
|
|
|
this.middleware.push(fn);
|
|
|
|
|
return this;
|
|
|
|
|
};
|
|
|
|
|
|
2013-08-17 22:36:51 +00:00
|
|
|
/**
|
2013-08-18 18:15:22 +00:00
|
|
|
* Mixin `obj` to this app's context.
|
2013-08-17 22:36:51 +00:00
|
|
|
*
|
2013-08-18 18:15:22 +00:00
|
|
|
* app.context({
|
|
|
|
|
* get something(){
|
|
|
|
|
* return 'hi';
|
|
|
|
|
* },
|
|
|
|
|
*
|
|
|
|
|
* set something(val){
|
|
|
|
|
* this._something = val;
|
|
|
|
|
* },
|
|
|
|
|
*
|
|
|
|
|
* render: function(){
|
|
|
|
|
* this.body = '<html></html>';
|
|
|
|
|
* }
|
|
|
|
|
* });
|
2013-08-17 22:36:51 +00:00
|
|
|
*
|
|
|
|
|
* @param {Object} obj
|
|
|
|
|
* @return {Application} self
|
|
|
|
|
* @api public
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
app.context = function(obj){
|
2013-08-18 18:14:01 +00:00
|
|
|
var ctx = this.Context.prototype;
|
2013-08-28 04:24:53 +00:00
|
|
|
var names = Object.getOwnPropertyNames(obj);
|
2013-10-05 19:27:15 +00:00
|
|
|
|
2013-08-28 04:24:53 +00:00
|
|
|
debug('context: %j', names);
|
|
|
|
|
names.forEach(function(name){
|
2013-10-05 19:56:36 +00:00
|
|
|
if (Object.getOwnPropertyDescriptor(ctx, name)) {
|
|
|
|
|
debug('context: overwriting %j', name);
|
|
|
|
|
}
|
2013-08-17 22:36:51 +00:00
|
|
|
var descriptor = Object.getOwnPropertyDescriptor(obj, name);
|
|
|
|
|
Object.defineProperty(ctx, name, descriptor);
|
|
|
|
|
});
|
2013-10-05 19:27:15 +00:00
|
|
|
|
2013-08-17 22:36:51 +00:00
|
|
|
return this;
|
|
|
|
|
};
|
|
|
|
|
|
2013-08-17 07:15:57 +00:00
|
|
|
/**
|
|
|
|
|
* Return a request handler callback
|
2013-08-30 21:09:18 +00:00
|
|
|
* for node's native http server.
|
2013-08-17 07:15:57 +00:00
|
|
|
*
|
|
|
|
|
* @return {Function}
|
|
|
|
|
* @api public
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
app.callback = function(){
|
|
|
|
|
var mw = [respond].concat(this.middleware);
|
2013-11-08 00:15:47 +00:00
|
|
|
var gen = compose(mw);
|
2013-08-17 07:15:57 +00:00
|
|
|
var self = this;
|
|
|
|
|
|
|
|
|
|
return function(req, res){
|
2013-08-18 18:14:01 +00:00
|
|
|
var ctx = new self.Context(self, req, res);
|
2013-08-17 07:15:57 +00:00
|
|
|
|
2013-11-08 00:15:47 +00:00
|
|
|
co.call(ctx, gen)(function(err){
|
2013-08-28 03:24:04 +00:00
|
|
|
if (err) ctx.onerror(err);
|
|
|
|
|
});
|
2013-08-17 07:15:57 +00:00
|
|
|
}
|
|
|
|
|
};
|
|
|
|
|
|
2013-08-22 02:47:56 +00:00
|
|
|
/**
|
|
|
|
|
* Default error handler.
|
|
|
|
|
*
|
|
|
|
|
* @param {Error} err
|
|
|
|
|
* @api private
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
app.onerror = function(err){
|
2013-09-14 03:54:52 +00:00
|
|
|
if (!this.outputErrors) return;
|
|
|
|
|
if (404 == err.status) return;
|
|
|
|
|
console.error(err.stack);
|
2013-08-22 02:47:56 +00:00
|
|
|
};
|
|
|
|
|
|
2013-08-17 07:15:57 +00:00
|
|
|
/**
|
|
|
|
|
* Response middleware.
|
|
|
|
|
*/
|
|
|
|
|
|
2013-11-08 00:15:47 +00:00
|
|
|
function *respond(next){
|
|
|
|
|
this.status = 200;
|
|
|
|
|
if (this.app.poweredBy) this.set('X-Powered-By', 'koa');
|
2013-09-01 23:27:03 +00:00
|
|
|
|
2013-11-08 00:15:47 +00:00
|
|
|
yield next;
|
2013-08-17 07:15:57 +00:00
|
|
|
|
2013-11-08 00:15:47 +00:00
|
|
|
var app = this.app;
|
|
|
|
|
var res = this.res;
|
|
|
|
|
var body = this.body;
|
|
|
|
|
var head = 'HEAD' == this.method;
|
|
|
|
|
var noContent = 204 == this.status || 304 == this.status;
|
2013-08-17 07:15:57 +00:00
|
|
|
|
2013-11-08 00:15:47 +00:00
|
|
|
// 404
|
|
|
|
|
if (null == body && 200 == this.status) {
|
|
|
|
|
this.status = 404;
|
|
|
|
|
}
|
2013-08-17 22:36:51 +00:00
|
|
|
|
2013-11-08 00:15:47 +00:00
|
|
|
// ignore body
|
|
|
|
|
if (noContent) return res.end();
|
2013-08-17 07:15:57 +00:00
|
|
|
|
2013-11-08 00:15:47 +00:00
|
|
|
// status body
|
|
|
|
|
if (null == body) {
|
|
|
|
|
this.type = 'text';
|
|
|
|
|
body = http.STATUS_CODES[this.status];
|
|
|
|
|
}
|
2013-08-17 07:15:57 +00:00
|
|
|
|
2013-11-08 00:15:47 +00:00
|
|
|
// Buffer body
|
|
|
|
|
if (Buffer.isBuffer(body)) {
|
|
|
|
|
if (head) return res.end();
|
|
|
|
|
return res.end(body);
|
|
|
|
|
}
|
2013-08-17 22:36:51 +00:00
|
|
|
|
2013-11-08 00:15:47 +00:00
|
|
|
// string body
|
|
|
|
|
if ('string' == typeof body) {
|
2013-08-17 07:15:57 +00:00
|
|
|
if (head) return res.end();
|
2013-11-08 00:15:47 +00:00
|
|
|
return res.end(body);
|
2013-08-17 07:15:57 +00:00
|
|
|
}
|
|
|
|
|
|
2013-11-08 00:15:47 +00:00
|
|
|
// Stream body
|
|
|
|
|
if (body instanceof Stream) {
|
|
|
|
|
if (!~body.listeners('error').indexOf(this.onerror)) body.on('error', this.onerror);
|
|
|
|
|
if (head) return res.end();
|
|
|
|
|
return body.pipe(res);
|
|
|
|
|
}
|
2013-08-17 07:15:57 +00:00
|
|
|
|
2013-11-08 00:15:47 +00:00
|
|
|
// body: json
|
|
|
|
|
body = JSON.stringify(body, null, this.app.jsonSpaces);
|
|
|
|
|
this.length = Buffer.byteLength(body);
|
|
|
|
|
if (head) return res.end();
|
|
|
|
|
res.end(body);
|
|
|
|
|
}
|
2013-08-18 18:14:01 +00:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Create a new `Context` constructor.
|
|
|
|
|
*
|
|
|
|
|
* @return {Function}
|
|
|
|
|
* @api private
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
function createContext() {
|
|
|
|
|
return function Context(app, req, res){
|
|
|
|
|
this.app = app;
|
|
|
|
|
this.req = req;
|
|
|
|
|
this.res = res;
|
2013-08-21 04:51:14 +00:00
|
|
|
this.cookies = new Cookies(req, res);
|
2013-10-04 06:55:26 +00:00
|
|
|
this.onerror = this.onerror.bind(this);
|
2013-08-18 18:14:01 +00:00
|
|
|
}
|
|
|
|
|
}
|
