如何扩展 Express.js 的路由类-JavaScript中文网-JavaScript教程资源分享门户

如何扩展 Express.js 的路由类

Express.js 是一个广泛使用的 Node.js Web 框架，由于其简洁、灵活和易于扩展的特点，成为了很多 Web 应用开发者的首选框架。在 Express.js 中，路由是一个核心概念，它负责将每个请求映射到相应的处理器函数上。在本文中，我们将介绍如何扩展 Express.js 的路由类，以实现更加灵活、易于使用的路由处理功能。

Express.js 路由类的基本用法

在 Express.js 中，路由类是通过 express.Router() 函数创建的，其基本用法如下所示：

// www.javascriptcn.com code example
const express = require('express');
const router = express.Router();

router.get('/', (req, res) => {
  res.send('Hello, world!');
});

router.post('/', (req, res) => {
  res.send('Received a POST request');
});

module.exports = router;

在上面的代码中，我们定义了一个路由对象 router，它将 GET 和 POST 方法分别映射到了 / 路径。当有请求到达该路径时，路由将自动调用相应的处理器函数来处理请求。这里的处理器函数可以是任何可调用的对象，例如函数、类的方法等。

路由类的扩展

尽管 Express.js 的路由类已经提供了很多强大的功能，但是在一些场景下我们仍然需要进行自定义扩展。下面介绍一些常见的扩展方法。

1. 构造函数参数

在定义路由类时，可以通过构造函数的形式传入一些初始参数，以在创建对象时进行配置。例如，可以定义一个基础路由类，通过传入 path 参数来设置路由的根路径。

// www.javascriptcn.com code example
class BaseRouter extends express.Router {
  constructor(path) {
    super();
    this.path = path;
  }

  mount(app) {
    app.use(this.path, this);
  }
}

module.exports = BaseRouter;

该路由类将 path 参数保存在自身的属性中，在 mount 方法中调用 app.use 方法将其挂载到应用上。可以通过继承该类来实现各种自定义路由类，并通过传入不同的参数来配置不同的根路径和其他选项。

2. 处理器函数装饰器

在路由类中，处理器函数是最基本的请求处理逻辑。为了让处理器函数更加易于使用和灵活，我们可以定义一些装饰器来对其进行扩展。例如，可以定义一个装饰器来自动处理异常。

// www.javascriptcn.com code example
function errorHandler(fn) {
  return function(req, res, next) {
    try {
      fn(req, res, next);
    } catch(err) {
      console.error(err);
      next(err);
    }
  };
}

在上面的代码中，我们定义了一个 errorHandler 装饰器，它接收一个处理器函数作为参数，并返回一个新的函数。该新函数会调用原始的处理器函数并捕获其异常。如果发生异常，会将错误打印到控制台，并将其传递给下一个错误处理器。

要使用该装饰器，可以通过类装饰器或方法装饰器的方式对处理器函数进行修饰。例如，在路由类中，我们可以定义一个装饰器放在方法前面，表示将该方法装饰成自动处理异常的模式：

class MyRouter extends express.Router {
  @errorHandler
  handleRequest(req, res) {
    throw new Error('Oops!');
  }
}

在上面的代码中，handleRequest 方法被 @errorHandler 装饰器修饰，因此可以自动处理异常，并将异常传递给下一个错误处理器。

3. 路由参数装饰器

在一些有复杂请求参数的场景下，我们需要对请求参数进行解析和验证等操作。为了让这些操作更加通用和易于使用，我们可以定义一些装饰器来对请求参数进行解析和验证，并将解析后的参数注入到处理器函数中。

例如，我们可以定义一个@parseQueryParams装饰器，它可以解析 GET 参数，并将结果注入到处理器函数中：

// www.javascriptcn.com code example
function parseQueryParams(target, propertyKey, descriptor) {
  const originalMethod = descriptor.value;

  descriptor.value = function(req, res, next) {
    let params = {};
    for (const [key, value] of Object.entries(req.query)) {
      params[key] = JSON.parse(value);
    }
    return originalMethod.call(this, req, res, params, next);
  };
  
  return descriptor;
}

在上面的代码中，我们定义了一个@parseQueryParams装饰器，它接受三个参数：target表示被修饰的类或对象，propertyKey表示被修饰的方法名，descriptor表示被修饰方法的一个包含属性的描述符对象。

要使用该装饰器，我们只需要在方法前面加上@parseQueryParams装饰器即可自动解析 GET 参数，并将结果注入到处理器函数中：

class MyRouter extends express.Router {
  @parseQueryParams
  handleRequest(req, res, params) {
    console.log(params);
    res.sendStatus(200);
  }
}

在上面的代码中，handleRequest 方法被 @parseQueryParams 装饰器修饰，因此可以自动解析 GET 参数，并将结果注入到处理器函数中。

结语

通过上面的介绍，我们可以看到，扩展 Express.js 的路由类可以大大提高其灵活性和易用性。我们可以根据实际需求，定义自己的装饰器、路由类和处理器函数，并将它们结合起来，构成一个灵活、可扩展的 Web 应用框架。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/67d63d12a941bf7134bef4dd

如何扩展 Express.js 的路由类