nodejs对express中next函数的一些理解


Posted in NodeJs onSeptember 08, 2017

最近公司在使用node做前后端分离,采用的web框架是express,所以对express框架进行了深入的了解,前段时间写了篇关于express路由的文章,但是在那篇文章中貌似少了一个很重要的内容,就是express的next,所以今天单独来说说express的next。

关于next主要从三点来进行说明:

  • next的作用是什么?
  • 我们应该在何时使用next?
  • next的内部实现机制是什么?

Next的作用

我们在定义express中间件函数的时候都会将第三个参数定义为next,这个next就是我们今天的主角,next函数主要负责将控制权交给下一个中间件,如果当前中间件没有终结请求,并且next没有被调用,那么请求将被挂起,后边定义的中间件将得不到被执行的机会。

何时使用Next

从上边的描述我们已经知道,next函数主要是用来确保所有注册的中间件被一个接一个的执行,那么我们就应该在所有的中间件中调用next函数,但有一个特例,如果我们定义的中间件终结了本次请求,那就不应该再调用next函数,否则就可能会出问题,我们来看段代码

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

// catch 404 and forward to error handler
app.use(function(req, res, next) {
 console.log(404);
 var err = new Error('Not Found');
 err.status = 404;
 next(err);
});

app.use(function(err, req, res, next) {
 res.status(err.status || 500);
 res.render('error', {
  message: err.message,
  error: {}
 });
});

发送请求"/a",控制台打印日志如下:

404
GET /a 500 6.837 ms - -
Error: Can't set headers after they are sent.
  at ServerResponse.OutgoingMessage.setHeader (_http_outgoing.js:345:11)

为什么代码会抛异常呢,就是因为我们在res.send之后调用了next函数,虽然我们本次的请求已经被终止,但后边的404中间件依旧会被执行,而后边的中间件试图去向res的headers中添加属性值,所以就会抛出上边的异常。

读到这你可能会有个疑问,如果我不在res.send后边调用next函数,那后边定义的404中间件是不是永远都不会被执行到。现在我们删除res.send后边next函数调用,发送请求"/xxx",我们就会发现404中间件被执行了,(ㄒoㄒ),这不是和我们之前说的矛盾了吗,我们的自定义中间件没有调用next,但后边定义的中间件仍旧被执行了,这究竟是为什么呢。看来只能求助源码了~~~

Next的内部机制

function next(err) {
  ... //此处源码省略
  // find next matching layer
  var layer;
  var match;
  var route;

  while (match !== true && idx < stack.length) {
   layer = stack[idx++];
   match = matchLayer(layer, path);
   route = layer.route;

   if (typeof match !== 'boolean') {
    // hold on to layerError
    layerError = layerError || match;
   }

   if (match !== true) {
    continue;
   }
   ... //此处源码省略
  }
 ... //此处源码省略
  // this should be done for the layer
  if (err) {
    layer.handle_error(err, req, res, next);
  } else {
   layer.handle_request(req, res, next);
  }
 }

上边就是express中next的源码,为了更容易说明问题,对代码进行了删减。从上边的源码可以发现,next函数内部有个while循环,每次循环都会从stack中拿出一个layer,这个layer中包含了路由和中间件信息,然后就会用layer和请求的path就行匹配,如果匹配成功就会执行layer.handle_request,调用中间件函数。但如果匹配失败,就会循环下一个layer(即中间件)。

现在我们就能解释上边提出的问题了,为什么我们的自定义中间件中没调用next函数,但后边的404中间件仍旧会被执行到,因为我们请求的"/xxx"匹配不到我们注册的"/a"路由中间件,所以while循环会继续往下执行,匹配404中间件成功,所以会执行404中间件。

 注意:app.use注册的中间件,如果path参数为空,则默认为"/",而path为"/"的中间件默认匹配所有的请求。

有一点需要特别指出,其实我们在定义路由中间件的时候函数的第三个参数next和我们定义非路由中间件的函数的第三个参数next不是同一个next,我们在上边看到的是非路由中间件的next,而路由中间件的next函数是这样的

function next(err) {
  if (err && err === 'route') {
   return done();
  }

  var layer = stack[idx++];
  if (!layer) {
   return done(err);
  }

  if (layer.method && layer.method !== method) {
   return next(err);
  }

  if (err) {
   layer.handle_error(err, req, res, next);
  } else {
   layer.handle_request(req, res, next);
  }
 }

这个next比上边的那个next要简单很多,它负责同一个路由的多个中间件的控制权的传递,并且它会接收一个参数"route",如果调用next(“route”),则会跳过当前路由的其它中间件,直接将控制权交给下一个路由。

最后有必要再说一说next(err),next(err)是如何将控制权传递到错误处理中间件的,从前边的代码我们知道,当调用next(err)是,express内部会调用layer.handle_error,那我们来看看它的源码

Layer.prototype.handle_error = function handle_error(error, req, res, next) {
 var fn = this.handle;

 if (fn.length !== 4) {
  // not a standard error handler
  return next(error);
 }

 try {
  fn(error, req, res, next);
 } catch (err) {
  next(err);
 }
};

代码中的fn就是中间件函数,express会对fn的参数个数进行判断,如果参数个数不等于4则认为不是错误处理中间件,则继续调用next(err),这样就会进入到下一个中间件函数,继续进行参数个数判断,如此方式一直到某个中间件函数的参数个数是4,就认为找到了错误处理中间件,然后执行此中间件函数。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

NodeJs 相关文章推荐
使用Nodejs开发微信公众号后台服务实例
Sep 03 NodeJs
nodejs教程之入门
Nov 21 NodeJs
搭建简单的nodejs http服务器详解
Mar 09 NodeJs
nodejs动态创建二维码的方法
Aug 12 NodeJs
nodejs 最新版安装npm 的使用详解
Jan 18 NodeJs
nodejs连接mysql数据库及基本知识点详解
Mar 20 NodeJs
nodeJs爬虫的技术点总结
May 13 NodeJs
nodejs express配置自签名https服务器的方法
May 22 NodeJs
nodejs实现范围请求的实现代码
Oct 12 NodeJs
使用nodejs分离html文件里的js和css详解
Apr 12 NodeJs
搭建一个nodejs脚手架的方法步骤
Jun 28 NodeJs
在nodejs中创建child process的方法
Jan 26 NodeJs
nodejs 图解express+supervisor+ejs的用法(推荐)
Sep 08 #NodeJs
nodejs创建简易web服务器与文件读写的实例
Sep 07 #NodeJs
NodeJS设计模式总结【单例模式,适配器模式,装饰模式,观察者模式】
Sep 06 #NodeJs
Nodejs进阶之服务端字符编解码和乱码处理
Sep 04 #NodeJs
Windows下使用Nodejs运行js的方法
Sep 02 #NodeJs
用nodejs实现json和jsonp服务的方法
Aug 25 #NodeJs
NodeJS收发GET和POST请求的示例代码
Aug 25 #NodeJs
You might like
配置PHP使之能同时支持GIF和JPEG
2006/10/09 PHP
PHP使用socket发送HTTP请求的方法
2016/02/14 PHP
Zend Framework动作助手(Zend_Controller_Action_Helper)用法详解
2016/03/05 PHP
yii2高级应用之自定义组件实现全局使用图片上传功能的方法
2016/10/08 PHP
PHP两种实现无级递归分类的方法
2017/03/02 PHP
论坛特效代码收集(落伍转发-不错)
2006/12/02 Javascript
Javascript 日期对象Date扩展方法
2009/05/30 Javascript
jQuery与ExtJS之选择实例分析
2010/08/19 Javascript
IE、FF浏览器下修改标签透明度
2014/01/28 Javascript
js跳转页面方法实现汇总
2014/02/11 Javascript
jQuery子窗体取得父窗体元素的方法
2015/05/11 Javascript
简单谈谈ES6的六个小特性
2016/11/18 Javascript
深入浅析AngularJS中的一次性数据绑定 (bindonce)
2017/05/11 Javascript
javascript 开发之百度地图使用到的js函数整理
2017/05/19 Javascript
jQuery中库的引用方法
2018/01/06 jQuery
Node Puppeteer图像识别实现百度指数爬虫的示例
2018/02/22 Javascript
webpack4 处理CSS的方法示例
2018/09/03 Javascript
微信小程序自定义导航教程(兼容各种手机)
2018/12/12 Javascript
Express结合Webpack的全栈自动刷新
2019/05/23 Javascript
微信小程序swiper左右扩展各显示一半代码实例
2019/12/05 Javascript
vue实现移动端图片上传功能
2019/12/23 Javascript
Python编程中的异常处理教程
2015/08/21 Python
python实现读取大文件并逐行写入另外一个文件
2018/04/19 Python
Python中调用其他程序的方式详解
2019/08/06 Python
Python日期格式和字符串格式相互转换的方法
2020/02/18 Python
日本PLST在线商店:日本时尚杂志刊载的人气服装
2016/12/10 全球购物
美国领先的眼镜和太阳镜在线零售商:Glasses.com
2019/08/26 全球购物
三好学生自我鉴定
2013/12/17 职场文书
法学函授自我鉴定
2014/02/06 职场文书
《会走路的树》教后反思
2014/04/19 职场文书
财会专业大学生求职信
2014/09/26 职场文书
教师节座谈会主持词
2015/07/03 职场文书
继续教育心得体会(共6篇)
2016/01/19 职场文书
MySQL 使用事件(Events)完成计划任务
2021/05/24 MySQL
教你如何用Python实现人脸识别(含源代码)
2021/06/23 Python
Go语言安装并操作redis的go-redis库
2022/04/14 Golang