Koa.js 是一个轻量级的 Node.js Web 框架，它采用了新一代的 async/await 进行异步代码的书写，同时提供了一组简洁的 API，让开发者可以更加高效地构建 Web 应用程序。在这篇文章中，我们将学习如何在 Koa.js 中启动时加载自定义中间件。
什么是中间件
在 Koa.js 中，中间件（Middleware）是用来处理 HTTP 请求和响应的函数，它会在请求到达服务器之后，以一定的顺序被调用。每个中间件函数都可以对请求和响应对象进行修改或拦截，或者将控制权传递给下一个中间件。
例如，以下是一个简单的中间件函数，它会在控制台输出所接收到的 HTTP 请求信息：
const loggerMiddleware = async (ctx, next) => { console.info(`${ctx.method} ${ctx.originalUrl}`); await next(); };
这个中间件函数接收两个参数：ctx 和 next。ctx 参数包含了请求和响应对象，可以获取到请求的路径（通过 ctx.originalUrl 属性），请求的方法（通过 ctx.method 属性）等信息。next 参数是一个回调函数，它用来将控制权传递给下一个中间件函数。
如果我们将这个中间件函数插入到中间件栈中，可以通过以下方式来实现：
const Koa = require('koa'); const app = new Koa(); app.use(loggerMiddleware);
上下文对象 ctx 和查询下一个中间件函数的 next 函数是 Koa 框架中两个最重要的对象，下面我们将通过完成加载自定义中间件来深入了解这两个对象的实现。
加载自定义中间件
自定义中间件可以通过 Node.js 模块的方式进行导出，并在应用程序启动时通过 app.use 方法进行加载，例如：
// exampleMiddleware.js const exampleMiddleware = async (ctx, next) => { console.log('example middleware'); await next(); }; module.exports = exampleMiddleware;
-- -------------------- ---- ------- -- ------ ----- --- - --------------- ----- ----------------- - ------------------------------- ----- --- - --- ------ --------------------------- ---------------- -- -- - ------------------- -- ------------- ---展开代码
可以看到，在应用程序中，我们引入了一个自定义中间件 exampleMiddleware，并通过 app.use 方法进行加载。
这里需要特别注意的是，中间件需要按照一定的顺序被加载，以确保正确地执行中间件函数。通常情况下，中间件函数都是顺序执行的，也就是说，第一个加载的中间件函数被最先调用，最后一个加载的中间件函数被最后调用。
上下文对象 ctx
上下文对象 ctx 是 Koa.js 中最重要的对象之一，它包含了请求和响应对象，并提供了一系列的方法和属性，来获取和设置请求和响应信息。
在加载自定义中间件的过程中，我们可以通过上下文对象来获取 HTTP 请求信息和响应信息，例如：
const exampleMiddleware = async (ctx, next) => { console.log('请求路径:', ctx.originalUrl); console.log('请求方法:', ctx.method); ctx.body = 'hello, world'; await next(); };
上面的例子展示了如何使用 ctx.originalUrl 和 ctx.method 获取请求的路径和请求的方法，并使用 ctx.body 来设置响应体的内容。
同时，上下文对象也提供了一些实用的属性和方法，例如：
ctx.request.body: 获取请求体内容。ctx.query: 获取 GET 请求中的查询参数。ctx.state: 用来存储应用程序的上下文状态。ctx.throw: 抛出 HTTP 错误，并设置响应状态码和错误信息。
通过上下文对象，我们可以获取到 HTTP 请求和响应的各种信息，并对其进行修改和拦截，以实现更加复杂和灵活的应用程序开发。
下一个中间件函数 next
下一个中间件函数 next 是 Koa.js 框架中另一个非常重要的对象，它是一个回调函数，在中间件函数执行完毕后，负责将控制权传递给下一个中间件函数。
在自定义中间件函数中，我们使用 await next() 来调用下一个中间件函数。如果没有调用 next()，将会产生 HTTP 响应状态码 404。
例如，下面的例子展示了如何将控制权传递给下一个中间件函数：
-- -------------------- ---- ------- ----- ----------------- - ----- ----- ----- -- - -------------------- ---------- ---- ----- ------- -------------------- ---------- - ----- -- ----- ------------------ - ----- ----- ----- -- - -------------------- ---------- ---- ----- ------- -------------------- ---------- - ----- -- --------------------------- ----------------------------展开代码
这个例子中，我们定义了两个自定义中间件函数，分别是 exampleMiddleware 和 exampleMiddleware2。在 exampleMiddleware 中，我们调用了 next() 函数，使得控制权传递给 exampleMiddleware2 函数。当 exampleMiddleware2 函数执行完毕后，控制权再次回到 exampleMiddleware1 函数，执行剩余的代码。
示例代码
最后，我们将上述的内容整合到一起，给出一个完整的示例代码：
-- -------------------- ---- ------- ----- --- - --------------- ----- ----------------- - ------------------------------- ----- --- - --- ------ ------------- ----- ----- -- - ----------------------- - -------- ----- ------- ----------------------- - ------ --- ------------- ----- ----- -- - ----------------------- - -------- ----- ------- ----------------------- - ------ --- --------------------------- ---------------- -- -- - ------------------- -- ------------- ---展开代码
// exampleMiddleware.js const exampleMiddleware = async (ctx, next) => { console.log('example middleware'); await next(); }; module.exports = exampleMiddleware;
以上代码中，我们定义了三个中间件函数，分别是匿名函数、exampleMiddleware 和匿名函数。当应用程序启动起来后，会依次执行这三个中间件函数，并输出日志信息。
通过这个示例代码，我们可以更加深入地了解 Koa.js 中自定义中间件的实现，同时也可以更加深入地理解上下文对象和下一个中间件函数的使用。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/67bc5e61a231b2b7eddedaa3
