Предположим, я хочу иметь конечные точки REST, которые выглядят примерно так:

/user/
/user/user_id 

/user/user_id/items/
/user/user_id/items/item_id

CRUD на каждый, если имеет смысл. Например, / user POST создает нового пользователя, GET выбирает всех пользователей. / user / user_id GET выбирает только этого одного пользователя.

Элементы зависят от пользователя, поэтому я помещаю их в user_id , который является конкретным пользователем.

Теперь, чтобы сделать модульную маршрутизацию Express, я сделал несколько экземпляров маршрутизатора. Существует маршрутизатор для пользователя и маршрутизатор для элемента.

var userRouter = require('express').Router();
userRouter.route('/')
  .get(function() {})
  .post(function() {})
userRouter.route('/:user_id')
  .get(function() {})

var itemRouter = require('express').Router();
itemRouter.route('/')
  .get(function() {})
  .post(function() {})
itemRouter.route('/:item_id')
  .get(function() {})

app.use('/users', userRouter);

// Now how to add the next router?
// app.use('/users/', itemRouter);

URL to itemявляется потомком иерархии URL user. Теперь, как мне получить URL с /usersuserRouter, но с более конкретным маршрутом /user/*user_id*/items/к itemRouter? А также, я бы хотел, чтобы user_id был доступен для itemRouter, если это возможно.

Вы можете вкладывать маршрутизаторы, подключая их в качестве промежуточного ПО на другом маршрутизаторе, с или без params.

Вы должны перейти {mergeParams: true}к дочернему маршрутизатору, если хотите получить доступ paramsот родительского маршрутизатора.

mergeParamsбыл представлен в Экспресс4.5.0 (5 июля 2014)

В этом примере itemRouterпривязывается к userRouterна /:userId/itemsмаршруте

Это приведет к следующим возможным маршрутам:

GET /user-> hello user
GET /user/5-> hello user 5
GET /user/5/items-> hello items from user 5
GET /user/5/items/6->hello item 6 from user 5

var express = require('express');
var app = express();

var userRouter = express.Router();
// you need to set mergeParams: true on the router,
// if you want to access params from the parent router
var itemRouter = express.Router({mergeParams: true});

// you can nest routers by attaching them as middleware:
userRouter.use('/:userId/items', itemRouter);

userRouter.route('/')
    .get(function (req, res) {
        res.status(200)
            .send('hello users');
    });

userRouter.route('/:userId')
    .get(function (req, res) {
        res.status(200)
            .send('hello user ' + req.params.userId);
    });

itemRouter.route('/')
    .get(function (req, res) {
        res.status(200)
            .send('hello items from user ' + req.params.userId);
    });

itemRouter.route('/:itemId')
    .get(function (req, res) {
        res.status(200)
            .send('hello item ' + req.params.itemId + ' from user ' + req.params.userId);
    });

app.use('/user', userRouter);

app.listen(3003);

управляемые вложенные маршруты ...

Я хотел конкретный пример выполнения вложенных маршрутов в Express 4 очень управляемым способом, и это был лучший результат поиска для «вложенных маршрутов в экспрессе». Вот API, который будет иметь много маршрутов, которые необходимо разбить, например.

./index.js:

var app = require('express')();

// anything beginning with "/api" will go into this
app.use('/api', require('./routes/api'));

app.listen(3000);

./routes/api/index.js:

var router = require('express').Router();

// split up route handling
router.use('/products', require('./products'));
router.use('/categories', require('./categories'));
// etc.

module.exports = router;

./routes/api/products.js:

var router = require('express').Router();

// api/products
router.get('/', function(req, res) {
  res.json({ products: [] });
});

// api/products/:id
router.get('/:id', function(req, res) {
  res.json({ id: req.params.id });
});

module.exports = router;

Пример вложенности в структуру папок

Я заметил несколько комментариев о "структуре вложенных папок". Это подразумевается в этом, однако не очевидно, поэтому я добавил раздел ниже. Вот конкретный пример структуры вложенных папок для маршрутов .

index.js
/api
  index.js
  /admin
    index.js
    /users
      index.js
      list.js
    /permissions
      index.js
      list.js

Это более общий пример того, как работает узел. Если вы используете «index.js» в папках аналогично тому, как «index.html» работает на веб-страницах для каталога по умолчанию, будет легко масштабировать вашу организацию на основе рекурсии, не меняя точки входа на код. index.js - это документ по умолчанию, доступ к которому осуществляется при использовании require в каталоге.

содержимое index.js

const express = require('express');
const router = express.Router();
router.use('/api', require('./api'));
module.exports = router;

содержимое /api/index.js

const express = require('express');
const router = express.Router();
router.use('/admin', require('./admin'));
module.exports = router;

содержимое /api/admin/index.js

const express = require('express');
const router = express.Router();
router.use('/users', require('./users'));
router.use('/permissions', require('./permissions'));
module.exports = router;

содержимое /api/admin/users/index.js

const express = require('express');
const router = express.Router();
router.get('/', require('./list'));
module.exports = router;

Возможно, здесь есть некоторые проблемы с СУХОЙ, но это хорошо поддается инкапсуляции проблем.

К вашему сведению, недавно я попал в actionhero и обнаружил, что он является полнофункциональным с сокетами и задачами, больше похож на настоящую платформу «все в одном», которая переворачивает парадигму REST с ног на голову. Вы, вероятно, должны проверить это, пройдя голый с экспрессом.

var userRouter = require('express').Router();
var itemRouter = require('express').Router({ mergeParams: true }); 

userRouter.route('/')
  .get(function(req, res) {})
  .post(function(req, res) {})
userRouter.route('/:user_id')
  .get(function() {})

itemRouter.route('/')
  .get(function(req, res) {})
  .post(function(req, res) {})
itemRouter.route('/:item_id')
  .get(function(req, res) {
    return res.send(req.params);
  });

app.use('/user/', userRouter);
app.use('/user/:user_id/item', itemRouter);

Ключ ко второй части вашего вопроса - использование опции mergeParams

var itemRouter = require('express').Router({ mergeParams: true }); 

От /user/jordan/item/catответа я получаю:

{"user_id":"jordan","item_id":"cat"}

Использование решения @Jason Sebring и адаптация для Typescript.

server.ts

import Routes from './api/routes';
app.use('/api/', Routes);

/api/routes/index.ts

import { Router } from 'express';
import HomeRoutes from './home';

const router = Router();

router.use('/', HomeRoutes);
// add other routes...

export default router;

/api/routes/home.ts

import { Request, Response, Router } from 'express';

const router = Router();

router.get('/', (req: Request, res: Response) => {
  res.json({
    message: 'Welcome to API',
  });
});

export default router;

try to add  { mergeParams: true } look to simple example  which it middlware use it in controller file getUser at the same for  postUser
    const userRouter = require("express").Router({ mergeParams: true });
    export default ()=>{
    userRouter
      .route("/")
      .get(getUser)
      .post(postUser);
    userRouter.route("/:user_id").get(function () {});
    
    
    }

Вам нужен только один маршрутизатор, и используйте его так:

router.get('/users');
router.get('/users/:user_id');

router.get('/users/:user_id/items');
router.get('/users/:user_id/items/:item_id');

app.use('api/v1', router);