KOA中间件与执行顺序

koa2中文文档

一、什么是Koa的中间件

通俗的讲:中间件就是匹配路由之前或者匹配路由完成做的一系列的操作,我们就可以把它叫做中间件。

在express中间件(Middleware) 是一个函数,它可以访问请求对象(request object (req)), 响应对象(response object (res)), 和 web 应用中处理请求-响应循环流程中的中间件,一般被命名为 next 的变量。在Koa中中间件和express有点类似。

中间件的功能包括:

执行任何代码。
修改请求和响应对象。
终结请求-响应循环。
调用堆栈中的下一个中间件。

如果我的get、post回调函数中,没有next参数,那么就匹配上第一个路由,就不会往下匹配了。如果想往下匹配的话,那么需要写next()

二、Koa应用可使用如下几种中间件:

应用级中间件
路由级中间件
错误处理中间件
第三方中间件

三、使用

    1. async和await
      在koa中使用关键词 async 标记的函数是异步函数,
      在异步函数中使用 await next(); 处理下一个异步函数。
    1. app.use(async func())
      koa的使用方法很简单,将一系列要处理的操作封装到一个个异步函数中,然后用Koa的实例app通过 app.use(async func()) 的形式调用

一个koa应用程序如下:

// 导入koa,和koa 1.x不同,在koa2中,我们导入的是一个class,因此用大写的Koa表示:
const Koa = require('koa');
const app = new Koa(); // 创建一个Koa对象表示web app本身:

// 对于任何请求,app将调用该异步函数处理请求:
app.use(async (ctx, next) => {
    await next();
    ctx.response.type = 'text/html';
    ctx.response.body = '<h1>Hello, koa2!</h1>';
});

// 在端口3000监听:
app.listen(3000);
console.log('app started at port 3000...');

可以看到 app.use() 括号里面的参数是一个函数。函数用了异步修饰符 async ,在这个函数内部,又通过关键字 await next() 调用下一个app.use的异步函数。如果这个函数是最后一个需要执行的函数,则内部不需要再写await next()。

四、koa中间件的执行顺序

Express的中间件是顺序执行,从第一个中间件执行到最后一个中间件,发出响应。
Koa是从第一个中间件开始执行,遇到 await next() 就进入下一个中间件,一直到执行到最后一个中间件。然后再逆序执行上一个中间件 await next() 后面的代码,一直到第一个中间件 await next() 后面的代码执行完毕才发出响应。

koa把很多async函数组成一个处理链,每个async函数都可以做一些自己的事情,然后用await next()来调用下一个async函数。我们把每个async函数称为middleware,这些middleware可以组合起来,完成很多有用的功能。

例子:

app.use(async (ctx, next) => {
    console.log('1'); 
    await next(); // 调用下一个middleware
    console.log('5')
});

app.use(async (ctx, next) => {
    console.log('2');
    await next(); // 调用下一个middleware
    console.log('4');
});

app.use(async (ctx, next) => {
    console.log('3');
});

输出结果: 12345