使用中间件
Express 是一个路由和中间件 Web 框架,其本身的功能非常小:Express 应用程序本质上是一系列中间件函数调用。
中间件函数是可以访问请求对象(req)、响应对象(res)以及应用程序请求—响应周期中的下一个中间件函数的函数,下一个中间件函数通常由名为 next 的变量表示。
中间件函数可以执行以下任务:
执行任何代码。
更改请求和响应对象。
结束请求—响应周期。
调用堆栈中的下一个中间件函数。
如果当前的中间件函数没有结束请求—响应周期,它必须调用 next() 将控制权传递给下一个中间件函数,否则,请求将被挂起。
Express 应用程序可以使用以下类型的中间件:
应用程序级中间件
路由器级中间件
错误处理中间件
内置中间件
第三方中间件
你可以使用可选的装载路径加载应用程序级和路由器级中间件,你还可以将一系列中间件函数加载在一起,从而在装载点创建中间件系统的子堆栈。
应用程序级中间件
使用 app.use() 和 app.METHOD() 函数将应用程序级中间件绑定到 app 对象的实例,其中 METHOD 是中间件函数处理的请求的小写 HTTP 方法(例如 GET,PUT 或 POST)。
此示例显示了没有装载路径的中间件函数,每次应用程序收到请求时都会执行该函数。
var app = express()
app.use(function (req, res, next) {
console.log(‘Time:’, Date.now())
next()
})
此示例显示了安装在 /user/:id 路径上的中间件函数,对 /user/:id 路径上的任何类型的 HTTP 请求执行该函数。
app.use(‘/user/:id’, function (req, res, next) {
console.log(‘Request Type:’, req.method)
next()
})
此示例显示了路由及其处理函数(中间件系统),该函数处理对 /user/:id 路径的 GET 请求。
app.get(‘/user/:id’, function (req, res, next) {
res.send(‘USER’)
})
下面是一个使用挂载路径在挂载点加载一系列中间件函数的示例,它说明了一个中间件子堆栈,它将任何类型的 HTTP 请求的请求信息打印到 /user/:id 路径。
app.use(‘/user/:id’, function (req, res, next) {
console.log(‘Request URL:’, req.originalUrl)
next()
}, function (req, res, next) {
console.log(‘Request Type:’, req.method)
next()
})
路由处理程序使你可以为路径定义多个路由,下面的示例为 /user/:id 路径定义了两个 GET 请求路由,第二个路由不会引起任何问题,但它永远不会被调用,因为第一个路由结束了请求—响应周期。
此示例显示了一个中间件子堆栈,它处理对 /user/:id 路径的 GET 请求。
app.get(‘/user/:id’, function (req, res, next) {
console.log(‘ID:’, req.params.id)
next()
}, function (req, res, next) {
res.send(‘User Info’)
})
// handler for the /user/:id path, which prints the user ID
app.get(‘/user/:id’, function (req, res, next) {
res.end(req.params.id)
})
要从路由器中间件堆栈跳过其余的中间件函数,请调用 next(‘route’) 将控制权传递给下一个路由,注意:next(‘route’) 仅适用于使用 app.METHOD() 或 router.METHOD() 函数加载的中间件函数。
此示例显示了一个中间件子堆栈,它处理对 /user/:id 路径的 GET 请求。
app.get(‘/user/:id’, function (req, res, next) {
// if the user ID is 0, skip to the next route
if (req.params.id === ‘0’) next(‘route’)
// otherwise pass the control to the next middleware function in this stack
else next()
}, function (req, res, next) {
// send a regular response
res.send(‘regular’)
})
// handler for the /user/:id path, which sends a special response
app.get(‘/user/:id’, function (req, res, next) {
res.send(‘special’)
})
路由器级中间件
路由器级中间件的工作方式与应用程序级中间件的工作方式相同,只是它绑定到 express.Router() 的实例。
var router = express.Router()
使用 router.use() 和 router.METHOD() 函数加载路由器级中间件。
以下示例代码通过使用路由器级中间件复制上面显示的应用程序级中间件的中间件系统:
var app = express()
var router = express.Router()
// a middleware function with no mount path. This code is executed for every request to the router
router.use(function (req, res, next) {
console.log(‘Time:’, Date.now())
next()
})
// a middleware sub-stack shows request info for any type of HTTP request to the /user/:id path
router.use(‘/user/:id’, function (req, res, next) {
console.log(‘Request URL:’, req.originalUrl)
next()
}, function (req, res, next) {
console.log(‘Request Type:’, req.method)
next()
})
// a middleware sub-stack that handles GET requests to the /user/:id path
router.get(‘/user/:id’, function (req, res, next) {
// if the user ID is 0, skip to the next router
if (req.params.id === ‘0’) next(‘route’)
// otherwise pass control to the next middleware function in this stack
else next()
}, function (req, res, next) {
// render a regular page
res.render(‘regular’)
})
// handler for the /user/:id path, which renders a special page
router.get(‘/user/:id’, function (req, res, next) {
console.log(req.params.id)
res.render(‘special’)
})
// mount the router on the app
app.use(‘/’, router)
要跳过其余路由器中间件函数,请调用 next(‘router’) 将控制权交还出路由器实例。
此示例显示了一个中间件子堆栈,它处理对 /admin 路径的 GET 请求。
var app = express()
var router = express.Router()
// predicate the router with a check and bail out when needed
router.use(function (req, res, next) {
if (!req.headers[‘x-auth’]) return next(‘router’)
next()
})
router.get(‘/’, function (req, res) {
res.send(‘hello, user!’)
})
// use the router and 401 anything falling through
app.use(‘/admin’, router, function (req, res) {
res.sendStatus(401)
})
错误处理中间件
错误处理中间件总是需要四个参数,你必须提供四个参数以将其标识为错误处理中间件函数,即使你不需要使用 next 对象,也必须指定它以维护签名,否则,next 对象将被解释为常规中间件,并且将无法处理错误。
以与其他中间件函数相同的方式定义错误处理中间件函数,除了四个参数而不是三个,特别是签名 (err, req, res, next):
app.use(function (err, req, res, next) {
console.error(err.stack)
res.status(500).send(‘Something broke!’)
})
有关错误处理中间件的详细信息,请参阅:错误处理。
内置中间件
从版本 4.x 开始,Express 不再依赖于 Connect,之前包含在 Express 中的中间件函数现在位于不同的模块中,查看中间件函数列表。
Express 具有以下内置中间件函数:
express.static 提供静态资源,如 HTML 文件、图像等。
express.json 使用 JSON 的有效负载解析传入的请求,注意:适用于 Express 4.16.0+。
express.urlencoded 使用 URL 编码的有效负载解析传入的请求,注意:适用于 Express 4.16.0+。
第三方中间件
使用第三方中间件为 Express 应用程序添加功能。
安装 Node.js 模块以获得所需的功能,然后在应用程序级别或路由器级别将其加载到你的应用程序中。
以下示例说明了安装和加载 cookie 解析中间件函数 cookie-parser。
$ npm install cookie-parser
var express = require(‘express’)
var app = express()
var cookieParser = require(‘cookie-parser’)
// load the cookie-parsing middleware
app.use(cookieParser())
有关 Express 常用的第三方中间件函数的部分列表,请参阅:第三方中间件。
上一篇:编写中间件
下一篇:使用模板引擎