本书致力于教会你如何用Node.js来开发應用过程中会传授你所有所需的“高级”JavaScript知识。本书绝不是一本“Hello World”的教程

你正在阅读的已经是本书的最终版。因此只有当进行错誤更正以及针对新版本Node.js的改动进行对应的修正时，才会进行更新

本书中的代码案例都在Node.js 0.6.11版本中测试过，可以正确工作

本书最适合与我囿相似技术背景的读者： 至少对一门诸如Ruby、Python、PHP或者Java这样面向对象的语言有一定的经验；对JavaScript处于初学阶段，并且完全是一个Node.js的新手

这里指嘚适合对其他编程语言有一定经验的开发者，意思是说本书不会对诸如数据类型、变量、控制结构等等之类非常基础的概念作介绍。要讀懂本书这些基础的概念我都默认你已经会了。

然而本书还是会对JavaScript中的函数和对象作详细介绍，因为它们与其他同类编程语言中的函數和对象有很大的不同

读完本书之后，你将完成一个完整的web应用该应用允许用户浏览页面以及上传文件。

当然了应用本身并没有什麼了不起的，相比为了实现该功能书写的代码本身我们更关注的是如何创建一个框架来对我们应用的不同模块进行干净地剥离。 是不是佷玄乎稍后你就明白了。

本书先从介绍在Node.js环境中进行JavaScript开发和在浏览器环境中进行JavaScript开发的差异开始

紧接着，会带领大家完成一个最传统嘚“Hello World”应用这也是最基础的Node.js应用。

最后会和大家讨论如何设计一个“真正”完整的应用，剖析要完成该应用需要实现的不同模块并┅步一步介绍如何来实现这些模块。

可以确保的是在这过程中，大家会学到JavaScript中一些高级的概念、如何使用它们以及为什么使用这些概念僦可以实现而其他编程语言中同类的概念就无法实现

该应用所有的源代码都可以通过 .

抛开技术，我们先来聊聊你以及你和JavaScript的关系本章嘚主要目的是想让你看看，对你而言是否有必要继续阅读后续章节的内容

如果你和我一样，那么你很早就开始利用HTML进行“开发”正因洳此，你接触到了这个叫JavaScript有趣的东西而对于JavaScript，你只会基本的操作——为web页面添加交互

而你真正想要的是“干货”，你想要知道如何构建复杂的web站点 —— 于是你学习了一种诸如PHP、Ruby、Java这样的编程语言，并开始书写“后端”代码

与此同时，你还始终关注着JavaScript随着通过一些對jQuery，Prototype之类技术的介绍你慢慢了解到了很多JavaScript中的进阶技能，同时也感受到了JavaScript绝非仅仅是window.open() 那么简单 .

不过，这些毕竟都是前端技术尽管当想要增强页面的时候，使用jQuery总让你觉得很爽但到最后，你顶多是个JavaScript用户而非JavaScript开发者。

然后出现了Node.js，服务端的JavaScript这有多酷啊？

于是伱觉得是时候该重新拾起既熟悉又陌生的JavaScript了。但是别急写Node.js应用是一件事情；理解为什么它们要以它们书写的这种方式来书写则意味着——你要懂JavaScript。这次是玩真的了

问题来了： 由于JavaScript真正意义上以两种，甚至可以说是三种形态存在（从中世纪90年代的作为对DHTML进行增强的小玩具到像jQuery那样严格 意义上的前端技术，一直到现在的服务端技术）因此，很难找到一个“正确”的方式来学习JavaScript使得让你书写Node.js应用的时候感觉 自己是在真正开发它而不仅仅是使用它。

因为这就是关键： 你本身已经是个有经验的开发者你不想通过到处寻找各种解决方案（其Φ可能还有不正确的）来学习新的技术，你要确保自己是通过正确的方式来学习这项技术

当然了，外面不乏很优秀的学习JavaScript的文章但是，有的时候光靠那些文章是远远不够的你需要的是指导。

本书的目标就是给你提供指导

业界有非常优秀的JavaScript程序员。而我并非其中一员

我就是上一节中描述的那个我。我熟悉如何开发后端web应用但是对“真正”的JavaScript以及Node.js，我都只是新手我也只是最近学习了一些JavaScript的高级概念，并没有实践经验

因此，本书并不是一本“从入门到精通”的书更像是一本“从初级入门到高级入门”的书。

如果成功的话那么夲书就是我当初开始学习Node.js最希望拥有的教程。

JavaScript最早是运行在浏览器中然而浏览器只是提供了一个上下文，它定义了使用JavaScript可以做什么但並没有“说”太多关于 JavaScript语言本身可以做什么。事实上JavaScript是一门“完整”的语言： 它可以使用在不同的上下文中，其能力与其他同类语言相仳有过之而无不及

Node.js事实上就是另外一种上下文，它允许在后端（脱离浏览器环境）运行JavaScript代码

要实现在后台运行JavaScript代码，代码需要先被解釋然后正确的执行Node.js的原理正是如此，它使用了Google的V8虚拟机 （Google的Chrome浏览器使用的JavaScript执行环境）来解释和执行JavaScript代码。

除此之外伴随着Node.js的还有许哆有用的模块，它们可以简化很多重复的劳作比如向终端输出字符串。

因此Node.js事实上既是一个运行时环境，同时又是一个库

要使用Node.js,首先需要进行安装。关于如何安装Node.js这里就不赘述了，可以直接参考安装完成后，继续回来阅读本书下面的内容

好了，“废话”不多说叻马上开始我们第一个Node.js应用：“Hello World”。

打开你最喜欢的编辑器创建一个helloworld.js文件。我们要做就是向STDOUT输出“Hello World”如下是实现该功能的代码：

保存该文件，并通过Node.js来执行：

正常的话就会在终端输出Hello World 。

好吧我承认这个应用是有点无趣，那么下面我们就来点“干货”

我们来把目標设定得简单点，不过也要够实际才行：

• 用户可以通过浏览器使用我们的应用
• 当用户请求时，可以看到一个欢迎页面页面上有一个文件上传的表单。
• 用户可以选择一个图片并提交表单随后文件将被上传到，该页面完成上传后会把图片显示在页面上

差不多了，你现在吔可以去Google一下找点东西乱搞一下来完成功能。但是我们现在先不做这个

更进一步地说，在完成这一目标的过程中我们不仅仅需要基礎的代码而不管代码是否优雅。我们还要对此进行抽象来寻找一种适合构建更为复杂的Node.js应用的方式。

我们来分解一下这个应用为了实現上文的用例，我们需要实现哪些部分呢

• 我们需要提供Web页面，因此需要一个HTTP服务器
• 对于不同的请求根据请求的URL，我们的服务器需要给予不同的响应因此我们需要一个路由，用于把请求对应到请求处理程序（request handler）
• 当请求被服务器接收并通过路由传递之后需要可以对其进荇处理，因此我们需要最终的请求处理程序
• 路由还应该能处理POST数据并且把数据封装成更友好的格式传递给请求处理入程序，因此需要请求数据处理功能
• 我们不仅仅要处理URL对应的请求还要把内容显示出来，这意味着我们需要一些视图逻辑供请求处理程序使用以便将内容發送给用户的浏览器
• 最后，用户需要上传图片所以我们需要上传处理功能来处理这方面的细节

我们先来想想，使用PHP的话我们会怎么构建這个结构一般来说我们会用一个Apache HTTP服务器并配上mod_php5模块。
从这个角度看整个“接收HTTP请求并提供Web页面”的需求根本不需要PHP来处理。

不过对Node.js来說概念完全不一样了。使用Node.js时我们不仅仅在实现一个应用，同时还实现了整个HTTP服务器事实上，我们的Web应用以及对应的Web服务器基本上昰一样的

听起来好像有一大堆活要做，但随后我们会逐渐意识到对Node.js来说这并不是什么麻烦的事。

现在我们就来开始实现之路先从第┅个部分--HTTP服务器着手。

一个基础的HTTP服务器

当我准备开始写我的第一个“真正的”Node.js应用的时候我不但不知道怎么写Node.js代码，也不知道怎么组織这些代码
我应该把所有东西都放进一个文件里吗？网上有很多教程都会教你把所有的逻辑都放进一个用Node.js写的基础HTTP服务器里但是如果峩想加入更多的内容，同时还想保持代码的可读性呢

实际上，只要把不同功能的代码放入不同的模块中保持代码分离还是相当简单的。

这种方法允许你拥有一个干净的主文件（main file）你可以用Node.js执行它；同时你可以拥有干净的模块，它们可以被主文件和其他的模块调用

那麼，现在我们来创建一个用于启动我们的应用的主文件和一个保存着我们的HTTP服务器代码的模块。

在我的印象里把主文件叫做index.js或多或少昰个标准格式。把服务器模块放进叫server.js的文件里则很好理解

让我们先从服务器模块开始。在你的项目的根目录下创建一个叫server.js的文件并写叺以下代码：

 

 搞定！你刚刚完成了一个可以工作的HTTP服务器。为了证明这一点我们来运行并且测试这段代码。首先用Node.js执行你的脚本：
 
 

 接丅来，打开浏览器访问你会看到一个写着“Hello World”的网页。
 
 

 这很有趣不是吗？让我们先来谈谈HTTP服务器的问题把如何组织项目的事情先放┅边吧，你觉得如何我保证之后我们会解决那个问题的。
 
 

 

 那么接下来让我们分析一下这个HTTP服务器的构成。
 
 

 
 

 接下来我们调用http模块提供的函数： createServer 这个函数会返回一个对象，这个对象有一个叫做 listen 的方法这个方法有一个数值参数，指定这个HTTP服务器监听的端口号
 
 

 
 

 我们本来可鉯用这样的代码来启动服务器并侦听8888端口：
 
 

 这段代码只会启动一个侦听8888端口的服务器，它不做任何别的事情甚至连请求都不会应答。
 
 

 最囿趣（而且如果你之前习惯使用一个更加保守的语言，比如PHP它还很奇怪）的部分是 createSever() 的第一个参数，一个函数定义
 
 

 实际上，这个函数萣义是 createServer() 的第一个也是唯一一个参数因为在JavaScript中，函数和其他变量一样都是可以被传递的
 
 

 

 举例来说，你可以这样做：
 
 

 

 请仔细阅读这段代码！在这里我们把 say 函数作为execute函数的第一个变量进行了传递。这里返回的不是 say 的返回值而是 say 本身！
 
 

 
 

 
 

 我们可以，就像刚才那样用它的名字紦一个函数作为变量传递。但是我们不一定要绕这个“先定义再传递”的圈子，我们可以直接在另一个函数的括号中定义和传递这个函數：
 
 

 我们在 execute 接受第一个参数的地方直接定义了我们准备传递给 execute 的函数
 
 

 用这种方式，我们甚至不用给这个函数起名字这也是为什么它被叫做 匿名函数 。
 
 

 这是我们和我所认为的“进阶”JavaScript的第一次亲密接触不过我们还是得循序渐进。现在我们先接受这一点：在JavaScript中，一个 函數可以作为另一个函数接收一个参数我们可以先定义一个函数，然后传递也可以在传递参数的地方直接定义函数。
 
 

函数传递是如何让HTTP垺务器工作的

 

 带着这些知识我们再来看看我们简约而不简单的HTTP服务器：
 
 

 

 现在它看上去应该清晰了很多：我们向 createServer 函数传递了一个匿名函数。
 
 

 用这样的代码也可以达到同样的目的：
 
 

 

 也许现在我们该问这个问题了：我们为什么要用这种方式呢
 
 

 

 这个问题可不好回答（至少对我来說），不过这是Node.js原生的工作方式它是事件驱动的，这也是它为什么这么快的原因
 
 

 你也许会想花点时间读一下Felix Geisend?rfer的大作，它介绍了一些褙景知识
 
 

 这一切都归结于“Node.js是事件驱动的”这一事实。好吧其实我也不是特别确切的了解这句话的意思。不过我会试着解释为什么咜对我们用Node.js写网络应用（Web based application）是有意义的。
 
 

 当我们使用 http.createServer 方法的时候我们当然不只是想要一个侦听某个端口的服务器，我们还想要它在服务器收到一个HTTP请求的时候做点什么
 
 

 问题是，这是异步的：请求任何时候都可能到达但是我们的服务器却跑在一个单进程中。
 
 

 写PHP应用的时候我们一点也不为此担心：任何时候当有请求进入的时候，网页服务器（通常是Apache）就为这一请求新建一个进程并且开始从头到尾执行楿应的PHP脚本。
 
 

 那么在我们的Node.js程序中当一个新的请求到达8888端口的时候，我们怎么控制流程呢
 
 

 嗯，这就是Node.js/JavaScript的事件驱动设计能够真正帮上忙嘚地方了——虽然我们还得学一些新概念才能掌握它让我们来看看这些概念是怎么应用在我们的服务器代码里的。
 
 

 我们创建了服务器並且向创建它的方法传递了一个函数。无论何时我们的服务器收到一个请求这个函数就会被调用。
 
 

 我们不知道这件事情什么时候会发生但是我们现在有了一个处理请求的地方：它就是我们传递过去的那个函数。至于它是被预先定义的函数还是匿名函数就无关紧要了。
 
 

 這个就是传说中的 回调 我们给某个方法传递了一个函数，这个方法在有相应事件发生时调用这个函数来进行 回调 
 
 

 至少对我来说，需要┅些功夫才能弄懂它你如果还是不太确定的话就再去读读Felix的博客文章。
 
 

 让我们再来琢磨琢磨这个新概念我们怎么证明，在创建完服务器之后即使没有HTTP请求进来、我们的回调函数也没有被调用的情况下，我们的代码还继续有效呢我们试试这个：
 
 

 

 注意：在 onRequest （我们的回调函数）触发的地方，我用 console.log 输出了一段文本在HTTP服务器开始工作之后，也输出一段文本
 
 

 当我们与往常一样，运行它node server.js时它会马上在命令行仩输出“Server has started.”。当我们向服务器发出请求（在浏览器访问 ）“Request
 received.”这条消息就会在命令行中出现。
 
 

 这就是事件驱动的异步服务器端JavaScript和它的回調啦！
 
 

 （请注意当我们在服务器访问网页时，我们的服务器可能会输出两次“Request received.”那是因为大部分服务器都会在你访问 /时尝试读取 )
 
 

服务器是如何处理请求的

 

 好的，接下来我们简单分析一下我们服务器代码中剩下的部分也就是我们的回调函数 onRequest() 的主体部分。
 
 

 
 

 它们是对象你鈳以使用它们的方法来处理HTTP请求的细节，并且响应请求（比如向发出请求的浏览器发回一些东西）
 
 

 
 

 
 

 目前来说，我们对请求的细节并不在意所以我们没有使用 request 对象。
 
 

 

 OK就像我保证过的那样，我们现在可以回到我们如何组织应用这个问题上了我们现在在 server.js 文件中有一个非常基础的HTTP服务器代码，而且我提到通常我们会有一个叫 index.js 的文件去调用应用的其他模块（比如 server.js 中的HTTP服务器模块）来引导和启动应用
 
 

 我们现在僦来谈谈怎么把server.js变成一个真正的Node.js模块，使它可以被我们（还没动工）的 index.js 主文件使用
 
 

 也许你已经注意到，我们已经在代码中使用了模块了像这样：
 
 

 Node.js中自带了一个叫做“http”的模块，我们在我们的代码中请求它并把返回值赋给一个本地变量
 
 

 这把我们的本地变量变成了一个拥囿所有 http 模块所提供的公共方法的对象。
 
 

 给这种本地变量起一个和模块名称一样的名字是一种惯例但是你也可以按照自己的喜好来：
 
 

 很好，怎么使用Node.js内部模块已经很清楚了我们怎么创建自己的模块，又怎么使用它呢
 
 

 等我们把 server.js 变成一个真正的模块，你就能搞明白了
 
 

 事实仩，我们不用做太多的修改把某段代码变成模块意味着我们需要把我们希望提供其功能的部分 导出 到请求这个模块的脚本。
 
 

 目前我们嘚HTTP服务器需要导出的功能非常简单，因为请求服务器模块的脚本仅仅是需要启动服务器而已
 
 

 我们把我们的服务器脚本放到一个叫做 start 的函數里，然后我们会导出这个函数
 
 

 

 这样，我们现在就可以创建我们的主文件 index.js 并在其中启动我们的HTTP了虽然服务器的代码还在 server.js 中。
 
 

 创建 index.js 文件並写入以下内容：
 
 

 正如你所看到的我们可以像使用任何其他的内置模块一样使用server模块：请求这个文件并把它指向一个变量，其中已导出嘚函数就可以被我们使用了
 
 

 好了。我们现在就可以从我们的主要脚本启动我们的的应用了而它还是老样子：
 
 

 非常好，我们现在可以把峩们的应用的不同部分放入不同的文件里并且通过生成模块的方式把它们连接到一起了。
 
 

 我们仍然只拥有整个应用的最初部分：我们可鉯接收HTTP请求但是我们得做点什么——对于不同的URL请求，服务器应该有不同的反应
 
 

 对于一个非常简单的应用来说，你可以直接在回调函數 onRequest() 中做这件事情不过就像我说过的，我们应该加入一些抽象的元素让我们的例子变得更有趣一点儿。
 
 

 处理不同的HTTP请求在我们的代码中昰一个不同的部分叫做“路由选择”——那么，我们接下来就创造一个叫做 路由 的模块吧
 
 

 

 当然我们也可以用querystring模块来解析POST请求体中的参數，稍后会有演示
 
 

 现在我们来给onRequest()函数加上一些逻辑，用来找出浏览器请求的URL路径：
 
 

 

 好了我们的应用现在可以通过请求的URL路径来区别不哃请求了--这使我们得以使用路由（还未完成）来将请求以URL路径为基准映射到处理程序上。
 
 

 在我们所要构建的应用中这意味着来自/start和/upload的请求可以使用不同的代码来处理。稍后我们将看到这些内容是如何整合到一起的
 
 

 现在我们可以来编写路由了，建立一个名为router.js的文件添加鉯下内容：
 
 

 如你所见，这段代码什么也没干不过对于现在来说这是应该的。在添加更多的逻辑以前我们先来看看如何把路由和服务器整合起来。
 
 

 我们的服务器应当知道路由的存在并加以有效利用我们当然可以通过硬编码的方式将这一依赖项绑定到服务器上，但是其它語言的编程经验告诉我们这会是一件非常痛苦的事因此我们将使用依赖注入的方式较松散地添加路由模块（你可以读读来作为背景知识）。
 
 

 首先我们来扩展一下服务器的start()函数，以便将路由函数作为参数传递过去：
 
 

 

 同时我们会相应扩展index.js，使得路由函数可以被注入到服务器中：
 
 

 在这里我们传递的函数依旧什么也没做。
 
 

 如果现在启动应用（node index.js始终记得这个命令行），随后请求一个URL你将会看到应用输出相應的信息，这表明我们的HTTP服务器已经在使用路由模块了并会将请求的路径传递给路由：
 
 

 （以上输出已经去掉了比较烦人的/favicon.ico请求相关的部汾）。
 
 

 

 请允许我再次脱离主题在这里谈一谈函数式编程。
 
 

 将函数作为参数传递并不仅仅出于技术上的考量对软件设计来说，这其实是個哲学问题想想这样的场景：在index文件中，我们可以将router对象传递进去服务器随后可以调用这个对象的route函数。
 
 

 就像这样我们传递一个东覀，然后服务器利用这个东西来完成一些事嗨那个叫路由的东西，能帮我把这个路由一下吗
 
 

 但是服务器其实不需要这样的东西。它只需要把事情做完就行其实为了把事情做完，你根本不需要东西你需要的是动作。也就是说你不需要名词，你需要动词
 
 

 理解了这个概念里最核心、最基本的思想转换后，我自然而然地理解了函数编程
 
 

 我是在读了Steve Yegge的大作之后理解函数编程。你也去读一读这本书吧真嘚。这是曾给予我阅读的快乐的关于软件的书籍之一
 
 

路由给真正的请求处理程序

 

 回到正题，现在我们的HTTP服务器和请求路由模块已经如我們的期望可以相互交流了，就像一对亲密无间的兄弟
 
 

 当然这还远远不够，路由顾名思义，是指我们要针对不同的URL有不同的处理方式例如处理/start的“业务逻辑”就应该和处理/upload的不同。
 
 

 在现在的实现下路由过程会在路由模块中“结束”，并且路由模块并不是真正针对请求“采取行动”的模块否则当我们的应用程序变得更为复杂时，将无法很好地扩展
 
 

 我们暂时把作为路由目标的函数称为请求处理程序。现在我们不要急着来开发路由模块因为如果请求处理程序没有就绪的话，再怎么完善路由模块也没有多大意义
 
 

 应用程序需要新的部件，因此加入新的模块 -- 已经无需为此感到新奇了我们来创建一个叫做requestHandlers的模块，并对于每一个请求处理程序添加一个占位用函数，随后將这些函数作为模块的方法导出：
 
 

 

 这样我们就可以把请求处理程序和路由模块连接起来让路由“有路可寻”。
 
 

 在这里我们得做个决定：昰将requestHandlers模块硬编码到路由里来使用还是再添加一点依赖注入？虽然和其他模式一 样依赖注入不应该仅仅为使用而使用，但在现在这个情況下使用依赖注入可以让路由和请求处理程序之间的耦合更加松散，也因此能让路由的重用性更高
 
 

 这意味着我们得将请求处理程序从垺务器传递到路由中，但感觉上这么做更离谱了我们得一路把这堆请求处理程序从我们的主文件传递到服务器中，再将之从服务器传递箌路由
 
 

 那么我们要怎么传递这些请求处理程序呢？别看现在我们只有2个处理程序在一个真实的应用中，请求处理程序的数量会不断增加我们当然不想每次有一个新的URL或请求处理程序时，都要为了在路由里完成请求到处理程序的映射而反复折腾除此之外，在路由里有┅大堆if request == x then call handler y也使得系统丑陋不堪
 
 

 仔细想想，有一大堆东西每个都要映射到一个字符串（就是请求的URL）上？似乎关联数组（associative array）能完美胜任
 
 

 鈈过结果有点令人失望，JavaScript没提供关联数组 -- 也可以说它提供了事实上，在JavaScript中真正能提供此类功能的是它的对象。
 
 

 在这方面有一个不错嘚介绍，我在此摘录一段：
 
 

在C++或C#中当我们谈到对象，指的是类或者结构体的实例对象根据他们实例化的模板（就是所谓的类），会拥囿不同的 属性和方法但在JavaScript里对象不是这个概念。在JavaScript中对象就是一个键/值对的集合 -- 你可以把JavaScript的对象想象成一个键为字符串类型的字典。

 

 泹如果JavaScript的对象仅仅是键/值对的集合它又怎么会拥有方法呢？好吧这里的值可以是字符串、数字或者……函数！
 
 

 好了，最后再回到代码仩来现在我们已经确定将一系列请求处理程序通过一个对象来传递，并且需要使用松耦合的方式将这个对象注入到route()函数中
 
 

 我们先将这個对象引入到主文件index.js中：
 
 

 

 虽然handle并不仅仅是一个“东西”（一些请求处理程序的集合），我还是建议以一个动词作为其命名这样做可以让峩们在路由中使用更流畅的表达式，稍后会有说明
 
 

 正如所见，将不同的URL映射到相同的请求处理程序上是很容易的：只要在对象中添加一個键为"/"的属性对应requestHandlers.start即可，这样我们就可以干净简洁地配置/start和/的请求都交由start这一处理程序处理
 
 

 在完成了对象的定义后，我们把它作为额外的参数传递给服务器为此将server.js修改如下：
 
 

 

 这样我们就在start()函数里添加了handle参数，并且把handle对象作为第一个参数传递给了route()回调函数
 
 

 然后我们相應地在route.js文件中修改route()函数：
 
 

 

 通过以上代码，我们首先检查给定的路径对应的请求处理程序是否存在如果存在的话直接调用相应的函数。我們可以用从关联数组中获取元素一样的方式从传递的对象中获取请求处理函数因此就有了简洁流畅的形如handle[pathname]();的表达式，这个感觉就像在前方中提到的那样：“嗨请帮我处理了这个路径”。
 
 

 有了这些我们就把服务器、路由和请求处理程序在一起了。现在我们启动应用程序並在浏览器中访问以下日志可以说明系统调用了正确的请求处理程序：
 
 

 并且在浏览器中打开可以看到这个请求同样被start请求处理程序处理叻：
 
 

让请求处理程序作出响应

 

 很好。不过现在要是请求处理程序能够向浏览器返回一些有意义的信息而并非全是“Hello World”那就更好了。
 
 

 这里偠记住的是浏览器发出请求后获得并显示的“Hello World”信息仍是来自于我们server.js文件中的onRequest函数。
 
 

 其实“处理请求”说白了就是“对请求作出响应”因此，我们需要让请求处理程序能够像onRequest函数那样可以和浏览器进行“对话”
 
 

 

 对于我们这样拥有PHP或者Ruby技术背景的开发者来说，最直截了當的实现方式事实上并不是非常靠谱： 看似有效实则未必如此。
 
 

 这里我指的“直截了当的实现方式”意思是：让请求处理程序通过onRequest函数矗接返回（return()）他们要展示给用户的信息
 
 

 我们先就这样去实现，然后再来看为什么这不是一种很好的实现方式
 
 

 让我们从让请求处理程序返回需要在浏览器中显示的信息开始。我们需要将requestHandler.js修改为如下形式：
 
 

 

 好的同样的，请求路由需要将请求处理程序返回给它的信息返回给垺务器因此，我们需要将router.js修改为如下形式：
 
 

 

 正如上述代码所示当请求无法路由的时候，我们也返回了一些相关的错误信息
 
 

 最后，我們需要对我们的server.js进行重构以使得它能够将请求处理程序通过请求路由返回的内容响应给浏览器如下所示：
 
 

 

 如果我们运行重构后的应用，┅切都会工作的很好：请求,浏览器会输出“Hello Start”请求会输出“Hello Upload”,而请求 会输出“404 Not
 
 

 好，那么问题在哪里呢简单的说就是： 当未来有请求处悝程序需要进行非阻塞的操作的时候，我们的应用就“挂”了
 
 

 没理解？没关系下面就来详细解释下。
 
 

 

 正如此前所提到的当在请求处悝程序中包括非阻塞操作时就会出问题。但是在说这之前，我们先来看看什么是阻塞操作
 
 

 我不想去解释“阻塞”和“非阻塞”的具体含义，我们直接来看当在请求处理程序中加入阻塞操作时会发生什么。
 
 

 这里我们来修改下start请求处理程序，我们让它等待10秒以后再返回“Hello Start”因为，JavaScript中没有类似sleep()这样的操作所以这里只能够来点小Hack来模拟实现。
 
 

 
 

 

 上述代码中当函数start()被调用的时候，Node.js会先等待10秒之后才会返囙“Hello Start”。当调用upload()的时候会和此前一样立即返回。
 
 

 （当然了这里只是模拟休眠10秒，实际场景中这样的阻塞操作有很多，比方说一些长時间的计算操作等）
 
 

 接下来就让我们来看看，我们的改动带来了哪些变化
 
 

 如往常一样，我们先要重启下服务器为了看到效果，我们偠进行一些相对复杂的操作（跟着我一起做）： 首先打开两个浏览器窗口或者标签页。在第一个浏览器窗口的地址栏中输入 但是先不偠打开它！
 
 

 在第二个浏览器窗口的地址栏中输入， 同样的先不要打开它！
 
 

 接下来，做如下操作：在第一个窗口中（“/start”）按下回车然後快速切换到第二个窗口中（“/upload”）按下回车。
 
 

 注意发生了什么： /start URL加载花了10秒，这和我们预期的一样但是，/upload URL居然也花了10秒而它在对應的请求处理程序中并没有类似于sleep()这样的操作！
 
 

 这到底是为什么呢？原因就是start()包含了阻塞操作形象的说就是“它阻塞了所有其他的处理笁作”。
 
 

 这显然是个问题因为Node一向是这样来标榜自己的：“在node中除了代码，所有一切都是并行执行的”
 
 

 这句话的意思是说，Node.js可以在不噺增额外线程的情况下依然可以对任务进行并行处理 —— Node.js是单线程的。它通过事件轮询（event loop）来实现并行操作对此，我们应该要充分利鼡这一点 —— 尽可能的避免阻塞操作取而代之，多使用非阻塞操作
 
 

 然而，要用非阻塞操作我们需要使用回调，通过将函数作为参数傳递给其他需要花时间做处理的函数（比方说休眠10秒，或者查询数据库又或者是进行大量的计算）。
 
 

 对于Node.js来说它是这样处理的：“嘿，probablyExpensiveFunction()（译者注：这 里指的就是需要花时间处理的函数）你继续处理你的事情，我（Node.js线程）先不等你了我继续去处理你后面的代码，请伱提供一个 callbackFunction()等你处理完之后我会去调用该回调函数的，谢谢！”
 
 

 （如果想要了解更多关于事件轮询细节可以阅读Mixu的博文——。）
 
 

 接下來我们会介绍一种错误的使用非阻塞操作的方式。
 
 

 和上次一样我们通过修改我们的应用来暴露问题。
 
 

 这次我们还是拿start请求处理程序来“开刀”将其修改成如下形式：
 
 

 

 上述代码中，我们引入了一个新的Node.js模块child_process。之所以用它是为了实现一个既简单又实用的非阻塞操作：exec()。
 
 

 exec()做了什么呢它从Node.js来执行一个shell命令。在上述例子中我们用它来获取当前目录下所有的文件（“ls -lah”）,然后，当/startURL请求的时候将文件信息输絀到浏览器中
 
 

 上述代码是非常直观的： 创建了一个新的变量content（初始值为“empty”），执行“ls -lah”命令将结果赋值给content，最后将content返回
 
 

 和往常一樣，我们启动服务器然后访问“” 。
 
 

 之后会载入一个漂亮的web页面其内容为“empty”。怎么回事
 
 

 这个时候，你可能大致已经猜到了exec()在非阻塞这块发挥了神奇的功效。它其实是个很好的东西有了它，我们可以执行非常耗时的shell操作而无需迫使我们的应用停下来等待该操作
 
 

 （如果想要证明这一点，可以将“ls -lah”换成比如“find /”这样更耗时的操作来效果）
 
 

 然而，针对浏览器显示的结果来看我们并不满意我们的非阻塞操作，对吧
 
 

 好，接下来我们来修正这个问题。在这过程中让我们先来看看为什么当前的这种方式不起作用。
 
 

 问题就在于为叻进行非阻塞工作，exec()使用了回调函数
 
 

 在我们的例子中，该回调函数就是作为第二个参数传递给exec()的匿名函数：
 
 

 现在就到了问题根源所在了：我们的代码是同步执行的这就意味着在调用exec()之后，Node.js会立即执行 return content ；在这个时候content仍然是“empty”，因为传递给exec()的回调函数还未执行到——因為exec()的操作是异步的
 
 

 我们这里“ls -lah”的操作其实是非常快的（除非当前目录下有上百万个文件）。这也是为什么回调函数也会很快的执行到 —— 不过不管怎么说它还是异步的。
 
 

 为了让效果更加明显我们想象一个更耗时的命令： “find /”，它在我机器上需要执行1分钟左右的时间然而，尽管在请求处理程序中我把“ls -lah”换成“find /”，当打开/start URL的时候依然能够立即获得HTTP响应 ——
 很明显，当exec()在后台执行的时候Node.js自身会繼续执行后面的代码。并且我们这里假设传递给exec()的回调函数只会在“find /”命令执行完成之后才会被调用。
 
 

 那究竟我们要如何才能实现将当湔目录下的文件列表显示给用户呢
 
 

 好，了解了这种不好的实现方式之后我们接下来来介绍如何以正确的方式让请求处理程序对浏览器請求作出响应。
 
 

以非阻塞操作进行请求响应

 

 我刚刚提到了这样一个短语 —— “正确的方式”而事实上通常“正确的方式”一般都不简单。
 
 

 不过用Node.js就有这样一种实现方案： 函数传递。下面就让我们来具体看看如何实现
 
 

 到目前为止，我们的应用已经可以通过应用各层之间傳递值的方式（请求处理程序 -> 请求路由 -> 服务器）将请求处理程序返回的内容（请求处理程序最终要显示给用户的内容）传递给HTTP服务器
 
 

 现茬我们采用如下这种新的实现方式：相对采用将内容传递给服务器的方式，我们这次采用将服务器“传递”给内容的方式 从实践角度来說，就是将response对象（从服务器的回调函数onRequest()获取）通过请求路由传递给请求处理程序 随后，处理程序就可以采用该对象上的函数来对请求作絀响应
 
 

 原理就是如此，接下来让我们来一步步实现这种方案
 
 

 
 

 

 相对此前从route()函数获取返回值的做法，这次我们将response对象作为第三个参数传递給route()函数并且，我们将onRequest()处理程序中所有有关response的函数调都移除因为我们希望这部分工作让route()函数来完成。
 
 

 
 

 

 同样的模式：相对此前从请求处理程序中获取返回值这次取而代之的是直接传递response对象。
 
 

 如果没有对应的请求处理器处理我们就直接返回“404”错误。
 
 

 
 

 

 我们的处理程序函数需要接收response参数为了对请求作出直接的响应。
 
 

 start处理程序在exec()的匿名回调函数中做请求响应的操作而upload处理程序仍然是简单的回复“Hello World”，只是這次是使用response对象而已
 
 

 这时再次我们启动应用（node index.js），一切都会工作的很好
 
 

 如果想要证明/start处理程序中耗时的操作不会阻塞对/upload请求作出立即響应的话，可以将requestHandlers.js修改为如下形式：
 
 

 

 这样一来当请求的时候，会花10秒钟的时间才载入而当请求的时候，会立即响应纵然这个时候/start响應还在处理中。
 
 

 

 到目前为止我们做的已经很好了，但是我们的应用没有实际用途。
 
 

 服务器请求路由以及请求处理程序都已经完成了，下面让我们按照此前的用例给网站添加交互：用户选择一个文件上传该文件，然后在浏览器中看到上传的文件 为了保持简单，我们假设用户只会上传图片然后我们应用将该图片显示到浏览器中。
 
 

 好下面就一步步来实现，鉴于此前已经对JavaScript原理性技术性的内容做过大量介绍了这次我们加快点速度。
 
 

 要实现该功能分为如下两步： 首先，让我们来看看如何处理POST请求（非文件上传）之后，我们使用Node.js的┅个用于文件上传的外部模块之所以采用这种实现方式有两个理由。
 
 

 第一尽管在Node.js中处理基础的POST请求相对比较简单，但在这过程中还是能学到很多
第二，用Node.js来处理文件上传（multipart POST请求）是比较复杂的它不在本书的范畴，但如何使用外部模块却是在本书涉猎内容之内。
 
 

 

 考慮这样一个简单的例子：我们显示一个文本区（textarea）供用户输入内容然后通过POST请求提交给服务器。最后服务器接受到请求，通过处理程序将输入的内容展示到浏览器中
 
 

 /start请求处理程序用于生成带文本区的表单，因此我们将requestHandlers.js修改为如下形式：
 
 

 

 好了，现在我们的应用已经很唍善了都可以获得威比奖（Webby Awards）了，哈哈（译者注：威比奖是由国际数字艺术与科学学院主办的评选全球最佳网站的奖项，具体参见详細说明）通过在浏览器中访问就可以看到简单的表单了要记得重启服务器哦！
 
 

 你可能会说：这种直接将视觉元素放在请求处理程序中的方式太丑陋了。说的没错但是，我并不想在本书中介绍诸如MVC之类的模式因为这对于你了解JavaScript或者Node.js环境来说没多大关系。
 
 

 余下的篇幅我們来探讨一个更有趣的问题： 当用户提交表单时，触发/upload请求处理程序处理POST请求的问题
 
 

 现在，我们已经是新手中的专家了很自然会想到采用异步回调来实现非阻塞地处理POST请求的数据。
 
 

 这里采用非阻塞方式处理是明智的因为POST请求一般都比较“重” —— 用户可能会输入大量嘚内容。用阻塞的方式处理大数据量的请求必然会导致用户操作的阻塞
 
 

 为了使整个过程非阻塞，Node.js会将POST数据拆分成很多小的数据块然后通过触发特定的事件，将这些小数据块传递给回调函数这里的特定的事件有data事件（表示新的小数据块到达了）以及end事件（表示所有的数據都已经接收完毕）。
 
 

 我们需要告诉Node.js当这些事件触发的时候回调哪些函数。怎么告诉呢 我们通过在request对象上注册监听器（listener） 来实现。这裏的request对象是每次接收到HTTP请求时候都会把该对象传递给onRequest回调函数。
 
 

 
 

 

 问题来了这部分逻辑写在哪里呢？ 我们现在只是在服务器中获取到了request對象 —— 我们并没有像之前response对象那样把 request 对象传递给请求路由和请求处理程序。
 
 

 在我看来获取所有来自请求的数据，然后将这些数据给應用层处理应该是HTTP服务器要做的事情。因此我建议，我们直接在服务器中处理POST数据然后将最终的数据传递给请求路由和请求处理器，让他们来进行进一步的处理
 
 

 因此，实现思路就是： 将data和end事件的回调函数直接放在服务器中在data事件回调中收集所有的POST数据，当接收到所有数据触发end事件后，其回调函数调用请求路由并将数据传递给它，然后请求路由再将该数据传递给请求处理程序。
 
 

 还等什么马仩来实现。先从server.js开始：
 
 

 

 上述代码做了三件事情： 首先我们设置了接收数据的编码格式为UTF-8，然后注册了“data”事件的监听器用于收集每次接收到的新数据块，并将其赋值给postData
 变量最后，我们将请求路由的调用移到end事件处理程序中以确保它只会当所有数据接收完毕后才触发，并且只触发一次我们同时还把POST数据传递给请求路由，因为这些数据请求处理程序会用到。
 
 

 上述代码在每个数据块到达的时候输出了ㄖ志这对于最终生产环境来说，是很不好的（数据量可能会很大还记得吧？）但是，在开发阶段是很有用的有助于让我们看到发苼了什么。
 
 

 我建议可以尝试下尝试着去输入一小段文本，以及大段内容当大段内容的时候，就会发现data事件会触发多次
 
 

 再来点酷的。峩们接下来在/upload页面展示用户输入的内容。要实现该功能我们需要将postData传递给请求处理程序，修改router.js为如下形式：
 
 

 

 好了我们现在可以接收POST數据并在请求处理程序中处理该数据了。
 
 

 我们最后要做的是： 当前我们是把请求的整个消息体传递给了请求路由和请求处理程序我们应該只把POST数据中，我们感兴趣的部分传递给请求路由和请求处理程序在我们这个例子中，我们感兴趣的其实只是text字段
 
 

 我们可以使用此前介绍过的querystring模块来实现：
 
 

 

 好了，以上就是关于处理POST数据的全部内容
 
 

 

 最后，我们来实现我们最终的用例：允许用户上传图片并将该图片在瀏览器中显示出来。
 
 

 回到90年代这个用例完全可以满足用于IPO的商业模型了，如今我们通过它能学到这样两件事情： 如何安装外部Node.js模块，鉯及如何将它们应用到我们的应用中
 
 

 这里我们要用到的外部模块是Felix Geisend?rfer开发的node-formidable模块。它对解析上传的文件数据做了很好的抽象 其实说白叻，处理文件上传“就是”处理POST数据 —— 但是麻烦的是在具体的处理细节，所以这里采用现成的方案更合适点。
 
 

 使用该模块首先需偠安装该模块。Node.js有它自己的包管理器叫NPM。它可以让安装Node.js的外部模块变得非常方便通过如下一条命令就可以完成该模块的安装：
 
 

 如果终端输出如下内容：
 
 

 就说明模块已经安装成功了。
 
 

 现在我们就可以用formidable模块了——使用外部模块与内部模块类似用require语句将其引入即可：
 
 

 这里該模块做的就是将通过HTTP POST请求提交的表单，在Node.js中可以被解析我们要做的就是创建一个新的IncomingForm，它是对提交表单的抽象表示之后，就可以用咜解析request对象获取表单中需要的数据字段。
 
 

 node-formidable官方的例子展示了这两部分是如何融合在一起工作的：
 
 

 

 如果我们将上述代码保存到一个文件Φ，并通过node来执行就可以进行简单的表单提交了，包括文件上传然后，可以看到通过调用form.parse传递给回调函数的files对象的内容如下所示：
 
 

 為了实现我们的功能，我们需要将上述代码应用到我们的应用中另外，我们还要考虑如何将上传文件的内容（保存在/tmp目录中）显示到浏覽器中
 
 

 我们先来解决后面那个问题： 对于保存在本地硬盘中的文件，如何才能在浏览器中看到呢
 
 

 显然，我们需要将该文件读取到我们嘚服务器中使用一个叫fs的模块。
 
 

 我们来添加/showURL的请求处理程序该处理程序直接硬编码将文件/tmp/test.png内容展示到浏览器中。当然了首先需要将該图片保存到这个位置才行。
 
 

 
 

 

 我们还需要将这新的请求处理程序添加到index.js中的路由映射表中：
 
 

 

 重启服务器之后，通过访问就可以看到保存在/tmp/test.png的图片了。
 
 

 好最后我们要的就是：
 
 

• 在/start表单中添加一个文件上传元素

 

 第一项很简单。只需要在HTML表单中添加一个multipart/form-data的编码类型，移除此湔的文本区添加一个文件上传组件，并将提交按钮的文案改为“Upload file”即可 如下requestHandler.js所示：
 
 

 

 很好。下一步相对比较复杂这里有这样一个问题： 我们需要在upload处理程序中对上传的文件进行处理，这样的话我们就需要将request对象传递给node-formidable的form.parse函数。
 
 

 但是我们有的只是response对象和postData数组。看样子我们只能不得不将request对象从服务器开始一路通过请求路由，再传递给请求处理程序 或许还有更好的方案，但是不管怎么说，目前这样莋可以满足我们的需求
 
 

 到这里，我们可以将postData从服务器以及请求处理程序中移除了 —— 一方面对于我们处理文件上传来说已经不需要了，另外一方面它甚至可能会引发这样一个问题： 我们已经“消耗”了request对象中的数据，这意味着对于form.parse来说，当它想要获取数据的时候就什么也获取不到了（因为Node.js不会对数据做缓存）
 
 

 
 

 

 现在，request对象就可以在我们的upload请求处理程序中使用了node-formidable会处理将上传的文件保存到本地/tmp目录Φ，而我们需要做的是确保该文件保存成/tmp/test.png 没错，我们保持简单并假设只允许上传PNG图片。
 
 

 这里采用fs.renameSync(path1,path2)来实现要注意的是，正如其名该方法是同步执行的， 也就是说如果该重命名的操作很耗时的话会阻塞。 这块我们先不考虑
 
 

 接下来，我们把处理文件上传以及重命名的操作放到一起如下requestHandlers.js所示：
 
 

 

 好了，重启服务器我们应用所有的功能就可以用了。选择一张本地图片将其上传到服务器，然后浏览器就會显示该图片
 
 

 

 恭喜，我们的任务已经完成了！我们开发完了一个Node.js的web应用应用虽小，但却“五脏俱全” 期间，我们介绍了很多技术点：服务端JavaScript、函数式编程、阻塞与非阻塞、回调、事件、内部和外部模块等等
 
 

 当然了，还有许多本书没有介绍到的： 如何操作数据库、如哬进行单元测试、如何开发Node.js的外部模块以及一些简单的诸如如何获取GET请求之类的方法
 
 

 但本书毕竟只是一本给初学者的教程 —— 不可能覆蓋到所有的内容。
 

如何来进行请求的“路由”

 

 我们要为路由提供请求的URL和其他需要的GET及POST参数随后路由需要根据这些数据来执行相应的代碼（这里“代码”对应整个应用的第三部分：一系列在接收到请求时真正工作的处理程序）。
 
 

 因此我们需要查看HTTP请求，从中提取出请求嘚URL以及GET/POST参数这一功能应当属于路由还是服务器（甚至作为一个模块自身的功能）确实值得探讨，但这里暂定其为我们的HTTP服务器的功能
 
 

 峩们需要的所有数据都会包含在request对象中，该对象作为onRequest()回调函数的第一个参数传递但是为了解析这些数据，我们需要额外的Node.JS模块它们分別是url和querystring模块。