nodejs 实践:express 最佳实践(七) 改造模块 connect2 解析

nodejs 发展很快,从 npm 上面的包托管数量就可以看出来。不过从另一方面来看,也是反映了 nodejs 的基础不稳固,需要开发者创造大量的轮子来解决现实的问题。

知其然,并知其所以然这是程序员的天性。所以把常用的模块拿出来看看,看看高手怎么写的,学习其想法,让自己的技术能更近一步。

引言

上一篇文章中,我讨论了 connect 模块,它做为 http 的中间件,设计得很灵活,接口设计也很少,非常便于使用。

其实 connect 模块的思想就是把 http 请求和回应看成流水线,而中间件则是流水线上的处理器,满足路由匹配,则调用相应的方法,直到结果返回。

我就在想,这套思想能不能用在别的地方? 如 rpc, tcp 的请求处理,它们也都是一问一答的模式,也都可以抽象成流水线的模式进行处理,每个中间件对其中的数据进行处理,最后把结果返回了。

在仔细研究了 connect 的源码的基础上,我精减了部分代码,拿掉了 http 部分, 还有 url 匹配的部分,保留最有用的部分,同时增加了参数化配置和上下文环境。

于是就有了: connect2这个模块,最小化 connect 的功能,保留了 next 和错识处理等已知的概念,没有带它的功能。它可以做为一个基础的模块嵌入到一个 rpc,tcp , http 中去,然后利用中间件的思想去完成你的业务。

下面,就仔细说说,我对它的考虑和使用说明。

解析

我对该模块的第一个考虑就是,他的实现跟某种协议无关。可以看看 connect2 的使用方法:

var connect = require('connect2');

var app = connect();

app.use(function(ctx, req, res, next){
console.log('md1')
next()
}); app.use(function(ctx, req, res) {
console.log('md2')
next()
}) function main() {
let context = {};
let req = {};
let res = {}; app(context, req, res);
} main();

可以看出,基本使用的方法于 connect 的模块相同,但是已经没有调用 http 的服务器了,它能在一个普通的函数中调用。

同时,多了一个 context, 这个我觉得挺重要的,用 express 做项目时,要跟踪请求全链路的路径,这在 java 中还好办,有 ThreadLocal 。这在 nodejs 中没有什么很好的办法,只能通过参数的形式,把 requestId 传下去。而 context 就是放这一类参数很好的地方。

有了这个 context 还可以把 协议 上下文也放到里面,实现更有用的功能。

导出函数是这样写的:

function createServer(opts) {
function app (ctx, req, res, next) { app.handle(ctx, req, res, next)} Object.assign(app, proto);
Object.assign(app, opts);
Object.assign(app, EventEmitter.prototype);
app.stack = [];
app.route = '';
return app;
}

多了一个配置的 opts,会把 opts 的属性复制到 app 上面。后面会说一下有哪些方法可以配置。

而 use 方法也是基本没有怎么改变,删除了 http 的部分:

proto.use = function(route, fn) {
let handle = fn;
let path = route; if (typeof route !== 'string') {
handle = route;
path = '';
} if (typeof handle.handle === 'function') {
let server = handle;
server.route = path; handle = function(ctx, req, res, next) {
server.handle(ctx, req, res, next);
};
} this.stack.push({handle: handle, route: path});
}

下面说说其中的核心 handle 功能:

proto.handle = function(ctx, req, res, out) {
let i = 0;
let done = out || (this.finalHandler && this.finalHandler(ctx, req, res)) || NOOP;
let dispatchContext = (this.dispatchContext && this.dispatchContext()) || {};
let self = this; Object.assign(ctx, {
app: this,
req: req,
res: res
}) let next = function(err) {
let layer = self.stack[i++] if (!layer) {
defer(done, err)
return;
} if (layer.route && self.dispatch && !self.dispatch(dispatchContext, layer.route, req)) {
return next(err)
} debug('use %s %s', layer.route || 'none', layer.handle.name || 'anonymous');
call(layer.handle, layer.route, err, ctx, req, res, next);
} next();
}

任何请求都有一个结束, 在 connect 中使用的是 finalhanlder 模块,也只能处理 http 问题,这里我们与 协议无关,因此这里就需要留下 一个接口,这个接口就通过 opts 进行配置的。

另外还有匹配参数的方法,dispatch 这块是把 url 参数匹配的算法移出,通过初始化参数的形式返回。

更多的例子可以在 test/server.js 中找到。

总结

connect2 就是对 connect 的一个精减。针对的更加普遍的问题,对一些东西能进行流水线的形式进行处理,将变化写成中间件,然后对所以的数据进行处理,在合适的时候返回。

特别合适网络服务器,自定义协议的部分,想想,通过这个模块,除了底层的协议,跟 http 不一样,其他都一样,这样写业务是不是很爽呢?

很快就要把这个模块融入到一个项目中,还有想把该项目给 typescript 化。

connect2 github

nodejs模块学习: connect2解析的更多相关文章

  1. # nodejs模块学习: express 解析

    # nodejs模块学习: express 解析 nodejs 发展很快,从 npm 上面的包托管数量就可以看出来.不过从另一方面来看,也是反映了 nodejs 的基础不稳固,需要开发者创造大量的轮子 ...

  2. nodejs模块学习: webpack

    nodejs模块学习: webpack nodejs 发展很快,从 npm 上面的包托管数量就可以看出来.不过从另一方面来看,也是反映了 nodejs 的基础不稳固,需要开发者创造大量的轮子来解决现实 ...

  3. nodejs模块学习: connect解析

    nodejs模块学习: connect解析 nodejs 发展很快,从 npm 上面的包托管数量就可以看出来.不过从另一方面来看,也是反映了 nodejs 的基础不稳固,需要开发者创造大量的轮子来解决 ...

  4. nodejs模块学习: express-session 解析

    nodejs模块学习: express-session 解析 nodejs 发展很快,从 npm 上面的包托管数量就可以看出来.不过从另一方面来看,也是反映了 nodejs 的基础不稳固,需要开发者创 ...

  5. python模块学习---HTMLParser(解析HTML文档元素)

    HTMLParser是Python自带的模块,使用简单,能够很容易的实现HTML文件的分析. 本文主要简单讲一下HTMLParser的用法. 使用时需要定义一个从类HTMLParser继承的类,重定义 ...

  6. nodejs 实践:express 最佳实践(七) 改造模块 connect2 解析

    nodejs 实践:express 最佳实践(七) 改造模块 connect2 解析 nodejs 发展很快,从 npm 上面的包托管数量就可以看出来.不过从另一方面来看,也是反映了 nodejs 的 ...

  7. nodeJS学习(9)--- nodeJS模块:exports vs module.exports

    模块简介: 通过Node.js的官方API可以看到Node.js本身提供了很多核心模块 http://nodejs.org/api/ 这些核心模块被编译成二进制文件,可以 require('模块名') ...

  8. nodejs模块xml2js解析xml的坑

    在一个项目中,用到nodejs模块xml2js解析xml,xml的数据如下: <xml> <MsgId>6197906553041859764</MsgId> &l ...

  9. NodeJS入门学习教程

    一.概念 1.什么是nodejs Node.js是JavaScript 运行时环境,通俗易懂的讲,Node.js是JavaScript的运行平台 Node.js既不是语言,也不是框架,它是一个平台 2 ...

随机推荐

  1. Opencv在linux下安装

    Opencv in Linux These steps have been tested for Ubuntu 10.04 but should work with other distros as ...

  2. Vue之Vuex

    一.什么是vuex Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式.它采用集中式存储管理应用的所有组件的状态,并以相应的规则保证状态以一种可预测的方式发生变化.简单来说就是一个数据统一 ...

  3. centos7下,解决Apache错误日志文件过大问题

    1,日志文件太大问题   第一步:停止Apache服务的所有进程,删除 /var/log/httpd目录下的 error.log.access.log文件 第二步:打开 /etc/httpd/conf ...

  4. php curl 的几个实例

    使用PHP的cURL库可以简单和有效地去抓网页.你只需要运行一个脚本,然后分析一下你所抓取的网页,然后就可以以程序的方式得到你想要的数据了.无论是你想从从一个链接上取部分数据,或是取一个XML文件并把 ...

  5. 分享几个python小脚本

    by 梁凯 今天我想给大家分享几个python脚本,分别是: 1.公司访问外网认证脚本(最初有同事写过,我优化了一下). 2.统计周报系统所有同事的最近一篇周报. 3.统计测试技术分享里指定一个月所有 ...

  6. 38. Count and Say - Unsolved

    https://leetcode.com/problems/count-and-say/#/description The count-and-say sequence is the sequence ...

  7. datagrid 添加、修改、删除(转载)

    原链接:JQueryEasyUI学习笔记(十)datagrid 添加.修改.删除 基于datagrid框架的删除.添加与修改: 主要是批量删除,双击表单修改.选中行修改,增加行修改,再有就是扩展edi ...

  8. 工程师倾情奉献-Win7 ISO 精简操作说明

    1.前提条件 a)本文档内容只适用于32bit win7 install ISO,其它OS不能保证兼容 b)示范文件为win7-ultimate-rtm-32-en-us-rdvd.iso 2.准备待 ...

  9. JS事件及其兼容用法

    JavaScript与HTML之间的交互是通过事件实现的.事件,就是文档或浏览器窗口中发生的一些特定的交互瞬间. 1.事件流:描述的是从页面中接收事件的顺序. IE提出的事件冒泡流:事件开始由最具体的 ...

  10. python 解析docx文档的方法,以及利用Python从docx文档提取插入的文本对象和图片

    首先安装docx模块,通过pip install docx或者在docx官方链接上下载安装都可以 下面来看下如何解析docx文档:文档格式如下 有3个部分组成 1 正文:text文档 2 一个表格. ...