koa+orm2

koa+orm2

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的错，并且提示语也不多。第一次遇到的时候用了好久才找到原因所在，希望其他小伙伴引以为戒，既然使用某个框架一定要遵循其要求。