koa中间件

1. koa中间件简介

在Koa中，中间件呈现为一个异步函数，该函数支持 async/await 语法，它接收两个参数： ctx 和 next 。 ctx 是对当前HTTP请求的封装，而 next 是一个函数，当被调用时，执行流程会进入下一个中间件。中间件的工作被 next() 分为前后两部分，next() 返回一个 Promise 对象。

中间件的作用十分广泛，包括但不限于身份验证、日志记录、请求处理等。它为开发人员提供了一种灵活的方式来处理请求并能够增加额外的逻辑层，而不必修改核心应用逻辑。

Koa的洋葱模型是一种独特的中间件执行机制，它以next()函数为分割点，先由外到内执行请求（Request）的逻辑，然后再由内到外执行响应（Response）的逻辑。这种模型确保了中间件的执行顺序，使得依赖其他中间件结果的中间件能够正确工作。

2. 中间件类型

1. 应用级中间件

应用级中间件绑定到 Koa 应用程序对象上，并在每个请求处理周期中执行。
应用级中间件通常用于执行跨路由的共享任务，比如日志记录、错误处理、身份验证等。
应用级中间件，匹配任何路由。

var router = new Router(); // 总路由
// 如果get,post回调函数中没有next参数，这个路由被匹配到了就不会继续向下匹配
app.use(async (ctx, next)=>{
  console.log('应用级中间件')
  next()
})
router.get('/abcd', async (ctx) => {
  ctx.body = '应用级中间件！'
});

// 使用路由中间件
app
  .use(router.routes())
  .use(router.allowedMethods());

app.listen(8081, function() {
  console.log('服务启动！端口号：8081')
});

2. 路由级中间件

路由级中间件与特定路由相关联，只在特定路由匹配时执行。
路由级中间件用于在特定路由上执行特定任务，比如请求验证、权限控制等。

const Koa = require('koa');
const app = new Koa();
var Router = require('koa-router');
var router = new Router(); // 总路由

app.use(async (ctx, next)=>{
  console.log('应用级中间件')
  next()
})
router.get('/abcd', async(ctx, next)=>{
  console.log('路由级中间件')
  next()
})
router.get('/abcd', async (ctx) => {
  ctx.body = '路由级中间件！'
});

// 使用路由中间件
app
  .use(router.routes())
  .use(router.allowedMethods());

app.listen(8081, function() {
  console.log('服务启动！端口号：8081')
});

3. 错误处理中间件

错误处理中间件用于捕获应用程序中发生的错误，并作出相应的处理。
在 Koa 中，错误处理中间件通常是最后一个中间件，用来处理未捕获的错误并发送适当的响应给客户端。

const Koa = require('koa');
const app = new Koa();
var Router = require('koa-router');
var router = new Router(); // 总路由

app.use(async (ctx, next)=>{
  console.log('应用级中间件')
  next()
  if(ctx.status == '404') {
    ctx.status = 404
    ctx.body = '404 页面'
  } else{
    ctx.body = ctx.url
  }
})
router.get('/abcd', async (ctx) => {
  ctx.body = '路由级中间件！'
});

// 使用路由中间件
app
  .use(router.routes())
  .use(router.allowedMethods());

app.listen(8081, function() {
  console.log('服务启动！端口号：8081')
});

4. 第三方中间件

1. koa-static
   api 文档

static(root, [opts])
root: 静态文件的根目录。
opts:

• maxage: 缓存控制，指定浏览器缓存的最大时间（毫秒）。
• hidden: 是否允许访问隐藏文件，默认为false。
• index: 默认索引文件名，默认为’index.html’。
• defer: 是否延迟发送，直至其他中间件执行完毕。
• gzip: 自动使用GZIP压缩文件，默认启用。
• brotli: 使用Brotli压缩，默认也启用。
• `setHeaders**: 自定义响应头设置的函数。
• extensions: 无扩展名请求时，尝试匹配数组中的扩展名来查找文件。

import path from 'path';
const Koa = require('koa');
const app = new Koa();
const staticKoa = require('koa-static')
const __dirname = path.resolve();
app.use(staticKoa(__dirname + '/uploads'))
// 使用koa-static中间件提供静态文件服务
// 或用 app.use(serve(path.join(__dirname, 'public')));
app.listen(8081, function() {
  console.log('服务启动！端口号：8081')
});

3.中间件执行流程

1.先应用级再路由级。
2.同级别的中间件，代码顺序会影响执行顺序。
3.不同级别代码顺序无影响，都是先执行应用级再路由级

const Koa = require('koa')
const app = new Koa()
const Router = require('koa-router')
var router = new Router(); // 总路由
app.use(async (ctx, next) => {
    console.log(1);
    await next();
    console.log(2);
})
 
router.get('/abcd', async (ctx, next) => {
  console.log('abcd11');
  await next();
  console.log('abcd22');
})
 
router.get('/abcd', async (ctx) => {
    console.log('abcd');
    ctx.body = "abcd页";
})
app.use(async (ctx, next) => {
  console.log(3);
  await next();
  console.log(4);
})
app
  .use(router.routes())
  .use(router.allowedMethods());
 
app.listen(8081, function() {
  console.log('服务启动！端口号：8081')
});