路由

路由 指的是应用程序的端点 (URI) 如何响应客户端请求。有关路由的介绍，请参阅 基本路由。

您可以使用 Express app 对象的方法来定义路由，这些方法对应于 HTTP 方法；例如，app.get() 用于处理 GET 请求，app.post 用于处理 POST 请求。有关完整列表，请参阅 app.METHOD。您还可以使用 app.all() 处理所有 HTTP 方法，并使用 app.use() 指定中间件作为回调函数（有关详细信息，请参阅 使用中间件）。

这些路由方法指定一个回调函数（有时称为“处理程序函数”，当应用程序接收到对指定路由（端点）和 HTTP 方法的请求时，该函数会被调用。换句话说，应用程序“监听”与指定路由和方法匹配的请求，并在检测到匹配时，调用指定的回调函数。

实际上，路由方法可以接受多个回调函数作为参数。当使用多个回调函数时，需要将 `next` 作为参数传递给回调函数，并在函数体内调用 `next()` 将控制权传递给下一个回调函数。

以下代码是一个非常基本的路由示例。

const express = require('express')
const app = express()

// respond with "hello world" when a GET request is made to the homepage
app.get('/', (req, res) => {
  res.send('hello world')
})

路由方法

路由方法源自 HTTP 方法之一，并附加到 `express` 类的实例上。

以下代码是为应用程序根目录定义的 GET 和 POST 方法的路由示例。

// GET method route
app.get('/', (req, res) => {
  res.send('GET request to the homepage')
})

// POST method route
app.post('/', (req, res) => {
  res.send('POST request to the homepage')
})

Express 支持与所有 HTTP 请求方法相对应的方法：`get`、`post` 等。有关完整列表，请参阅 app.METHOD。

有一个特殊的路由方法 `app.all()`，用于在路径上为所有 HTTP 请求方法加载中间件函数。例如，以下处理程序将针对使用 GET、POST、PUT、DELETE 或 `http 模块` 中支持的任何其他 HTTP 请求方法的“/secret”路由的请求执行。 http 模块.

app.all('/secret', (req, res, next) => {
  console.log('Accessing the secret section ...')
  next() // pass control to the next handler
})

路由路径

路由路径与请求方法结合在一起，定义了可以进行请求的端点。路由路径可以是字符串、字符串模式或正则表达式。

字符 `?`、`+`、`*` 和 `()` 是其正则表达式对应物的子集。连字符 (-) 和点 (.) 由基于字符串的路径按字面解释。

如果需要在路径字符串中使用美元符号 ($)，请将其转义后用 `([` 和 `])` 括起来。例如，“/data/$book” 的路径字符串将是“/data/([\$])book”。

以下是一些基于字符串的路由路径示例。

此路由路径将匹配对根路由 / 的请求。

app.get('/', (req, res) => {
  res.send('root')
})

此路由路径将匹配对 /about 的请求。

app.get('/about', (req, res) => {
  res.send('about')
})

此路由路径将匹配对 /random.text 的请求。

app.get('/random.text', (req, res) => {
  res.send('random.text')
})

以下是一些基于字符串模式的路由路径示例。

此路由路径将匹配 acd 和 abcd。

app.get('/ab?cd', (req, res) => {
  res.send('ab?cd')
})

此路由路径将匹配 abcd、abbcd、abbbcd 等。

app.get('/ab+cd', (req, res) => {
  res.send('ab+cd')
})

此路由路径将匹配 abcd、abxcd、abRANDOMcd、ab123cd 等。

app.get('/ab*cd', (req, res) => {
  res.send('ab*cd')
})

此路由路径将匹配 /abe 和 /abcde。

app.get('/ab(cd)?e', (req, res) => {
  res.send('ab(cd)?e')
})

基于正则表达式的路由路径示例

此路由路径将匹配任何包含“a”的路径。

app.get(/a/, (req, res) => {
  res.send('/a/')
})

此路由路径将匹配 butterfly 和 dragonfly，但不匹配 butterflyman、dragonflyman 等。

app.get(/.*fly$/, (req, res) => {
  res.send('/.*fly$/')
})

路由参数

路由参数是命名的 URL 段，用于捕获在 URL 中其位置指定的值。捕获的值将填充到 req.params 对象中，其路径中指定的路由参数名称作为其各自的键。

Route path: /users/:userId/books/:bookId
Request URL: http://localhost:3000/users/34/books/8989
req.params: { "userId": "34", "bookId": "8989" }

要定义带有路由参数的路由，只需在路由的路径中指定路由参数，如下所示。

app.get('/users/:userId/books/:bookId', (req, res) => {
  res.send(req.params)
})

由于连字符 (-) 和点 (.) 是按字面意思解释的，因此它们可以与路由参数一起用于有用的目的。

Route path: /flights/:from-:to
Request URL: http://localhost:3000/flights/LAX-SFO
req.params: { "from": "LAX", "to": "SFO" }

Route path: /plantae/:genus.:species
Request URL: http://localhost:3000/plantae/Prunus.persica
req.params: { "genus": "Prunus", "species": "persica" }

要更精确地控制路由参数可以匹配的字符串，可以在括号 (()) 中附加正则表达式。

Route path: /user/:userId(\d+)
Request URL: http://localhost:3000/user/42
req.params: {"userId": "42"}

路由处理程序

您可以提供多个回调函数，这些函数的行为类似于 中间件 来处理请求。唯一的例外是这些回调可能会调用 next('route') 来绕过剩余的路由回调。您可以使用此机制对路由施加先决条件，然后在没有理由继续当前路由的情况下将控制权传递给后续路由。

路由处理程序可以是函数、函数数组或两者的组合，如以下示例所示。

单个回调函数可以处理路由。例如

app.get('/example/a', (req, res) => {
  res.send('Hello from A!')
})

多个回调函数可以处理路由（确保您指定了 next 对象）。例如

app.get('/example/b', (req, res, next) => {
  console.log('the response will be sent by the next function ...')
  next()
}, (req, res) => {
  res.send('Hello from B!')
})

回调函数数组可以处理路由。例如

const cb0 = function (req, res, next) {
  console.log('CB0')
  next()
}

const cb1 = function (req, res, next) {
  console.log('CB1')
  next()
}

const cb2 = function (req, res) {
  res.send('Hello from C!')
}

app.get('/example/c', [cb0, cb1, cb2])

独立函数和函数数组的组合可以处理路由。例如

const cb0 = function (req, res, next) {
  console.log('CB0')
  next()
}

const cb1 = function (req, res, next) {
  console.log('CB1')
  next()
}

app.get('/example/d', [cb0, cb1], (req, res, next) => {
  console.log('the response will be sent by the next function ...')
  next()
}, (req, res) => {
  res.send('Hello from D!')
})

响应方法

以下表格中响应对象 (res) 上的方法可以向客户端发送响应，并终止请求-响应周期。如果路由处理程序中没有调用这些方法中的任何一个，则客户端请求将保持挂起状态。

方法	描述
res.download()	提示下载文件。
res.end()	结束响应过程。
res.json()	发送 JSON 响应。
res.jsonp()	发送一个支持 JSONP 的 JSON 响应。
res.redirect()	重定向请求。
res.render()	渲染视图模板。
res.send()	发送各种类型的响应。
res.sendFile()	将文件作为八进制流发送。
res.sendStatus()	设置响应状态码并将其字符串表示形式作为响应主体发送。

app.route()

您可以使用 app.route() 为路由路径创建可链接的路由处理程序。由于路径是在单个位置指定的，因此创建模块化路由非常有用，并且可以减少冗余和拼写错误。有关路由的更多信息，请参见：Router() 文档。

以下是用 app.route() 定义的链式路由处理程序示例。

app.route('/book')
  .get((req, res) => {
    res.send('Get a random book')
  })
  .post((req, res) => {
    res.send('Add a book')
  })
  .put((req, res) => {
    res.send('Update the book')
  })

express.Router

使用 express.Router 类创建模块化、可挂载的路由处理程序。Router 实例是一个完整的中间件和路由系统；因此，它通常被称为“迷你应用程序”。

以下示例创建一个路由器作为模块，在其中加载中间件函数，定义一些路由，并将路由器模块挂载到主应用程序中的路径上。

在应用程序目录中创建一个名为 birds.js 的路由器文件，内容如下

const express = require('express')
const router = express.Router()

// middleware that is specific to this router
const timeLog = (req, res, next) => {
  console.log('Time: ', Date.now())
  next()
}
router.use(timeLog)

// define the home page route
router.get('/', (req, res) => {
  res.send('Birds home page')
})
// define the about route
router.get('/about', (req, res) => {
  res.send('About birds')
})

module.exports = router

然后，在应用程序中加载路由器模块

const birds = require('./birds')

// ...

app.use('/birds', birds)

现在，应用程序将能够处理对 /birds 和 /birds/about 的请求，以及调用特定于路由的 timeLog 中间件函数。