资讯专栏INFORMATION COLUMN

Express 文档(使用中间件)

lieeps / 1030人阅读

摘要:调用堆栈中的下一个中间件函数。此示例显示了一个中间件子堆栈,它处理对路径的请求。要从路由器中间件堆栈跳过其余的中间件函数,请调用将控制权传递给下一个路由,注意仅适用于使用或函数加载的中间件函数。

使用中间件

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常用的第三方中间件函数的部分列表,请参阅:第三方中间件。

上一篇:编写中间件 下一篇:使用模板引擎

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/100446.html

相关文章

  • Koa v2.x 中文文档 Koa 对比 Express

    摘要:使用承诺和异步功能来摆脱回调地狱的应用程序,并简化错误处理。它暴露了自己的和对象,而不是的和对象。因此,可被视为的模块的抽象,其中是的应用程序框架。这使得中间件对于整个堆栈而言不仅仅是最终应用程序代码,而且更易于书写,并更不容易出错。 Koa 与 Express 此系列文章的应用示例已发布于 GitHub: koa-docs-Zh-CN. 可以 Fork 帮助改进或 Star 关注更新...

    summerpxy 评论0 收藏0
  • Express 文档express())

    摘要:方法此中间件在及更高版本中可用。由于的形状基于用户控制的输入,因此该对象中的所有属性和值都是不可信的,应该在信任之前进行验证。注意为获得最佳结果,请使用反向代理缓存来提高服务静态资源的性能。 express() 创建一个Express应用程序,express()函数是express模块​​导出的顶级函数。 var express = require(express); var app ...

    oysun 评论0 收藏0
  • Express 文档(常见问题)

    摘要:常见问题我该如何构建我的应用程序这个问题没有明确的答案,答案取决于你的应用程序规模和所涉及的团队,为了尽可能灵活,在结构方面没有做出任何假设。请参阅,了解以模型为中心的基于的框架。 常见问题 我该如何构建我的应用程序? 这个问题没有明确的答案,答案取决于你的应用程序规模和所涉及的团队,为了尽可能灵活,Express在结构方面没有做出任何假设。 在你喜欢的任何目录结构中,路由和其他特定于...

    MyFaith 评论0 收藏0
  • Express 文档(编写间件

    摘要:编写中间件中间件函数是可以访问请求对象响应对象以及应用程序请求响应周期中的函数的函数,函数是路由器中的一个函数,当被调用时,它会在当前中间件之后执行中间件。结束请求响应周期。此外,根路径路由的回调函数使用中间件函数添加到请求对象的属性。 编写中间件 中间件函数是可以访问请求对象(req)、响应对象(res)以及应用程序请求—响应周期中的next函数的函数,next函数是Express路...

    nanchen2251 评论0 收藏0
  • Express 文档(静态文件)

    摘要:要使用多个静态资源目录,请多次调用中间件函数按照使用中间件函数设置静态目录的顺序查找文件。注意为获得最佳结果,请使用反向代理缓存来提高服务静态资源的性能。 静态文件 要提供静态文件(如images、CSS文件和JavaScript文件),请使用Express中的express.static内置中间件功能,函数签名是: express.static(root, [options]) ro...

    PiscesYE 评论0 收藏0

发表评论

0条评论

lieeps

|高级讲师

TA的文章

阅读更多
最新活动
阅读需要支付1元查看
<