API 的快速路由 - 当您有子资源时的 URL 处理程序

Question

我有两个资源，员工和员工组。我正在尝试实现一个不错的 URL 结构，例如：

• GET /employees 列出员工。
• GET /employees/123 获取员工 123。
• GET /employees/groups 列出员工组。
• GET /employees/groups/123获取员工组123。

使用 ExpressJS 我有：

router.get('/employees', (req, res, next) => { next(); });
router.get('/employees/:id', (req, res, next) => { next(); });
router.get('/employees/groups', (req, res, next) => { next(); });
router.get('/employees/groups/:id', (req, res, next) => { next(); });
router.all('*', (req, res) => { res.send('...'); });

这不起作用，因为 Express 无法区分 /employees/:id 和 /employees/groups。它认为groups 是id，因为/employees/:id 排在第一位。

我确实有类似的 URL：

• GET /employees
• GET /employees/123
• GET /employees-groups
• GET /employees-groups/123

哪个有效，但没有很好的资源/子资源格式。 groups 是 employees 的组，所以我希望 URL 与之匹配。

如果我要为员工获取组，那很好 (/employees/:id/groups)，但我会获取所有组，即员工组。

如何设置 Express 路由以正确路由，同时仍保持我想要的 URL 结构..？

我想我需要一种方法让 Express 区分 id 和子资源。有没有办法做到这一点..？

更新

我显然应该说我在每个处理程序中使用next()，因为我需要 Express 转移到另一个中间件函数，一个控制所有请求响应的中间件函数。实际发送响应的是另一个中间件函数。所以我需要：

1. 路由处理程序。
2. 所有请求的处理程序。

Answer 1

RobbyD 让我走上了正轨。这就是我最终得到的结果：

index.js

router.all('*', setupHandler);
router.get('/employees', getEmployees);
router.get('/employees/groups', getGroups);
router.get('/employees/groups/:id', getGroup);
router.get('/employees/:id', getEmployee);
router.use(errorHandler);

setupHandler()

function setupHandler(req, res, next) {
    res.locals.standardRes = {
        "some": "data"
    };
    res.locals.doResponse = (res) => {
        // ...
        res.json(res.locals.standardRes);
    };
    next();
}

getEmployees()

function getEmployees(req, res, next) {

    somethingThatReturnsAPromise().then(data => {
        // add to res.locals.standardRes here
        res.locals.doResponse(res);
    }).catch(err => {
        next(err);
    });

}

errorHandler()

function errorHandler(err, req, res, next) {
    console.log('err', err);
    // add to res.locals.standardRes here
    // set correct res.status here
    res.locals.doResponse(res);
}

因此，处理程序按照 RobbyD 的回答顺序排列。我使用res.locals 来保存响应函数（doResponse(res)）以从每个处理程序中调用。如果出现错误，我会照常调用next(err) 以转移到errorHandler()。

我想这一切都是为了获得从中间件到中间件的正确流程并在正确的时间发送响应。

Answer 2

Express 搜索第一个匹配的路由并使用提供的函数对其进行处理。

换一种方式试试：

router.get('/employees', (req, res) => {});
router.get('/employees/groups', (req, res) => {});
router.get('/employees/groups/:id', (req, res) => {});
router.get('/employees/:id', (req, res) => {});

现在 express 将通过路由工作，'/employees/123' 将仅匹配最后一个路由，因此 express 将使用一个。 '/employees/groups' 将很快被第二条路由匹配，并且将使用该路由。

非常简单，但这些事情可能会花费您一些时间来弄清楚。