koa的中間件是如何設(shè)計(jì)的疮胖?
koa是開(kāi)源的疾宏,直接在github中獲取源碼:https://github.com/koajs/koa
package.json:
{
main: 'lib/application.js'
}
application文件中定義了koa實(shí)例的方法,如:listen, use等等洲拇。
在listen方法中使用http.createServer(this.callback());定義http服務(wù)。
以下將listen, use, callback的源碼展示。
application.js:
listen(...args) {
debug('listen');
const server = http.createServer(this.callback());
return server.listen(...args);
}
use(fn) {
if (typeof fn !== 'function') throw new TypeError('middleware must be a function!');
if (isGeneratorFunction(fn)) {
deprecate('Support for generators will be removed in v3. ' +
'See the documentation for examples of how to convert old middleware ' +
'https://github.com/koajs/koa/blob/master/docs/migration.md');
fn = convert(fn);
}
debug('use %s', fn._name || fn.name || '-');
this.middleware.push(fn);
return this;
}
callback() {
const fn = compose(this.middleware);
if (!this.listenerCount('error')) this.on('error', this.onerror);
const handleRequest = (req, res) => {
const ctx = this.createContext(req, res);
return this.handleRequest(ctx, fn);
};
return handleRequest;
}
use方法中的核心代碼:
this.middleware.push(fn);
callback方法中的核心代碼:
const fn = compose(this.middleware);
這里的compose方法是第三方模塊koa-compose. koa-compose的源碼只有48行句旱,如下:
'use strict'
/**
* Expose compositor.
*/
module.exports = compose
/**
* Compose `middleware` returning
* a fully valid middleware comprised
* of all those which are passed.
*
* @param {Array} middleware
* @return {Function}
* @api public
*/
function compose (middleware) {
if (!Array.isArray(middleware)) throw new TypeError('Middleware stack must be an array!')
for (const fn of middleware) {
if (typeof fn !== 'function') throw new TypeError('Middleware must be composed of functions!')
}
/**
* @param {Object} context
* @return {Promise}
* @api public
*/
return function (context, next) {
// last called middleware #
let index = -1
return dispatch(0)
function dispatch (i) {
if (i <= index) return Promise.reject(new Error('next() called multiple times'))
index = i
let fn = middleware[i]
if (i === middleware.length) fn = next
if (!fn) return Promise.resolve()
try {
return Promise.resolve(fn(context, dispatch.bind(null, i + 1)));
} catch (err) {
return Promise.reject(err)
}
}
}
}
核心是dispatch函數(shù),通過(guò)遞歸把各個(gè)中間件連接起來(lái)晰奖。
因?yàn)閞eturn的類型是Promise,所以在使用next()的時(shí)候需要在前面加await谈撒。