Express 文档（路由）

路由

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

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

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

实际上，路由方法能够有多个回调函数做为参数，使用多个回调函数时，重要的是提供next做为回调函数的参数，而后在函数体内调用next()以将控制权交给下一个回调。

如下代码是一个很是基础的路由示例。

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请求方法相对应的方法：get、post等，有关完整列表，请参阅app.METHOD。

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

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使用 path-to-regexp来匹配路由路径，有关定义路由路径的全部可能性，请参阅 path-to-regexp文档， Express Route Tester是一个用于测试基本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')
})

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

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

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

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

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

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

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/')
})

这个路由路径将与butterfly和dragonfly相匹配，但不会与butterflyman、dragonflyman等相匹配。

app.get(/.*fly$/, function (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', 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中，正则表达式中的*字符不以一般的方式解释，要解决此问题，请使用{0,}而不是*，这可能会在Express 5中修复。

路由处理程序

你能够提供多个回调函数，其行为相似于中间件来处理请求，惟一的例外是这些回调可能会调用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()为路由路径建立可连接的路由处理程序，因为路径是在单个位置指定的，所以建立模块化路由颇有帮助，同时减小冗余和拼写错误，有关路由的更多信息，请参阅：Router()文档。

如下是使用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.Router

使用express.Router类建立模块化、可装载的路由处理程序，Router实例是一个完整的中间件和路由系统，所以，它一般被称为“迷你应用程序”。

如下示例将路由器建立为模块，在其中加载中间件功能，定义一些路由，并将路由器模块装载在主应用程序中的路径上。

在应用程序目录中建立名为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/about的请求，以及调用特定于该路由的timeLog中间件函数。

---

上一篇：常见问题

下一篇：编写中间件