深入理解Node系列-细说Connect(上)

前言

想必对于广大前后端的同学们,Node 或是用来作为网站服务器的搭建,亦或是用来作为开发脚手架的运用,或是早有套路,亦或是浅尝辄止。从现在开始博主将会不定时的对 Node 系列的产品做分析,其中夹杂着常见的基础模块,三方模块,丰富大家的 Node 技术栈。

很多童鞋上手项目时,通常会将 Express 作为 Node 端框架,而本文主要对其底层构件 Connect 做一个分析。

connect

Connect 是一个可扩展(中间件作为插件)的 Http 服务器框架,Connect 刚出道之时自带了许多中间件,为保证其框架的轻量级以及扩展性,最终还是将这些中间件的实现抛给了社区。可能在搜索 Connect 的相关项目时,你会发现 connect().use(connect.bodyParser())这些的写法,这对于现在的 Connect (最新版本3.6.0) 是不支持的,而只能通过 npm 下载第三方的模块 (如 body-parser) 替代原先的中间价。

1. 基本使用

Connect 提供的 API 不多,并且非常容易理解。

listen

Connect 引入了 http 原生模块,因此 listen 也是用来监听端口的。

var connect = require(‘connect‘);
var PORT = 3000;
connect()
    .use(function(req, res) {
        res.end(‘listen port is ‘ + PORT);
    })
    .listen(PORT);
// 访问localhost:3000

use

在 req/res 中有许多内容需要通过中间件处理才能方便取到,而 use 正好为中间件提供了一个入口。

var connect = require(‘connect‘);
var cookieParser = require(‘cookie-parser‘);

connect()
    .use(function(req, res, next) {
        console.log(‘未使用cookie-parser‘, req.cookies);
        next();
    })
    .use(cookieParser())
    .use(function(req, res) {
        console.log(‘使用cookie-parser‘, req.cookies);
        res.end(‘.‘);
    })
    .listen(3000);

执行 curl http://localhost:3000 -H "Cookie: name=sharlly" 会得到

未使用cookie-parser undefined

使用cookie-parser { name: ‘sharlly‘ }

你可能会关注到 cookieParser 上面的函数比下面的多了一个 next 参数,这是 Connect 对中间件设定,只用调用了 next() 才会继续下一个中间件的执行,最后一个中间件则不需要使用。

挂载url

如果你想针对某个访问路径做出不同的响应(即挂载,如设置用户访问权限),则同样可以使用 use() ,不过写法有所改变,如我希望访问 /home/… 和 /articles/… 并得到不同的内容。

var connect = require(‘connect‘);

connect()
    .use(‘/home‘, function(req, res) {
        res.end(‘home‘);
    })
    .use(‘/articles‘, function(req, res) {
        res.end(‘articles‘);
    })
    .use(function(req, res) {
        res.end(‘others‘);
    })
    .listen(3000)

2. 源码剖析

connect 的源码非常简短,可简单整理如下图:

use函数

proto.use = function use(route, fn) {
  var handle = fn;
  var path = route;

  // default route to ‘/‘
  if (typeof route !== ‘string‘) {
    handle = route;
    path = ‘/‘;
  }

  // wrap sub-apps
  if (typeof handle.handle === ‘function‘) {
    var server = handle;
    server.route = path;
    handle = function (req, res, next) {
      server.handle(req, res, next);
    };
  }

  // wrap vanilla http.Servers
  if (handle instanceof http.Server) {
    handle = handle.listeners(‘request‘)[0];
  }

  // strip trailing slash
  if (path[path.length - 1] === ‘/‘) {
    path = path.slice(0, -1);
  }

  // add the middleware
  debug(‘use %s %s‘, path || ‘/‘, handle.name || ‘anonymous‘);
  this.stack.push({ route: path, handle: handle });

  return this;
};

非常好理解,use() 将 route 和 function 一一对应并保存到 this.stack 当中,若只有一个参数,则默认 route = ‘/’ 。那保存下来的函数在哪里执行呢?再来看看 handle 函数。

handle函数

proto.handle = function handle(req, res, out) {
  var index = 0;
  var protohost = getProtohost(req.url) || ‘‘;
  var removed = ‘‘;
  var slashAdded = false;
  var stack = this.stack;

  // final function handler
  var done = out || finalhandler(req, res, {
    env: env,
    onerror: logerror
  });

  // store the original URL
  req.originalUrl = req.originalUrl || req.url;

  function next(err) {
    // omit...
    var layer = stack[index++];
    // call the layer handle
    call(layer.handle, route, err, req, res, next);
  }

  next();
};

当有请求进入到 Node 后,http 模块会触发 request 事件,此时会执行一次 handle(req, res, next) 。而在 handle 函数中可以看到回调方法 next(),通过 stack[index++] 将下一个 layer.handle 传递给 call() 执行,call() 带了几个参数,分别是 use中自定义的方法请求路径错误对象请求对象响应对象handle()中的next()

而 call 方法也是非常简单

function call(handle, route, err, req, res, next) {
  var arity = handle.length;
  var error = err;
  var hasError = Boolean(err);

  debug(‘%s %s : %s‘, handle.name || ‘<anonymous>‘, route, req.originalUrl);

  try {
    if (hasError && arity === 4) {
      // error-handling middleware
      handle(err, req, res, next);
      return;
    } else if (!hasError && arity < 4) {
      // request-handling middleware
      handle(req, res, next);
      return;
    }
  } catch (e) {
    // replace the error
    error = e;
  }

  // continue
  next(error);
}

call 将 next 传给 use 自定义的函数上,这样 在自定义函数中调用 next 就可以调用下一个中间件了,直到最后一个中间件执行完后,之前的中间件 next 后面的代码才会按作用域依次执行。

整个过程总结如下:

结语

通过分析 Connect 源码,对其中间件运行机制也有了一定的掌握。下篇,将会对 Connect 常用中间件以及第三方模块进行介绍。

时间: 2024-10-13 00:17:13

深入理解Node系列-细说Connect(上)的相关文章

深入理解JavaScript系列(49):Function模式(上篇)

介绍 本篇主要是介绍Function方面使用的一些技巧(上篇),利用Function特性可以编写出很多非常有意思的代码,本篇主要包括:回调模式.配置对象.返回函数.分布程序.柯里化(Currying). 回调函数 在JavaScript中,当一个函数A作为另外一个函数B的其中一个参数时,则函数A称为回调函数,即A可以在函数B的周期内执行(开始.中间.结束时均可). 举例来说,有一个函数用于生成node var complexComputation = function () { /* 内部处理,

深入理解JavaScript系列(24):JavaScript与DOM(下)

介绍 上一章我们介绍了JavaScript的基本内容和DOM对象的各个方面,包括如何访问node节点.本章我们将讲解如何通过DOM操作元素并且讨论浏览器事件模型. 本文参考:http://net.tutsplus.com/tutorials/javascript-ajax/javascript-and-the-dom-lesson-2/ 操作元素 上一章节我们提到了DOM节点集合或单个节点的访问步骤,每个DOM节点都包括一个属性集合,大多数的属性都提供为相应的功能提供了抽象.例如,如果有一个带有

Node系列——Node中的异常处理。

1.对异常错误的理解 异常错误应该被分为两种情况:操作失败和程序员失误 1.1.操作失败 这是正确编写的程序在运行时产生的错误.它并不是程序的Bug,反而经常是其它问题. 例如:系统本身(内存不足或者打开文件数过多),系统配置(没有到达远程主机的路由),网络问题(端口挂起),远程服务(500错误,连接失败).具体情况如下: 连接不到服务器 无法解析主机名 无效的用户输入 请求超时 服务器返回500 套接字被挂起 系统内存不足 1.2.程序员失误 这是程序里的Bug.这些错误往往可以在调试阶段通过

方便大家学习的Node.js教程(一):理解Node.js

理解Node.js 为了理解Node.js是如何工作的,首先你需要理解一些使得Javascript适用于服务器端开发的关键特性.Javascript是一门简单而又灵活的语言,这种灵活性让它能够经受住时间的考验.函数.闭包等特性使Javascript成为一门适合Web开发的理想语言. 有一种偏见认为Javascript是不可靠的,然而事实并非如此.人们对Javascript的偏见来源于DOM,DOM是浏览器厂商提供的用于Javascript与浏览器交互的API,不同浏览器厂商实现的DOM存在差异.

深入理解JavaScript系列(1):编写高质量JavaScript代码的基本要点(转)

才华横溢的Stoyan Stefanov,在他写的由O’Reilly初版的新书<JavaScript Patterns>(JavaScript模式)中,我想要是为我们的读者贡献其摘要,那会是件很美妙的事情.具体一点就是编写高质量JavaScript的一些要素,例如避免全局变量,使用单变量声明,在循环中预缓存length(长度),遵循代码阅读,以及更多. 此摘要也包括一些与代码不太相关的习惯,但对整体代码的创建息息相关,包括撰写API文档.执行同行评审以及运行JSLint.这些习惯和最佳做法可以

深入理解JavaScript系列 --汤姆大叔

深入理解JavaScript系列文章,包括了原创,翻译,转载,整理等各类型文章,如果对你有用,请推荐支持一把,给大叔写作的动力. 深入理解JavaScript系列(1):编写高质量JavaScript代码的基本要点 深入理解JavaScript系列(2):揭秘命名函数表达式 深入理解JavaScript系列(3):全面解析Module模式 深入理解JavaScript系列(4):立即调用的函数表达式 深入理解JavaScript系列(5):强大的原型和原型链 深入理解JavaScript系列(6

深入理解JavaScript系列(33):设计模式之策略模式(转)

介绍 策略模式定义了算法家族,分别封装起来,让他们之间可以互相替换,此模式让算法的变化不会影响到使用算法的客户. 正文 在理解策略模式之前,我们先来一个例子,一般情况下,如果我们要做数据合法性验证,很多时候都是按照swith语句来判断,但是这就带来几个问题,首先如果增加需求的话,我们还要再次修改这段代码以增加逻辑,而且在进行单元测试的时候也会越来越复杂,代码如下: validator = { validate: function (value, type) { switch (type) { c

深入理解JavaScript系列(21):SOLID五大原则之接口隔离原则ISP(转载)

深入理解JavaScript系列(21):SOLID五大原则之接口隔离原则ISP 前言 本章我们要讲解的是S.O.L.I.D五大原则JavaScript语言实现的第4篇,接口隔离原则ISP(The Interface Segregation Principle). 英文原文:http://freshbrewedcode.com/derekgreer/2012/01/08/solid-javascript-the-interface-segregation-principle/注:这篇文章作者写得

hdu---(4515)小Q系列故事——世界上最遥远的距离(模拟题)

小Q系列故事——世界上最遥远的距离 Time Limit: 500/200 MS (Java/Others)    Memory Limit: 65535/32768 K (Java/Others)Total Submission(s): 1751    Accepted Submission(s): 628 Problem Description 世界上最遥远的距离 不是生与死 而是我就站在你面前 你却不知道我爱你 世界上最遥远的距离 不是我就站在你面前你却不知道我爱你 而是明明知道彼此相爱