koa是由 Express 原班人马打造的新的web框架。套用其官方的说法:Koa 应用是一个包含一系列中间件 generator 函数的对象。 这些中间件函数基于 request 请求以一个类似于栈的结构组成并依次执行。
koa的中间件系统原理:
Koa的精妙之处就在于其基于promise的中间件系统的实现,避免了免除重复繁琐的回调函数嵌套。Koa的中间件是一系列generator函数的对象,执行起来有点类似于栈的结构,依次执行。从网上找到一张图可以比较形象的说明koa的中间件是如何工作的:
每个中间件都是generator函数,当一个请求过来的时候,会依次经过各个中间件进行处理,当遇到await next()时,Koa 暂停了该中间件,执行下一个中间件。直到某个中间件不调用下个中间件,即没有处理await next()。则kao会逆序向上依次执行被暂停的中间件的剩余部分逻辑。
代码实例如下:
1 const Koa = require('koa');
2 const app = new Koa();
3 /**
4 * 请求依次进入下面三个中间件
5 * */
6 // x-response-time
7 app.use(async function (ctx, next) {
8 /**
9 * 首先获得start时间
10 * */
11 const start = new Date();
12 /**
13 * 遇到next中间件的调用,则暂停该中间件。执行下一个即logger
14 * */
15 await next();
16 /**
17 * logger,完全执行之后,继续下面的部分
18 * */
19 const ms = new Date() - start;
20 console.log('X-Response-Time', `${ms}ms`);
21 /**
22 * 至此,整个请求执行结束。
23 * */
24
25 });
26 // logger
27 app.use(async function (ctx, next) {
28 const start = new Date();
29 /**
30 * 获得start之后,暂停。执行response
31 * */
32 await next();
33 /**
34 * response执行之后,获得执行权继续执行下面逻辑。
35 * */
36 const ms = new Date() - start;
37 console.log(`${ctx.method} ${ctx.url} - ${ms}`);
38 /**
39 * 执行完毕,将执行权交个上个中间件,即x-response-time
40 * */
41 };
42 //response
43 app.use(async function(ctx,next){
44 /**
45 * 执行之后,没有下一个中间件的调用,即 await next();
46 * 则向上执行logger,余下的部分
47 * */
48 ctx.body = 'Hello World';
49 })
50
51 app.listen(3000);
上面代码执行的顺序为:
1、请求开始时,请求先经过 x-response-time,
当遇到await next()时,暂停当前调用下个中间件。
2、logger
中间件执行当遇到await next()时,暂停当前调用下个中间件。
3、reponse
中间件执行,执行完成,将控制权交给上个中间件即logger。
4、logger执行await next()后面的逻辑,打印相应信息。完成之后,将控制权交给上个中间件即 x-response-time。
5、 x-response-time执行剩下的部分,打印相应信息。
当我们使用koa的时候,应该通过use添加一个中间件,处理相关的任务。注意该中间件也应该按照koa的要求为generator函数的形式。
kao+node-orm2需要注意的部分:
作为Node.js 的ORM框架orm2也是比较流行的。作为后端开发的时候,与express框架的结合也是比较合适的。如果想要配合koa的使用就要注意一下。
前面提到的koa的中间件是要求generator函数,起码基于promise。而orm2数据库连接则是原本的回调方式进行的。
var orm = require('orm');
orm.connect('mysql://root:password@localhost/test', function(err, db) {
if (err) return console.error('Connection error: ' + err);
// connected
// ...
});
这样两者就不能很好的合并使用了。如果想要同时使用的话,解决方法也是比较鲜明的,如何让orm2处理数据库连接等api以promise的方式暴露出来。
解决方式还是比较多的,比较方便的是,使用对orm2进行了promise包装的qOrm来代替直接引用orm。然后通过app.use引入即可。这样的话数据库连接中间件的代码可以如下:
1 var orm = require('orm');
2 var qOrm = require('q-orm');
3 var dbSet = require('../../config/setting');
4
5 var connection = null;
6
7 function setup(db) {
8 require('../models/demoModel')(qOrm, db);
9 require('../models/personModel')(qOrm, db);
10 require('../models/questionModel')(qOrm, db);
11 }
12 module.exports = async function (ctx,next) {
13 if (connection){
14 await next();
15 } else{
16 await qOrm.qConnect(dbSet).then(function(db){
17 connection = db;
18 setup(db);
19 ctx.req.models = db.models;
20 ctx.req.db = db;
21 });
22 await next();
23 }
24 };
使用koa一定要理解koa的基本思想,即通过中间件系统依次处理不同任务。这就要求各部分必须满足koa中间件的要求:中间件为ggenerator,而传统的回调方式进行处理的方法不会返回promise的对象给koa来判断当前处理次序。因此会报Module not found的错,并且提示语也不多。第一次遇到的时候用了好久才找到原因所在,希望其他小伙伴引以为戒,既然使用某个框架一定要遵循其要求。