路由

路由

路由是指应用程序的终结点 （URI） 如何响应客户端请求。 有关路由的简介，请参阅基本路由。

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

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

实际上，路由方法可以将多个回调函数作为参数。 对于多个回调函数，重要的是作为参数提供给回调函数，然后在函数主体中调用以移交控制权 到下一个回调。nextnext()

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

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

路由方法

路由方法派生自其中一个 HTTP 方法，并附加到类的实例。express

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

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

Express 支持对应于所有 HTTP 请求方法的方法：、 等。 有关完整列表，请参阅应用程序。方法。getpost

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

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

路由路径

路由路径与请求方法相结合，定义可以发出请求的终结点。路由路径可以是字符串、字符串模式或正则表达式。

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

如果需要在路径字符串中使用美元字符 （），请将其转义括在 和 中。例如，“” 处请求的路径字符串将为 “”。$([])/data/$book/data/([\$])book

Express 使用路径到正则表达式来匹配路由路径;请参阅正则表达式路径文档，了解定义路由路径的所有可能性。快速路线测试器是用于测试基本快速路线的便捷工具，尽管它不支持模式匹配。

查询字符串不是路由路径的一部分。

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

此路由路径会将请求与根路由 ./

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

此路由路径会将请求与 匹配。/about

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

此路由路径会将请求与 匹配。/random.text

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

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

此路由路径将匹配 和 。acdabcd

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

此路由路径将匹配 、、 等。abcdabbcdabbbcd

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

此路由路径将匹配 、、 等。abcdabxcdabRANDOMcdab123cd

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

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

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

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

此路由路径将匹配任何带有“a”的内容。

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

此路由路径将匹配 和 ，但不匹配 、 等。butterflydragonflybutterflymandragonflyman

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

路由参数

路由参数是命名的 URL 段，用于捕获在 URL 中的位置指定的值。捕获的值填充在对象中，路径中指定的 route 参数的名称作为其各自的键。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', function (req, res) {
  res.send(req.params)
})

路由参数的名称必须由“字字符”（[A-Za-z0-9_]）组成。

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

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"}

由于正则表达式通常是文本字符串的一部分，因此请确保使用额外的反斜杠转义任何字符，例如 。\\\d+

在 Express 4.x 中，正则表达式中的 * 字符不会以通常的方式解释。解决方法是使用 代替 。这可能会在Express 5中修复。{0,}*

路由处理程序

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

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

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

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

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

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

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

var cb0 = function (req, res, next) {
  console.log('CB0')
  next()
}
 
var cb1 = function (req, res, next) {
  console.log('CB1')
  next()
}
 
var cb2 = function (req, res) {
  res.send('Hello from C!')
}
 
app.get('/example/c', [cb0, cb1, cb2])

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

var cb0 = function (req, res, next) {
  console.log('CB0')
  next()
}
 
var cb1 = function (req, res, next) {
  console.log('CB1')
  next()
}
 
app.get('/example/d', [cb0, cb1], function (req, res, next) {
  console.log('the response will be sent by the next function ...')
  next()
}, function (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()

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

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

表达。路由器

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

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

创建应用目录中命名的路由器文件，内容如下：birds.js

var express = require('express')
var router = express.Router()
 
// middleware that is specific to this router
router.use(function timeLog (req, res, next) {
  console.log('Time: ', Date.now())
  next()
})
// define the home page route
router.get('/', function (req, res) {
  res.send('Birds home page')
})
// define the about route
router.get('/about', function (req, res) {
  res.send('About birds')
})
 
module.exports = router

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

var birds = require('./birds')
 
// ...
 
app.use('/birds', birds)

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