express中的中间件理解

Posted 2020-10-29 Ambition

什么是中间件

中间件是一个可访问请求对象（req）和响应对象（res）的函数，在 Express 应用的请求-响应循环里，下一个内联的中间件通常用变量 next 表示。中间件的功能包括：

执行任何代码。

修改请求和响应对象。

终结请求-响应循环。

调用堆栈中的下一个中间件。

如果当前中间件没有终结请求-响应循环，则必须调用 next() 方法将控制权交给下一个中间件，否则请求就会挂起。使用可选则挂载路径，可在应用级别或路由级别装载中间件。可装载一系列中间件函数，在挂载点创建一个中间件系统栈。

中间件的类别

应用级中间件

应用级中间件绑定到 express 实例，使用 app.use() 和 app.VERB()

 1 var app = express();
 2 
 3 // 没有挂载路径的中间件，应用的每个请求都会执行该中间件
 4 app.use(function (req, res, next) {
 5   console.log(\'Time:\', Date.now());
 6   next();
 7 });
 8 
 9 // 挂载至 /user/:id 的中间件，任何指向 /user/:id 的请求都会执行它
10 app.use(\'/user/:id\', function (req, res, next) {
11   console.log(\'Request Type:\', req.method);
12   next();
13 });
14 
15 // 路由和句柄函数(中间件系统)，处理指向 /user/:id 的 GET 请求
16 app.get(\'/user/:id\', function (req, res, next) {
17   res.send(\'USER\');
18 });

在一个挂载点装载一组中间件

// 一个中间件栈，对任何指向 /user/:id 的 HTTP 请求打印出相关信息
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();
});

路由句柄的好处

 1 // 一个中间件栈，处理指向 /user/:id 的 GET 请求
 2 app.get(\'/user/:id\', function (req, res, next) {
 3   console.log(\'ID:\', req.params.id);
 4   next();
 5 }, function (req, res, next) {
 6   res.send(\'User Info\');
 7 });
 8 
 9 // 处理 /user/:id， 打印出用户 id
10 app.get(\'/user/:id\', function (req, res, next) {
11   res.end(req.params.id);
12 });

作为中间件系统的路由句柄，使得为路径定义多个路由成为可能。在上面的例子中，为指向 /user/:id 的 GET 请求定义了两个路由。第二个路由虽然不会带来任何问题，但却永远不会被调用，因为第一个路由已经终止了请求-响应循环。

如果需要在中间件栈中跳过剩余中间件，调用 next(‘route’) 方法将控制权交给下一个路由。需要注意的是 next(‘route’) 只对使用 app.VERB() 或 router.VERB() 加载的中间件有效。

 1 // 一个中间件栈，处理指向 /user/:id 的 GET 请求
 2 app.get(\'/user/:id\', function (req, res, next) {
 3   // 如果 user id 为 0, 跳到下一个路由
 4   if (req.params.id == 0) next(\'route\');
 5   // 负责将控制权交给栈中下一个中间件
 6   else next(); // 
 7 }, function (req, res, next) {
 8   // 渲染常规页面
 9   res.render(\'regular\');
10 });
11 
12 // 处理 /user/:id， 渲染一个特殊页面
13 app.get(\'/user/:id\', function (req, res, next) {
14   res.render(\'special\');
15 });

路由级中间件

路由级中间件和应用级中间件一样，只是它绑定的对象为 express.Router()。

var router = express.Router();

路由级使用 router.use() 或 router.VERB() 加载。

上述在应用级创建的中间件系统，可通过如下代码改写为路由级：

var app = express();
var router = express.Router();

// 没有挂载路径的中间件，通过该路由的每个请求都会执行该中间件
router.use(function (req, res, next) {
  console.log(\'Time:\', Date.now());
  next();
});

// 一个中间件栈，显示任何指向 /user/:id 的 HTTP 请求的信息
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();
});

// 一个中间件栈，处理指向 /user/:id 的 GET 请求
router.get(\'/user/:id\', function (req, res, next) {
  // 如果 user id 为 0, 跳到下一个路由
  if (req.params.id == 0) next(\'route\');
  // 负责将控制权交给栈中下一个中间件
  else next(); // 
}, function (req, res, next) {
  // 渲染常规页面
  res.render(\'regular\');
});

// 处理 /user/:id， 渲染一个特殊页面
router.get(\'/user/:id\', function (req, res, next) {
  console.log(req.params.id);
  res.render(\'special\');
});

// 将路由挂载至应用
app.use(\'/\', router);

错误处理中间件

错误处理中间件有 4 个参数，定义错误处理中间件时必须使用这 4 个参数。即使不需要 next 对象，也必须在签名中声明它，否则中间件会被识别为一个常规中间件，不能处理错误。

错误处理中间件和其他中间件定义类似，只是要使用 4 个参数，而不是 3 个，其签名如下： (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.static，Express 以前包括的中间件现在已经在一个单独的库里，请参考API。

express.static(root, [options])

express.static 是 Express 唯一内置的中间件，它基于 serve-static，负责在 Express 应用中提供静态资源。 
参数 root 指提供静态资源的根目录。可选的 options 参数拥有如下属性。

 

下面的例子使用了 express.static 中间件，其中的 options 对象经过了精心的设计。

var options = {
  dotfiles: \'ignore\',
  etag: false,
  extensions: [\'htm\', \'html\'],
  index: false,
  maxAge: \'1d\',
  redirect: false,
  setHeaders: function (res, path, stat) {
    res.set(\'x-timestamp\', Date.now());
  }
}

app.use(express.static(\'public\', options));

每个应用可有多个静态目录。

app.use(express.static(\'public\'));
app.use(express.static(\'uploads\'));
app.use(express.static(\'files\'));

第三方中间件

Express 是一款提供路由和中间件的 Web 框架，但其本身的功能却异常精简。Express 应用的功能通过第三方中间件来添加。安装所需功能的 node 模块，并在应用中加载，可以在应用级加载，也可以在路由级加载。下面的例子安装并加载了一个解析 cookie 的中间件： cookie-parser

var express = require(\'express\');
var app = express();
var cookieParser = require(\'cookie-parser\');

// 加载 cookie 解析中间件
app.use(cookieParser());

在进行表单上传的过程中，因为有可能会用到图片的上传，这时候cookie-parser不能满足我们的要求，我们就需要新的三方插件，比如multiparty

1 1.npm i multiparty
2  2.const multiparty = require(\'multiparty\');
3  3.上传图片
4  let form = new multiparty.Form()
5  form.uploadDir = \'\';//指定图片的文件夹
6  form.parse(req,function(err,fields,files){
7   //获取提交的数据以及图片上传成功返回的图片信息 field是表单数据，files为图片信息
8  })