Node即学即用

第二部分 　API 和常用模块
第4 章 　核心API　　55
4.1 　Events　　55
4.1.1 　EventEmitter　　56
4.1.2 　Callback 语法　　57
4.2 　HTTP　　59
4.2.1 　HTTP 服务器　　59
4.2.2 　HTTP 客户端　　61
4.2.3 　URL　　65
4.2.4 　querystring　　67
4.3 　I/O　　68
4.3.1 　数据流（stream）　　68
4.3.2 　文件系统　　69
4.3.3 　Buffer　　70
4.3.4 　console.log　　76
第5 章 　工具类API　　77
5.1 　DNS　　77
5.2 　加密　　79
5.2.1 　Hashing　　79
5.2.2 　HMAC　　81
5.2.3 　公钥加密　　82
5.3 　进程　　86
5.3.1 　process 模块　　87
5.3.2 　子进程　　95
5.4 　用assert 来测试　　101
5.5 　虚拟机　　104
第6 章 　数据访问　　109
6.1 　NoSQL 和文档存储　　109
6.1.1 　CouchDB　　109
6.1.2 　Redis　　117
6.1.3 　MongoDB　　25
6.2 　关系型数据库　　129
6.2.1 　MySQL　　129
6.2.2 　PostgreSQL　　136
6.3 　连接池　　139
6.4 　消息队列协议　　141
第7 章 　重要的外部模块　　147
7.1 　Express　　147
7.1.1 　一个简单的Express 应用　　147
7.1.2 　在Express 中设置路由　　148
7.1.3 　处理表单数据　　153
7.1.4 　模板引擎　　154
7.1.5 　中间件　　158
7.2 　Socket.IO　　161
7.2.1 　命名空间　　163
7.2.2 　Express 中使用Socket.IO　　165
第8 章 　扩展Node　　171
8.1 　模块　　171
8.2 　包管理　　172
8.2.1 　搜索包　　172
8.2.2 　创建包　　172
8.2.3 　发布包　　173
8.2.4 　链接　　173
8.3 　附加组件　　174
词汇表　　175
索引　　176

.　　O’Reilly Media, Inc. 1005 Gravenstein Highway North Sebastopol, CA 95472
　　中国：北京市西城区西直门南大街 2号成铭大厦 C座 807室（ 100035）奥莱利技术咨询（北京）有限公司本书有一个 Web页面，上面列出了勘误表、一些实例以及所有的附加信息。可以通过以下链接来访问这个页面：
　　http://oreil.ly/node_upandrunning
　　为本书提意见或者询问一些技术性问题，可以向以下地址发送邮件：
　　bookquestions@oreilly.com
　　更多与书籍、会议、资源中心以及 O’Reilly网络有关的问题，都请参见 O’Reilly的网站：
　　http://www.oreilly.com
　　致谢
　　http://www.oreilly.com
　　感谢我的编辑们。 Simon，这是一个漫长的项目，感谢你天天陪伴着我。 Andy，你对细节的专注让我印象深刻。感谢 Carols，你写作的动力和能力让我羡慕，你为我带来了许多灵感。感谢 Nicole和 Sean，是你们帮我把握方向，让我保持进度。
　　感谢 Ryan和 Isaac，你们像教育孩子那样耐心，不停地回答我那些无休止的傻问题。感谢 Rosemarie，没有你，我不可能有今天的成绩。感谢我的朋友们，特别是 Yta、Emily、Eric、Gris、Sarah、Allan、Harold、Daniella和 Hipster Ariel，感谢你们听我发牢骚。此外，还要感谢无数给我鼓励、建议和反馈的人，没有你们，我无法完成此书。感谢读者朋友，谢谢你们购买并阅读这本书，谢谢你们信任我。
　　——Tom
　　

.　　enki:node-v0.6.6 $ ./configure Checking for program g++ or c++ : /usr/bin/g++ Checking for program cpp : /usr/bin/cpp Checking for program ar : /usr/bin/ar Checking for program ranlib : /usr/bin/ranlib Checking for g++ : ok Checking for program gcc or cc : /usr/bin/gcc Checking for gcc : ok Checking for library dl : yes Checking for openssl : not found Checking for function SSL_library_init : yes Checking for header openssl/crypto.h : yes Checking for library util : yes
　　注 1：翻译本书时，版本已经是 0.8.1了。——译者注
　　Checking for library rt : not found Checking for fdatasync(2) with c++ : no 'configure' finished successfully (0.991s) enki:node-v0.6.6 $
　　接着是运行 make来编译项目（例 1-3）。这将在我们一直使用的源代码文件夹下编译出可执行的二进制文件。 Node会在编译过程中列出当前进行到第几步，以便查看。
　　例 1-3运行 make来编译
　　enki:node-v0.6.6 $ make Waf: Entering directory '/Users/sh1mmer/Downloads/node-v0.6.6/out' DEST_OS: darwin DEST_CPU: x64 Parallel Jobs: 1 Product type: program [ 1/35] copy: src/node_config.h.in -] out/Release/src/node_config.h [ 2/35] cc: deps/http_parser/http_parser.c -] out/Release/deps/http_ parser/http_parser_3.o /usr/bin/gcc -rdynamic -pthread -arch x86_64 -g -O3 -DHAVE_OPENSSL=1 -D_ LARGEFILE_SOURCE ... [ 3/35] src/node_natives.h: src/node.js lib/dgram.js lib/console.js lib/ buffer.js ... [ 4/35] uv: deps/uv/include/uv.h -] out/Release/deps/uv/uv.a
　　...
　　f: Leaving directory '/Users/sh1mmer/Downloads/node-v0.6.6/out' 'build' finished successfully (2m53.573s) -rwxr-xr-x 1 sh1mmer staff 6.8M Jan 3 21:56 out/Release/node enki:node-v0.6.6 $
　　最后一步是用 make install来安装。首先，例 1-4演示了如何为系统下全部用户安装 Node程序。这需要你有 root账户或者有运行 sudo的权限。
　　例 1-4为系统下全部用户安装 Node
　　enki:node-v0.6.6 $ sudo make install Password: Waf: Entering directory '/Users/sh1mmer/Downloads/node-v0.6.6/out' DEST_OS: darwin DEST_CPU: x64 Parallel Jobs: 1 Product type: program
　　 installing deps/uv/include/ares.h as /usr/local/include/node/ares.h
　　 installing deps/uv/include/ares_version.h as /usr/local/include/node/ ares_version.h
　　 installing deps/uv/include/uv.h as /usr/local/include/node/uv.h
　　 installing out/Release/src/node_config.h as /usr/local/include/node/
　　node_config.h Waf: Leaving directory '/Users/sh1mmer/Downloads/node-v0.6.6/out' 'install' finished successfully (0.915s) enki:node-v0.6.6 $
　　如果你想只安装到本地用户，或是不使用 sudo命令，需要在运行 configure的时候加上 --prefix参数，指定路径来代替默认安装（例 1-5）。
　　例 1-5安装到本地用户
　　enki:node-v0.6.6 $ mkdir ~/local
　　enki:node-v0.6.6 $ ./configure --prefix=~/local Checking for program g++ or c++ : /usr/bin/g++ Checking for program cpp : /usr/bin/cpp
　　...
　　'configure' finished successfully (0.501s) enki:node-v0.6.6 $ make && make install Waf: Entering directory '/Users/sh1mmer/Downloads/node-v0.6.6/out' DEST_OS: darwin DEST_CPU: x64
　　...
　　 installing out/Release/node as /Users/sh1mmer/local/bin/node
　　 installing out/Release/src/node_config.h as /Users/sh1mmer/local/
　　
　　include/node/... Waf: Leaving directory '/Users/sh1mmer/Downloads/node-v0.6.6/out' 'install' finished successfully (0.747s) enki:node-v0.6.6 $
　　1.2开始写代码
　　本节将介绍一些 Node开发的基础内容，为进一步学习做准备。
　　1.2.1Node REPL
　　Node是服务器程序，人们常常难以理解它也有和 Perl、Python、Ruby一样的运行时环境。所以通常我们称 Node.js为“服务器端的 JavaScript”，但这不能完全描述 Node.js本身。了解 Node.js的最佳方法是使用其提供的 REPL模式（ Read-Evaluate-Print-Loop，输入 -求值 -输出 -循环），即交互式命令行解析器，它非常适合检验和学习 Node.js。你可以在 Node命令行解析器中试验本书提供的代码片段。此外，因为 Node是对 V8的封装，所以 Node命令行解析器也是用来轻松测试 JavaScript的理想方法。同时，当你想运行一个 Node程序时，可以用任何你喜爱的文本编辑器写好并保存成文件，然后运行 node filename.js。命令行解析器是极佳的学习和探索工具，但我们不会将其用在产品程序中。
　　让我们启动 Node命令行解析器，来个热身，试验一下 JavaScript吧（参见例 1-6）。在你的系统中打开命令行终端。我正使用 Mac系统的自定义命令行环境，所以你的系统提示可能会有所不同，但使用的命令应该是一样的。
　　例 1-6启动 Node命令行解析器并尝试测试 JavaScript
　　$Enki:~ $ node ] 3 ] 2 ] 1
　　false
　　] true == 1
　　true
　　] true === 1
　　 false
　　
　　
　　第一行代码返回的结果为 false。这个例子来自一个收集 JavaScript诡异和奇特特性的网站 http://wtfjs.com。
　　拥有一个实时的开发环境，你就有了非常好的学习工具，但你还需要了解 Node解析器的一些有用的功能，才能更好地使用它。它提供了以点号（ .）开头的元命令。如 .help会显示帮助菜单， .clear会清除当前运行的内容， .exit将退出 Node解析器（见例 1-7）。其中最有用的命令是 .clear，它会清除内存中任何变量或闭包，而不需要重启解析器。
　　例 1-7使用 Node解析器中的元命令
　　] console.log('Hello World'); Hello World ] .help .clear Break, and also clear the local context. .exit Exit the prompt .help Show repl options ] .clear Clearing context... ] .exit Enki:~ $
　　使用解析器时，输入变量的名称就会在终端上显示其内容。 Node会尝试智能地显示复杂对象，比如通过描述来反映对象的内部构造，而不是简单地将其当做普通对象来显示（见例 1-8）。主要的例外是显示函数，并非解析器无法显示函数内容，而是因为函数通常都很长，如果解析器把函数都展开，很可能会导致刷屏。
　　例 1-8解析器设置并显示对象
　　Enki:~ $ node ] myObj = {}; {} ] myObj.list = ["a", "b", "c"]; [ 'a', 'b', 'c' ]
　　] myObj.doThat = function(first, second, third) { console.log(first); }; [Function] ] myObj { list: [ 'a', 'b', 'c' ] , doThat: [Function] } ]
　　1.2.2编写首个服务器程序
　　命令行解析器是我们学习和试验的好工具，而 Node.js最主要的应用是服务器程序。设计 Node.js的一个主要目的是提供高度可扩展的服务器环境。这是我们在本章开篇介绍过的 Node和 V8引擎有所区别的地方。 Node除了用 V8引擎来解析 JavaScript外，还提供了高度优化的应用库，用来提高服务器效率。比如说， HTTP模块是专为快速非阻塞式 HTTP服务器而用 C重新编写的。让我们看一下 Node采用 HTTP服务器的“ Hello World”经典例子（例 1-9）。
　　例 1-9“Hello World”Node.js Web服务器
　　var http = require('http');
　　http.createServer(function (req, res) {
　　res.writeHead(200, {'Content-Type': 'text/plain'});
　　res.end('Hello World\n');
　　}).listen(8124, "127.0.0.1");
　　console.log('Server running at http://127.0.0.1:8124/');
　　这个示例代码首先通过 require方法把 HTTP库包含到程序中来。有许多语言都有包含其他库这一方法， Node用的是 CommonJS模块风格。 Node模块将在第 8章详细介绍，当前需要了解的是， HTTP库所具有的功能已经赋给了 http对象。
　　下一步，我们需要一个 HTTP服务器。 PHP等其他语言需要在类似 Apache这样的
　　服务器中运行，而 Node和它们不同，因为 Node本身就是 Web服务器。但这同样
　　意味着我们需要先创建该服务器。下一行代码调用 HTTP模块的一个工厂模式方法（createServer）来创建新的 HTTP服务器。新创建的 HTTP服务器并没有赋值给
　　任何变量，它只会成为存活在全局范围内的匿名对象。我们可以通过链式调用来初
　　始化服务器，并告诉它监听在 8124端口。
　　当调用 createServer的时候，我们传了一个匿名函数作为参数。此函数绑定在新创建服务器的事件监听器上进行 request事件处理。消息事件是 JavaScript和 Node的核心。在这个例子中，每当一个新的访问请求到达 Web服务器，它都将调用我们指定的函数方法来处理。我们称这类方法为回调（ callback）。因为每当一个事件发生时，我们将回调监听此事件的所有函数。一个很恰当的类比是，你从书店预订一本书，等书到货时，书店会“回调”通知你去取。
　　
　　例子中的回调函数有两个参数，一个是请求的对象（ req），一个是响应的对象（res）。在回调函数中，我们调用了 res对象的几个方法，这将修改响应结果。例 1-9没有使用 req对象，但你通常会需要同时使用请求和响应对象。
　　
　　首先我们必须调用 res.writeHead方法来设置 HTTP响应头，否则就不能返回真实内容给客户端。我们设置状态代码为 200（表示 HTTP状态代码“ 200 OK”），并且传入一段 HTTP头描述。在本例中，我们只指定了 Content-type。
　　在完成了 HTTP头后，我们可以写入 HTTP正文。在本例中，我们用一个方法来同时完成写入正文及关闭连接。 end方法将会关闭 HTTP连接。但因为我们同时还传入了一个字符串， end方法将在把此内容发送给客户端后才关闭连接。
　　例子的最后一行调用了 console.log方法。就像 Firebug和 Web Inspector支持的浏览器对应方法那样，它将在标准输出 stdout上打印信息。
　　让我们在 Node.js终端上运行此程序，并看看运行结果（例 1-10）。
　　例 1-10运行“ Hello World”程序
　　Enki:~ $ node ] var http = require('http'); ] http.createServer(function (req, res) {
　　] console.log('Server running at http://127.0.0.1:8124/'); Server running at http://127.0.0.1:8124/ node]
　　在这里我们运行 Node解析器，然后输入例子中的代码（我们不介意你从网站上进行复制粘贴）。Node解析器接受了代码，并用“…”提示你的输入未完成并等待补充完整。当我们运行到 console.log那行时， Node解析器打印出 Server running at http://127.0.0.1:8124/。现在我们可以在浏览器中访问“ Hello World”例子了（如图 1-1所示）。
　　图 1-1：在浏览器中访问“ Hello World”
　　跑起来了！虽然这不是一个惊人的演示，但我们只用了 6行代码就把“ Hello World”程序运行起来了。我们并不推荐这样的代码风格，但我们已经往前迈出第一步了。在下一章中，我们将看到更多的代码，但接下来我们先思考一下为什么 Node会发展成为现在这个样子。
　　1.3为什么选择 Node
　　在写本书的时候，我们清楚地知道 Node.js是多么地新。许多平台要经历多年才被人们接受，而在 Node.js这一崭新的平台上，人们却展现了前所未有的热情。我们希望通过探究人们热衷于 Node.js的原因，帮助你找到能产生共鸣的特性。通过了解 Node.js的强项，我们能发掘出它最擅长的领域。本节将讨论是哪些因素造就了 Node.js，它为何能快速流行。
　　1.3.1高性能 Web服务器
　　当我们在 10多年前第一次开始编写 Web应用的时候， Web还非常小。当然，期间我们经历了 .com泡沫。但那时从事互联网行业的人数还是相当少，创建的网站也没现在这么火热。时至今日，有了先进的 Web 2.0和随时随地可以上网的手机，这对我们这些开发人员提出了更多的要求。我们不但要提供更复杂、更多交互、更接近生活的功能，而且有越来越多的用户通过各种设备频繁使用这些功能，这是一个极大的挑战。硬件在持续改进，同时我们也需要提高软件开发水平来支持这些需求。如果只是单纯地采购更多的硬件来支撑新功能和新用户，就不那么划算了。
　　Node给 Web服务器程序开发领域引进了事件驱动编程，来尝试解决这一问题。实践证明，虽然 Node不是第一个尝试此方法的平台，但它是目前为止最为成功的平台，而且我们认为它使用起来也是最容易的。后续章节会详细分析事件驱动编程，在这里我们先对其进行简短的介绍。想象一下，你现在需要连接到一台 Web服务器上获取一个网页，这在正常的 DSL连接速度下通常需要花费 100毫秒左右。如果连接的是一台普通的 Web服务器，它会在服务器上为你的请求创建一个新的程序运行实例。该程序自顶向下运行（按顺序运行所有的函数）来响应请求并生成网页返回给你。这意味着该服务器在请求被满足前需要一直占用固定大小的内存，其中包括了把数据返回给你所要等待的 100多毫秒。 Node则不是采用此方式，而是在同一个程序内服务所有的用户。每当 Node需要等待一些费时的操作，比如等待确认你已经收到返回的数据时（好让它标记此请求已经完成），它就继续处理下一个用户的请求去了。我们对细节描述得还是太多了，但这些特性意味着 Node在内存处理上比传统服务器程序高效得多，也就是能够同时快速地服务更多的用户。这是个巨大的成就，人们也为此而热爱 Node。
　　1.3.2专业的 JavaScript
　　人们喜欢 Node的另一个原因是 JavaScript。Brendan Eich在 1995年发明了 JavaScript语言，这是一门在 Netscape浏览器上使用的简单脚本语言。令人惊讶的是，自从 JavaScript出现以来，它已经不止运用在浏览器上了。早先 Netscape服务器程序就支持 JavaScript作为一门服务器端脚本语言（称为 LiveScript）。虽然 JavaScript当时并没有在服务器端得到广泛应用，却毫不妨碍它在快速发展的浏览器市场上大受欢迎。 JavaScript和微软的 VBScript展开了激烈竞争，都想成为 Web上的主流开发语言。很难说明为什么 JavaScript最终胜出，也许是因为微软允许 JavaScript运行在 IE浏览器上 2，也许是因为 JavaScript语言本身优势明显，无法不脱颖而出，总之它完胜了。于是，在 2000年初期， JavaScript已经成为 Web开发语言的代名词，不只是在浏览器开发 HTML的第一选择，而且是唯一的选择。
　　这和 Node.js又有什么关系呢？首先我们要记得当 AJAX革命发生，并且 Web风头正劲的时候（想想 Yahoo!、Amazon、Google等是多么风光），AJAX中“ J”的唯一选择就是 JavaScript，完全没有其他替代品。这导致整个行业急需大量优秀的 JavaScript程序员。 Web成为一个真正意义上的平台，并且附带着 JavaScript是其开发语言，这就要求我们这些 JavaScript程序员去提升自身能力。 JavaScript被视为程序员的第二或第三门编程语言，这本身就反映出人们对其重要性的重新认识。此时涌现出许多专家，他们的努力使 JavaScript越来越为人们所接受。
　　这一运动的带头人物当属 Douglas Crockford。他关于 JavaScript的文章和视频很受欢迎，帮助许多程序员发现了这门备受指责的语言中所隐藏的内在美。许多使用 JavaScript的程序员为了处理 HTML和 XML文档，把主要精力花费在了浏览器对 W3C DOM API的不同实现上。可悲的是， DOM可能是 API中最丑陋的，而且各款浏览器的实现又是那么地不一致和不完整。也难怪过去十年里许多程序员都没有把 JavaScript认作一门“严肃”的语言。最近， Douglas关于 JavaScript好处（ the good parts）的论述让人们认识到这门语言虽有弊病，但仍存在许多宝贵之处，因而带动了此语言的振兴。
　　在 2012年的今天，有越来越多的 JavaScript专家倡导 JavaScript代码应当精心编写、高性能、易维护。 Douglas Crockford、Dion Almaer、Peter Paul Koch（PPK）、 John Resig、Alex Russell、Thomas Fuchs等许多专家对此进行了研究、提议和加工，其中最主要的是提供了程序库，这些程序库让全世界成千上万的专业 JavaScript
　　译注 2：IE浏览器并非真的支持 JavaScript或 ECMAScript，它支持的变种叫 JScript。近年来， JScript完
　　整地支持了 ECMA-Script 3，以及 ECMAScript 5的部分特性。同时， JScript还和 Mozilla的
　　JavaScript一样实现了一些专有的扩展，并且增加了某些非 ECMAScript标准的特性。
　　
　　程序员能以追求卓越的精神去从事自己的行业。 jQuery、YUI、Dojo、Prototype、 Mootools、Sencha等许多程序库部署在各个网站上供大量用户每日使用。在 JavaScript不但被接受，还被广泛应用和拥护的环境下，这样的平台也许比 Web本身更为宽广。当这么多的程序员了解了 JavaScript时，这样的普及就成为了它的一个明显优势。
　　如果你在一屋子 Web程序员中调查他们使用什么语言，会了解到 Java和 PHP是最流行的， Ruby可能是目前次流行的（或者说至少和 Python流行程度相当），Perl则依然有许多追随者。但几乎可以肯定，任何从事 Web开发的人都使用过 JavaScript。虽然后端语言与浏览器直接割裂开来，但编程这事儿都脱离不了部署这一环节。各种各样的浏览器及浏览器插件允许使用不同的语言，但这些语言都不足以成为 Web开发的通用语言。现在我们面前有这样一个单一且通用的 Web开发语言，我们怎样才能把它放到服务器上去呢？
　　1.3.3浏览器之战 2.0
　　在互联网初期，我们就经历了恶名昭著的浏览器之战。Internet Explorer和 Netscape在 Web功能上竞争激烈，他们分别在各自的浏览器上添加各种不兼容别人的编程特性，而且不支持其他浏览器所具备的功能。对于那些编写 Web程序的开发者来说，这些都是苦闷的来源，因为这使得 Web开发非常烦琐。 Internet Explorer或多或少成为了该轮竞争的胜者，变成了主流浏览器。几年之后，当微软在 IE6上裹足不前的时候，出现了一个新的竞争者：从 Netscape的旧成员中诞生的 Firefox。Firefox让浏览器市场风云再起， WebKit（Safari）和 Chrome紧跟其后。其中最有趣的还是在浏览器市场中新的竞争情况。
　　与浏览器之战的第一轮交锋不同，今天的浏览器主要争夺两个战场：一是坚持上一次浏览器战争后出现的标准，二是性能。随着网站越来越复杂，用户都想要最快的体验。这意味着，浏览器不但要很好地支持 Web标准和允许开发者进行优化，还要尽力在自己内部进行优化。以 JavaScript为核心模块的 Web 2.0时代， AJAX网站已经成为新的战场。
　　每个浏览器都有各自的 JavaScript解析器： Firefox的 Spider Monkey、Safari的 Squirrel Fish Extreme、Opera的 Karakan，最后还有 Chrome带来的 V8。这些解析器不断追求更快的性能，也为 JavaScript制造了创新的环境。为了让自己的浏览器突围而出，厂商们将尽最大能力让它运行得越来越快。