插件示例：中间件

在 Fastify 中，中间件通常用于处理请求、响应生命周期中的某些操作，例如日志记录、跨域处理、请求验证等。Fastify 的中间件机制基于生命周期钩子实现，提供高效、灵活的处理方式。

中间件基本概念

Fastify 的中间件是通过钩子（hooks）来实现的。钩子允许在请求生命周期的不同阶段进行操作。

常见钩子类型：

• onRequest：在请求到达路由前触发。
• preHandler：在路由处理函数前触发。
• onResponse：在响应发送前触发。

示例：编写日志记录中间件

日志记录是常见的中间件需求。可以使用 onRequest 钩子记录每个请求的详细信息。

async function logMiddleware(fastify, options) {
  fastify.addHook('onRequest', (request, reply, done) => {
    console.log(`请求 URL: ${request.url}, 请求方法: ${request.method}`);
    done();
  });
}

module.exports = logMiddleware;

注册插件：

const fastify = require('fastify')();
fastify.register(require('./logMiddleware'));

每个请求都会输出日志信息，方便开发与调试。

示例：跨域支持中间件

跨域资源共享（CORS）是另一常见的中间件需求。可以通过中间件在请求到达路由前添加 CORS 头信息。

async function corsMiddleware(fastify, options) {
  fastify.addHook('onRequest', (request, reply, done) => {
    reply.header('Access-Control-Allow-Origin', '*');
    reply.header('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE');
    reply.header('Access-Control-Allow-Headers', 'Content-Type');
    done();
  });
}

module.exports = corsMiddleware;

注册插件后，所有请求都会带上 CORS 头信息。

示例：自定义验证中间件

可以在请求处理之前进行自定义验证，例如请求参数验证、用户认证等。

async function authMiddleware(fastify, options) {
  fastify.addHook('preHandler', async (request, reply) => {
    if (!request.headers['authorization']) {
      reply.status(401).send({ error: 'Unauthorized' });
    }
  });
}

module.exports = authMiddleware;

此中间件会在每个请求到达路由处理前，检查是否有有效的授权头。

中间件与插件的区别

Fastify 的插件系统与传统的中间件机制有所不同，插件不仅可以处理请求，还可以注册路由、装饰器、钩子等。与传统的中间件相比，Fastify 插件更加模块化和隔离，易于维护和扩展。

插件结构：

• 插件是一个函数，接收 fastify 实例和 options 参数。
• 插件可以是同步或异步的。
• 插件可以注册钩子、路由、装饰器等。

中间件在 Fastify 中实际上是通过钩子来实现的，因此可以把中间件看作是 Fastify 插件的一部分。

总结

通过 Fastify 的中间件插件机制，我们可以灵活地扩展和处理请求与响应。例如，日志记录、CORS 处理、身份验证等功能都可以通过插件来实现，并且能确保应用程序的模块化和可维护性。