欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

node.js入門教程迷你書、node.js入門web應(yīng)用開發(fā)完全示例

 更新時間:2014年04月06日 22:53:11   作者:  
本書致力于教會你如何用Node.js來開發(fā)應(yīng)用,過程中會傳授你所有所需的“高級”JavaScript知識。本書絕不是一本“Hello World”的教程。

本書狀態(tài)

你正在閱讀的已經(jīng)是本書的最終版。因此,只有當(dāng)進(jìn)行錯誤更正以及針對新版本Node.js的改動進(jìn)行對應(yīng)的修正時,才會進(jìn)行更新。

本書中的代碼案例都在Node.js 0.6.11版本中測試過,可以正確工作。

讀者對象

本書最適合與我有相似技術(shù)背景的讀者: 至少對一門諸如Ruby、Python、PHP或者Java這樣面向?qū)ο蟮恼Z言有一定的經(jīng)驗;對JavaScript處于初學(xué)階段,并且完全是一個Node.js的新手。

這里指的適合對其他編程語言有一定經(jīng)驗的開發(fā)者,意思是說,本書不會對諸如數(shù)據(jù)類型、變量、控制結(jié)構(gòu)等等之類非?;A(chǔ)的概念作介紹。要讀懂本書,這些基礎(chǔ)的概念我都默認(rèn)你已經(jīng)會了。

然而,本書還是會對JavaScript中的函數(shù)和對象作詳細(xì)介紹,因為它們與其他同類編程語言中的函數(shù)和對象有很大的不同。

本書結(jié)構(gòu)

讀完本書之后,你將完成一個完整的web應(yīng)用,該應(yīng)用允許用戶瀏覽頁面以及上傳文件。

當(dāng)然了,應(yīng)用本身并沒有什么了不起的,相比為了實現(xiàn)該功能書寫的代碼本身,我們更關(guān)注的是如何創(chuàng)建一個框架來對我們應(yīng)用的不同模塊進(jìn)行干凈地剝離。 是不是很玄乎?稍后你就明白了。

本書先從介紹在Node.js環(huán)境中進(jìn)行JavaScript開發(fā)和在瀏覽器環(huán)境中進(jìn)行JavaScript開發(fā)的差異開始。

緊接著,會帶領(lǐng)大家完成一個最傳統(tǒng)的“Hello World”應(yīng)用,這也是最基礎(chǔ)的Node.js應(yīng)用。

最后,會和大家討論如何設(shè)計一個“真正”完整的應(yīng)用,剖析要完成該應(yīng)用需要實現(xiàn)的不同模塊,并一步一步介紹如何來實現(xiàn)這些模塊。

可以確保的是,在這過程中,大家會學(xué)到JavaScript中一些高級的概念、如何使用它們以及為什么使用這些概念就可以實現(xiàn)而其他編程語言中同類的概念就無法實現(xiàn)。

該應(yīng)用所有的源代碼都可以通過 本書Github代碼倉庫:https://github.com/ManuelKiessling/NodeBeginnerBook/tree/master/code/application.

JavaScript與Node.js

JavaScript與你

拋開技術(shù),我們先來聊聊你以及你和JavaScript的關(guān)系。本章的主要目的是想讓你看看,對你而言是否有必要繼續(xù)閱讀后續(xù)章節(jié)的內(nèi)容。

如果你和我一樣,那么你很早就開始利用HTML進(jìn)行“開發(fā)”,正因如此,你接觸到了這個叫JavaScript有趣的東西,而對于JavaScript,你只會基本的操作——為web頁面添加交互。

而你真正想要的是“干貨”,你想要知道如何構(gòu)建復(fù)雜的web站點 —— 于是,你學(xué)習(xí)了一種諸如PHP、Ruby、Java這樣的編程語言,并開始書寫“后端”代碼。

與此同時,你還始終關(guān)注著JavaScript,隨著通過一些對jQuery,Prototype之類技術(shù)的介紹,你慢慢了解到了很多JavaScript中的進(jìn)階技能,同時也感受到了JavaScript絕非僅僅是window.open() 那么簡單。 .

不過,這些畢竟都是前端技術(shù),盡管當(dāng)想要增強頁面的時候,使用jQuery總讓你覺得很爽,但到最后,你頂多是個JavaScript用戶,而非JavaScript開發(fā)者。

然后,出現(xiàn)了Node.js,服務(wù)端的JavaScript,這有多酷啊?

于是,你覺得是時候該重新拾起既熟悉又陌生的JavaScript了。但是別急,寫Node.js應(yīng)用是一件事情;理解為什么它們要以它們書寫的這種方式來書寫則意味著——你要懂JavaScript。這次是玩真的了。

問題來了: 由于JavaScript真正意義上以兩種,甚至可以說是三種形態(tài)存在(從中世紀(jì)90年代的作為對DHTML進(jìn)行增強的小玩具,到像jQuery那樣嚴(yán)格意義上的前端技術(shù),一直到現(xiàn)在的服務(wù)端技術(shù)),因此,很難找到一個“正確”的方式來學(xué)習(xí)JavaScript,使得讓你書寫Node.js應(yīng)用的時候感覺自己是在真正開發(fā)它而不僅僅是使用它。

因為這就是關(guān)鍵: 你本身已經(jīng)是個有經(jīng)驗的開發(fā)者,你不想通過到處尋找各種解決方案(其中可能還有不正確的)來學(xué)習(xí)新的技術(shù),你要確保自己是通過正確的方式來學(xué)習(xí)這項技術(shù)。

當(dāng)然了,外面不乏很優(yōu)秀的學(xué)習(xí)JavaScript的文章。但是,有的時候光靠那些文章是遠(yuǎn)遠(yuǎn)不夠的。你需要的是指導(dǎo)。

本書的目標(biāo)就是給你提供指導(dǎo)。

簡短申明

業(yè)界有非常優(yōu)秀的JavaScript程序員。而我并非其中一員。

我就是上一節(jié)中描述的那個我。我熟悉如何開發(fā)后端web應(yīng)用,但是對“真正”的JavaScript以及Node.js,我都只是新手。我也只是最近學(xué)習(xí)了一些JavaScript的高級概念,并沒有實踐經(jīng)驗。

因此,本書并不是一本“從入門到精通”的書,更像是一本“從初級入門到高級入門”的書。

如果成功的話,那么本書就是我當(dāng)初開始學(xué)習(xí)Node.js最希望擁有的教程。

服務(wù)端JavaScript

JavaScript最早是運行在瀏覽器中,然而瀏覽器只是提供了一個上下文,它定義了使用JavaScript可以做什么,但并沒有“說”太多關(guān)于JavaScript語言本身可以做什么。事實上,JavaScript是一門“完整”的語言: 它可以使用在不同的上下文中,其能力與其他同類語言相比有過之而無不及。

Node.js事實上就是另外一種上下文,它允許在后端(脫離瀏覽器環(huán)境)運行JavaScript代碼。

要實現(xiàn)在后臺運行JavaScript代碼,代碼需要先被解釋然后正確的執(zhí)行。Node.js的原理正是如此,它使用了Google的V8虛擬機(Google的Chrome瀏覽器使用的JavaScript執(zhí)行環(huán)境),來解釋和執(zhí)行JavaScript代碼。

除此之外,伴隨著Node.js的還有許多有用的模塊,它們可以簡化很多重復(fù)的勞作,比如向終端輸出字符串。

因此,Node.js事實上既是一個運行時環(huán)境,同時又是一個庫。

要使用Node.js,首先需要進(jìn)行安裝。關(guān)于如何安裝Node.js,這里就不贅述了,可以直接參考官方的安裝指南。安裝完成后,繼續(xù)回來閱讀本書下面的內(nèi)容。

“Hello World”

好了,“廢話”不多說了,馬上開始我們第一個Node.js應(yīng)用:“Hello World”。

打開你最喜歡的編輯器,創(chuàng)建一個helloworld.js文件。我們要做就是向STDOUT輸出“Hello World”,如下是實現(xiàn)該功能的代碼:

復(fù)制代碼 代碼如下:
console.log("Hello World");

保存該文件,并通過Node.js來執(zhí)行:

復(fù)制代碼 代碼如下:
node helloworld.js

正常的話,就會在終端輸出Hello World 。

好吧,我承認(rèn)這個應(yīng)用是有點無趣,那么下面我們就來點“干貨”。

一個完整的基于Node.js的web應(yīng)用

用例

我們來把目標(biāo)設(shè)定得簡單點,不過也要夠?qū)嶋H才行:

1.用戶可以通過瀏覽器使用我們的應(yīng)用。
2.當(dāng)用戶請求http://domain/start時,可以看到一個歡迎頁面,頁面上有一個文件上傳的表單。
3.用戶可以選擇一個圖片并提交表單,隨后文件將被上傳到http://domain/upload,該頁面完成上傳后會把圖片顯示在頁面上。
差不多了,你現(xiàn)在也可以去Google一下,找點東西亂搞一下來完成功能。但是我們現(xiàn)在先不做這個。

更進(jìn)一步地說,在完成這一目標(biāo)的過程中,我們不僅僅需要基礎(chǔ)的代碼而不管代碼是否優(yōu)雅。我們還要對此進(jìn)行抽象,來尋找一種適合構(gòu)建更為復(fù)雜的Node.js應(yīng)用的方式。

應(yīng)用不同模塊分析

我們來分解一下這個應(yīng)用,為了實現(xiàn)上文的用例,我們需要實現(xiàn)哪些部分呢?

1.我們需要提供Web頁面,因此需要一個HTTP服務(wù)器
2.對于不同的請求,根據(jù)請求的URL,我們的服務(wù)器需要給予不同的響應(yīng),因此我們需要一個路由,用于把請求對應(yīng)到請求處理程序(request handler)
3.當(dāng)請求被服務(wù)器接收并通過路由傳遞之后,需要可以對其進(jìn)行處理,因此我們需要最終的請求處理程序
4.路由還應(yīng)該能處理POST數(shù)據(jù),并且把數(shù)據(jù)封裝成更友好的格式傳遞給請求處理入程序,因此需要請求數(shù)據(jù)處理功能
5.我們不僅僅要處理URL對應(yīng)的請求,還要把內(nèi)容顯示出來,這意味著我們需要一些視圖邏輯供請求處理程序使用,以便將內(nèi)容發(fā)送給用戶的瀏覽器
6.最后,用戶需要上傳圖片,所以我們需要上傳處理功能來處理這方面的細(xì)節(jié)
我們先來想想,使用PHP的話我們會怎么構(gòu)建這個結(jié)構(gòu)。一般來說我們會用一個Apache HTTP服務(wù)器并配上mod_php5模塊。
從這個角度看,整個“接收HTTP請求并提供Web頁面”的需求根本不需要PHP來處理。

不過對Node.js來說,概念完全不一樣了。使用Node.js時,我們不僅僅在實現(xiàn)一個應(yīng)用,同時還實現(xiàn)了整個HTTP服務(wù)器。事實上,我們的Web應(yīng)用以及對應(yīng)的Web服務(wù)器基本上是一樣的。

聽起來好像有一大堆活要做,但隨后我們會逐漸意識到,對Node.js來說這并不是什么麻煩的事。

現(xiàn)在我們就來開始實現(xiàn)之路,先從第一個部分--HTTP服務(wù)器著手。

構(gòu)建應(yīng)用的模塊

一個基礎(chǔ)的HTTP服務(wù)器

當(dāng)我準(zhǔn)備開始寫我的第一個“真正的”Node.js應(yīng)用的時候,我不但不知道怎么寫Node.js代碼,也不知道怎么組織這些代碼。
我應(yīng)該把所有東西都放進(jìn)一個文件里嗎?網(wǎng)上有很多教程都會教你把所有的邏輯都放進(jìn)一個用Node.js寫的基礎(chǔ)HTTP服務(wù)器里。但是如果我想加入更多的內(nèi)容,同時還想保持代碼的可讀性呢?

實際上,只要把不同功能的代碼放入不同的模塊中,保持代碼分離還是相當(dāng)簡單的。

這種方法允許你擁有一個干凈的主文件(main file),你可以用Node.js執(zhí)行它;同時你可以擁有干凈的模塊,它們可以被主文件和其他的模塊調(diào)用。

那么,現(xiàn)在我們來創(chuàng)建一個用于啟動我們的應(yīng)用的主文件,和一個保存著我們的HTTP服務(wù)器代碼的模塊。

在我的印象里,把主文件叫做index.js或多或少是個標(biāo)準(zhǔn)格式。把服務(wù)器模塊放進(jìn)叫server.js的文件里則很好理解。

讓我們先從服務(wù)器模塊開始。在你的項目的根目錄下創(chuàng)建一個叫server.js的文件,并寫入以下代碼:

復(fù)制代碼 代碼如下:

var http = require("http");

http.createServer(function(request, response) {
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.write("Hello World");
  response.end();
}).listen(8888);


搞定!你剛剛完成了一個可以工作的HTTP服務(wù)器。為了證明這一點,我們來運行并且測試這段代碼。首先,用Node.js執(zhí)行你的腳本:

node server.js
接下來,打開瀏覽器訪問http://localhost:8888/,你會看到一個寫著“Hello World”的網(wǎng)頁。

這很有趣,不是嗎?讓我們先來談?wù)凥TTP服務(wù)器的問題,把如何組織項目的事情先放一邊吧,你覺得如何?我保證之后我們會解決那個問題的。

分析HTTP服務(wù)器

那么接下來,讓我們分析一下這個HTTP服務(wù)器的構(gòu)成。

第一行請求(require)Node.js自帶的 http 模塊,并且把它賦值給 http 變量。

接下來我們調(diào)用http模塊提供的函數(shù): createServer 。這個函數(shù)會返回一個對象,這個對象有一個叫做 listen 的方法,這個方法有一個數(shù)值參數(shù),指定這個HTTP服務(wù)器監(jiān)聽的端口號。

咱們暫時先不管 http.createServer 的括號里的那個函數(shù)定義。

我們本來可以用這樣的代碼來啟動服務(wù)器并偵聽8888端口:

復(fù)制代碼 代碼如下:

var http = require("http");

var server = http.createServer();
server.listen(8888);


這段代碼只會啟動一個偵聽8888端口的服務(wù)器,它不做任何別的事情,甚至連請求都不會應(yīng)答。

最有趣(而且,如果你之前習(xí)慣使用一個更加保守的語言,比如PHP,它還很奇怪)的部分是 createSever() 的第一個參數(shù),一個函數(shù)定義。

實際上,這個函數(shù)定義是 createServer() 的第一個也是唯一一個參數(shù)。因為在JavaScript中,函數(shù)和其他變量一樣都是可以被傳遞的。

進(jìn)行函數(shù)傳遞

舉例來說,你可以這樣做:

復(fù)制代碼 代碼如下:

function say(word) {
  console.log(word);
}

function execute(someFunction, value) {
  someFunction(value);
}

execute(say, "Hello");
請仔細(xì)閱讀這段代碼!在這里,我們把 say 函數(shù)作為execute函數(shù)的第一個變量進(jìn)行了傳遞。這里返回的不是 say 的返回值,而是 say 本身!

這樣一來, say 就變成了execute 中的本地變量 someFunction ,execute可以通過調(diào)用 someFunction() (帶括號的形式)來使用 say 函數(shù)。

當(dāng)然,因為 say 有一個變量, execute 在調(diào)用 someFunction 時可以傳遞這樣一個變量。

我們可以,就像剛才那樣,用它的名字把一個函數(shù)作為變量傳遞。但是我們不一定要繞這個“先定義,再傳遞”的圈子,我們可以直接在另一個函數(shù)的括號中定義和傳遞這個函數(shù):

復(fù)制代碼 代碼如下:

function execute(someFunction, value) {
  someFunction(value);
}

execute(function(word){ console.log(word) }, "Hello");
我們在 execute 接受第一個參數(shù)的地方直接定義了我們準(zhǔn)備傳遞給 execute 的函數(shù)。

用這種方式,我們甚至不用給這個函數(shù)起名字,這也是為什么它被叫做 匿名函數(shù) 。

這是我們和我所認(rèn)為的“進(jìn)階”JavaScript的第一次親密接觸,不過我們還是得循序漸進(jìn)?,F(xiàn)在,我們先接受這一點:在JavaScript中,一個函數(shù)可以作為另一個函數(shù)接收一個參數(shù)。我們可以先定義一個函數(shù),然后傳遞,也可以在傳遞參數(shù)的地方直接定義函數(shù)。

函數(shù)傳遞是如何讓HTTP服務(wù)器工作的

帶著這些知識,我們再來看看我們簡約而不簡單的HTTP服務(wù)器:

復(fù)制代碼 代碼如下:

var http = require("http");

http.createServer(function(request, response) {
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.write("Hello World");
  response.end();
}).listen(8888);


現(xiàn)在它看上去應(yīng)該清晰了很多:我們向 createServer 函數(shù)傳遞了一個匿名函數(shù)。

用這樣的代碼也可以達(dá)到同樣的目的:

復(fù)制代碼 代碼如下:

var http = require("http");

function onRequest(request, response) {
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.write("Hello World");
  response.end();
}

http.createServer(onRequest).listen(8888);


也許現(xiàn)在我們該問這個問題了:我們?yōu)槭裁匆眠@種方式呢?

基于事件驅(qū)動的回調(diào)

這個問題可不好回答(至少對我來說),不過這是Node.js原生的工作方式。它是事件驅(qū)動的,這也是它為什么這么快的原因。

你也許會想花點時間讀一下Felix Geisendörfer的大作Understanding node.js,它介紹了一些背景知識。

這一切都?xì)w結(jié)于“Node.js是事件驅(qū)動的”這一事實。好吧,其實我也不是特別確切的了解這句話的意思。不過我會試著解釋,為什么它對我們用Node.js寫網(wǎng)絡(luò)應(yīng)用(Web based application)是有意義的。

當(dāng)我們使用 http.createServer 方法的時候,我們當(dāng)然不只是想要一個偵聽某個端口的服務(wù)器,我們還想要它在服務(wù)器收到一個HTTP請求的時候做點什么。

問題是,這是異步的:請求任何時候都可能到達(dá),但是我們的服務(wù)器卻跑在一個單進(jìn)程中。

寫PHP應(yīng)用的時候,我們一點也不為此擔(dān)心:任何時候當(dāng)有請求進(jìn)入的時候,網(wǎng)頁服務(wù)器(通常是Apache)就為這一請求新建一個進(jìn)程,并且開始從頭到尾執(zhí)行相應(yīng)的PHP腳本。

那么在我們的Node.js程序中,當(dāng)一個新的請求到達(dá)8888端口的時候,我們怎么控制流程呢?

嗯,這就是Node.js/JavaScript的事件驅(qū)動設(shè)計能夠真正幫上忙的地方了——雖然我們還得學(xué)一些新概念才能掌握它。讓我們來看看這些概念是怎么應(yīng)用在我們的服務(wù)器代碼里的。

我們創(chuàng)建了服務(wù)器,并且向創(chuàng)建它的方法傳遞了一個函數(shù)。無論何時我們的服務(wù)器收到一個請求,這個函數(shù)就會被調(diào)用。

我們不知道這件事情什么時候會發(fā)生,但是我們現(xiàn)在有了一個處理請求的地方:它就是我們傳遞過去的那個函數(shù)。至于它是被預(yù)先定義的函數(shù)還是匿名函數(shù),就無關(guān)緊要了。

這個就是傳說中的 回調(diào) 。我們給某個方法傳遞了一個函數(shù),這個方法在有相應(yīng)事件發(fā)生時調(diào)用這個函數(shù)來進(jìn)行 回調(diào) 。

至少對我來說,需要一些功夫才能弄懂它。你如果還是不太確定的話就再去讀讀Felix的博客文章。

讓我們再來琢磨琢磨這個新概念。我們怎么證明,在創(chuàng)建完服務(wù)器之后,即使沒有HTTP請求進(jìn)來、我們的回調(diào)函數(shù)也沒有被調(diào)用的情況下,我們的代碼還繼續(xù)有效呢?我們試試這個:

復(fù)制代碼 代碼如下:

var http = require("http");

function onRequest(request, response) {
  console.log("Request received.");
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.write("Hello World");
  response.end();
}

http.createServer(onRequest).listen(8888);

console.log("Server has started.");


注意:在 onRequest (我們的回調(diào)函數(shù))觸發(fā)的地方,我用 console.log 輸出了一段文本。在HTTP服務(wù)器開始工作之后,也輸出一段文本。

當(dāng)我們與往常一樣,運行它node server.js時,它會馬上在命令行上輸出“Server has started.”。當(dāng)我們向服務(wù)器發(fā)出請求(在瀏覽器訪問http://localhost:8888/ ),“Request received.”這條消息就會在命令行中出現(xiàn)。

這就是事件驅(qū)動的異步服務(wù)器端JavaScript和它的回調(diào)啦!

(請注意,當(dāng)我們在服務(wù)器訪問網(wǎng)頁時,我們的服務(wù)器可能會輸出兩次“Request received.”。那是因為大部分服務(wù)器都會在你訪問 http://localhost:8888 /時嘗試讀取 http://localhost:8888/favicon.ico )

服務(wù)器是如何處理請求的

好的,接下來我們簡單分析一下我們服務(wù)器代碼中剩下的部分,也就是我們的回調(diào)函數(shù) onRequest() 的主體部分。

當(dāng)回調(diào)啟動,我們的 onRequest() 函數(shù)被觸發(fā)的時候,有兩個參數(shù)被傳入: request 和 response 。

它們是對象,你可以使用它們的方法來處理HTTP請求的細(xì)節(jié),并且響應(yīng)請求(比如向發(fā)出請求的瀏覽器發(fā)回一些東西)。

所以我們的代碼就是:當(dāng)收到請求時,使用 response.writeHead() 函數(shù)發(fā)送一個HTTP狀態(tài)200和HTTP頭的內(nèi)容類型(content-type),使用 response.write() 函數(shù)在HTTP相應(yīng)主體中發(fā)送文本“Hello World"。

最后,我們調(diào)用 response.end() 完成響應(yīng)。

目前來說,我們對請求的細(xì)節(jié)并不在意,所以我們沒有使用 request 對象。

服務(wù)端的模塊放在哪里

OK,就像我保證過的那樣,我們現(xiàn)在可以回到我們?nèi)绾谓M織應(yīng)用這個問題上了。我們現(xiàn)在在 server.js 文件中有一個非?;A(chǔ)的HTTP服務(wù)器代碼,而且我提到通常我們會有一個叫 index.js 的文件去調(diào)用應(yīng)用的其他模塊(比如 server.js 中的HTTP服務(wù)器模塊)來引導(dǎo)和啟動應(yīng)用。

我們現(xiàn)在就來談?wù)勗趺窗裺erver.js變成一個真正的Node.js模塊,使它可以被我們(還沒動工)的 index.js 主文件使用。

也許你已經(jīng)注意到,我們已經(jīng)在代碼中使用了模塊了。像這樣:

復(fù)制代碼 代碼如下:

var http = require("http");

...

http.createServer(...);


Node.js中自帶了一個叫做“http”的模塊,我們在我們的代碼中請求它并把返回值賦給一個本地變量。

這把我們的本地變量變成了一個擁有所有 http 模塊所提供的公共方法的對象。

給這種本地變量起一個和模塊名稱一樣的名字是一種慣例,但是你也可以按照自己的喜好來:

復(fù)制代碼 代碼如下:

var foo = require("http");

...

foo.createServer(...);


很好,怎么使用Node.js內(nèi)部模塊已經(jīng)很清楚了。我們怎么創(chuàng)建自己的模塊,又怎么使用它呢?

等我們把 server.js 變成一個真正的模塊,你就能搞明白了。

事實上,我們不用做太多的修改。把某段代碼變成模塊意味著我們需要把我們希望提供其功能的部分 導(dǎo)出 到請求這個模塊的腳本。

目前,我們的HTTP服務(wù)器需要導(dǎo)出的功能非常簡單,因為請求服務(wù)器模塊的腳本僅僅是需要啟動服務(wù)器而已。

我們把我們的服務(wù)器腳本放到一個叫做 start 的函數(shù)里,然后我們會導(dǎo)出這個函數(shù)。

復(fù)制代碼 代碼如下:

var http = require("http");

function start() {
  function onRequest(request, response) {
    console.log("Request received.");
    response.writeHead(200, {"Content-Type": "text/plain"});
    response.write("Hello World");
    response.end();
  }

  http.createServer(onRequest).listen(8888);
  console.log("Server has started.");
}

exports.start = start;


這樣,我們現(xiàn)在就可以創(chuàng)建我們的主文件 index.js 并在其中啟動我們的HTTP了,雖然服務(wù)器的代碼還在 server.js 中。

創(chuàng)建 index.js 文件并寫入以下內(nèi)容:

復(fù)制代碼 代碼如下:

var server = require("./server");

server.start();


正如你所看到的,我們可以像使用任何其他的內(nèi)置模塊一樣使用server模塊:請求這個文件并把它指向一個變量,其中已導(dǎo)出的函數(shù)就可以被我們使用了。

好了。我們現(xiàn)在就可以從我們的主要腳本啟動我們的的應(yīng)用了,而它還是老樣子:

復(fù)制代碼 代碼如下:

node index.js

非常好,我們現(xiàn)在可以把我們的應(yīng)用的不同部分放入不同的文件里,并且通過生成模塊的方式把它們連接到一起了。

我們?nèi)匀恢粨碛姓麄€應(yīng)用的最初部分:我們可以接收HTTP請求。但是我們得做點什么——對于不同的URL請求,服務(wù)器應(yīng)該有不同的反應(yīng)。

對于一個非常簡單的應(yīng)用來說,你可以直接在回調(diào)函數(shù) onRequest() 中做這件事情。不過就像我說過的,我們應(yīng)該加入一些抽象的元素,讓我們的例子變得更有趣一點兒。

處理不同的HTTP請求在我們的代碼中是一個不同的部分,叫做“路由選擇”——那么,我們接下來就創(chuàng)造一個叫做 路由 的模塊吧。

如何來進(jìn)行請求的“路由”

我們要為路由提供請求的URL和其他需要的GET及POST參數(shù),隨后路由需要根據(jù)這些數(shù)據(jù)來執(zhí)行相應(yīng)的代碼(這里“代碼”對應(yīng)整個應(yīng)用的第三部分:一系列在接收到請求時真正工作的處理程序)。

因此,我們需要查看HTTP請求,從中提取出請求的URL以及GET/POST參數(shù)。這一功能應(yīng)當(dāng)屬于路由還是服務(wù)器(甚至作為一個模塊自身的功能)確實值得探討,但這里暫定其為我們的HTTP服務(wù)器的功能。

我們需要的所有數(shù)據(jù)都會包含在request對象中,該對象作為onRequest()回調(diào)函數(shù)的第一個參數(shù)傳遞。但是為了解析這些數(shù)據(jù),我們需要額外的Node.JS模塊,它們分別是url和querystring模塊。

復(fù)制代碼 代碼如下:

                               url.parse(string).query

           url.parse(string).pathname      |

                       |                   |
                     ------ -------------------
http://localhost:8888/start?foo=bar&hello=world
                                ---       -----

                                 |          |
              querystring(string)["foo"]    |

                         querystring(string)["hello"]

當(dāng)然我們也可以用querystring模塊來解析POST請求體中的參數(shù),稍后會有演示。

現(xiàn)在我們來給onRequest()函數(shù)加上一些邏輯,用來找出瀏覽器請求的URL路徑:

var http = require("http");
var url = require("url");

function start() {
  function onRequest(request, response) {
    var pathname = url.parse(request.url).pathname;
    console.log("Request for " + pathname + " received.");
    response.writeHead(200, {"Content-Type": "text/plain"});
    response.write("Hello World");
    response.end();
  }

  http.createServer(onRequest).listen(8888);
  console.log("Server has started.");
}

exports.start = start;
好了,我們的應(yīng)用現(xiàn)在可以通過請求的URL路徑來區(qū)別不同請求了--這使我們得以使用路由(還未完成)來將請求以URL路徑為基準(zhǔn)映射到處理程序上。

在我們所要構(gòu)建的應(yīng)用中,這意味著來自/start和/upload的請求可以使用不同的代碼來處理。稍后我們將看到這些內(nèi)容是如何整合到一起的。

現(xiàn)在我們可以來編寫路由了,建立一個名為router.js的文件,添加以下內(nèi)容:

function route(pathname) {
  console.log("About to route a request for " + pathname);
}

exports.route = route;
如你所見,這段代碼什么也沒干,不過對于現(xiàn)在來說這是應(yīng)該的。在添加更多的邏輯以前,我們先來看看如何把路由和服務(wù)器整合起來。

我們的服務(wù)器應(yīng)當(dāng)知道路由的存在并加以有效利用。我們當(dāng)然可以通過硬編碼的方式將這一依賴項綁定到服務(wù)器上,但是其它語言的編程經(jīng)驗告訴我們這會是一件非常痛苦的事,因此我們將使用依賴注入的方式較松散地添加路由模塊(你可以讀讀Martin Fowlers關(guān)于依賴注入的大作來作為背景知識)。

首先,我們來擴展一下服務(wù)器的start()函數(shù),以便將路由函數(shù)作為參數(shù)傳遞過去:

復(fù)制代碼 代碼如下:

var http = require("http");
var url = require("url");

function start(route) {
  function onRequest(request, response) {
    var pathname = url.parse(request.url).pathname;
    console.log("Request for " + pathname + " received.");

    route(pathname);

    response.writeHead(200, {"Content-Type": "text/plain"});
    response.write("Hello World");
    response.end();
  }

  http.createServer(onRequest).listen(8888);
  console.log("Server has started.");
}

exports.start = start;


同時,我們會相應(yīng)擴展index.js,使得路由函數(shù)可以被注入到服務(wù)器中:
復(fù)制代碼 代碼如下:

var server = require("./server");
var router = require("./router");

server.start(router.route);


在這里,我們傳遞的函數(shù)依舊什么也沒做。

如果現(xiàn)在啟動應(yīng)用(node index.js,始終記得這個命令行),隨后請求一個URL,你將會看到應(yīng)用輸出相應(yīng)的信息,這表明我們的HTTP服務(wù)器已經(jīng)在使用路由模塊了,并會將請求的路徑傳遞給路由:

復(fù)制代碼 代碼如下:

bash$ node index.js
Request for /foo received.
About to route a request for /foo

(以上輸出已經(jīng)去掉了比較煩人的/favicon.ico請求相關(guān)的部分)。

行為驅(qū)動執(zhí)行

請允許我再次脫離主題,在這里談一談函數(shù)式編程。

將函數(shù)作為參數(shù)傳遞并不僅僅出于技術(shù)上的考量。對軟件設(shè)計來說,這其實是個哲學(xué)問題。想想這樣的場景:在index文件中,我們可以將router對象傳遞進(jìn)去,服務(wù)器隨后可以調(diào)用這個對象的route函數(shù)。

就像這樣,我們傳遞一個東西,然后服務(wù)器利用這個東西來完成一些事。嗨那個叫路由的東西,能幫我把這個路由一下嗎?

但是服務(wù)器其實不需要這樣的東西。它只需要把事情做完就行,其實為了把事情做完,你根本不需要東西,你需要的是動作。也就是說,你不需要名詞,你需要動詞。

理解了這個概念里最核心、最基本的思想轉(zhuǎn)換后,我自然而然地理解了函數(shù)編程。

我是在讀了Steve Yegge的大作名詞王國中的死刑之后理解函數(shù)編程。你也去讀一讀這本書吧,真的。這是曾給予我閱讀的快樂的關(guān)于軟件的書籍之一。

路由給真正的請求處理程序

回到正題,現(xiàn)在我們的HTTP服務(wù)器和請求路由模塊已經(jīng)如我們的期望,可以相互交流了,就像一對親密無間的兄弟。

當(dāng)然這還遠(yuǎn)遠(yuǎn)不夠,路由,顧名思義,是指我們要針對不同的URL有不同的處理方式。例如處理/start的“業(yè)務(wù)邏輯”就應(yīng)該和處理/upload的不同。

在現(xiàn)在的實現(xiàn)下,路由過程會在路由模塊中“結(jié)束”,并且路由模塊并不是真正針對請求“采取行動”的模塊,否則當(dāng)我們的應(yīng)用程序變得更為復(fù)雜時,將無法很好地擴展。

我們暫時把作為路由目標(biāo)的函數(shù)稱為請求處理程序?,F(xiàn)在我們不要急著來開發(fā)路由模塊,因為如果請求處理程序沒有就緒的話,再怎么完善路由模塊也沒有多大意義。

應(yīng)用程序需要新的部件,因此加入新的模塊 -- 已經(jīng)無需為此感到新奇了。我們來創(chuàng)建一個叫做requestHandlers的模塊,并對于每一個請求處理程序,添加一個占位用函數(shù),隨后將這些函數(shù)作為模塊的方法導(dǎo)出:

復(fù)制代碼 代碼如下:

function start() {
  console.log("Request handler 'start' was called.");
}

function upload() {
  console.log("Request handler 'upload' was called.");
}

exports.start = start;
exports.upload = upload;


這樣我們就可以把請求處理程序和路由模塊連接起來,讓路由“有路可尋”。

在這里我們得做個決定:是將requestHandlers模塊硬編碼到路由里來使用,還是再添加一點依賴注入?雖然和其他模式一樣,依賴注入不應(yīng)該僅僅為使用而使用,但在現(xiàn)在這個情況下,使用依賴注入可以讓路由和請求處理程序之間的耦合更加松散,也因此能讓路由的重用性更高。

這意味著我們得將請求處理程序從服務(wù)器傳遞到路由中,但感覺上這么做更離譜了,我們得一路把這堆請求處理程序從我們的主文件傳遞到服務(wù)器中,再將之從服務(wù)器傳遞到路由。

那么我們要怎么傳遞這些請求處理程序呢?別看現(xiàn)在我們只有2個處理程序,在一個真實的應(yīng)用中,請求處理程序的數(shù)量會不斷增加,我們當(dāng)然不想每次有一個新的URL或請求處理程序時,都要為了在路由里完成請求到處理程序的映射而反復(fù)折騰。除此之外,在路由里有一大堆if request == x then call handler y也使得系統(tǒng)丑陋不堪。

仔細(xì)想想,有一大堆東西,每個都要映射到一個字符串(就是請求的URL)上?似乎關(guān)聯(lián)數(shù)組(associative array)能完美勝任。

不過結(jié)果有點令人失望,JavaScript沒提供關(guān)聯(lián)數(shù)組 -- 也可以說它提供了?事實上,在JavaScript中,真正能提供此類功能的是它的對象。

在這方面,http://msdn.microsoft.com/en-us/magazine/cc163419.aspx有一個不錯的介紹,我在此摘錄一段:

在C++或C#中,當(dāng)我們談到對象,指的是類或者結(jié)構(gòu)體的實例。對象根據(jù)他們實例化的模板(就是所謂的類),會擁有不同的屬性和方法。但在JavaScript里對象不是這個概念。在JavaScript中,對象就是一個鍵/值對的集合 -- 你可以把JavaScript的對象想象成一個鍵為字符串類型的字典。

但如果JavaScript的對象僅僅是鍵/值對的集合,它又怎么會擁有方法呢?好吧,這里的值可以是字符串、數(shù)字或者……函數(shù)!

好了,最后再回到代碼上來。現(xiàn)在我們已經(jīng)確定將一系列請求處理程序通過一個對象來傳遞,并且需要使用松耦合的方式將這個對象注入到route()函數(shù)中。

我們先將這個對象引入到主文件index.js中:

復(fù)制代碼 代碼如下:

var server = require("./server");
var router = require("./router");
var requestHandlers = require("./requestHandlers");

var handle = {}
handle["/"] = requestHandlers.start;
handle["/start"] = requestHandlers.start;
handle["/upload"] = requestHandlers.upload;

server.start(router.route, handle);


雖然handle并不僅僅是一個“東西”(一些請求處理程序的集合),我還是建議以一個動詞作為其命名,這樣做可以讓我們在路由中使用更流暢的表達(dá)式,稍后會有說明。

正如所見,將不同的URL映射到相同的請求處理程序上是很容易的:只要在對象中添加一個鍵為"/"的屬性,對應(yīng)requestHandlers.start即可,這樣我們就可以干凈簡潔地配置/start和/的請求都交由start這一處理程序處理。

在完成了對象的定義后,我們把它作為額外的參數(shù)傳遞給服務(wù)器,為此將server.js修改如下:

復(fù)制代碼 代碼如下:

var http = require("http");
var url = require("url");

function start(route, handle) {
  function onRequest(request, response) {
    var pathname = url.parse(request.url).pathname;
    console.log("Request for " + pathname + " received.");

    route(handle, pathname);

    response.writeHead(200, {"Content-Type": "text/plain"});
    response.write("Hello World");
    response.end();
  }

  http.createServer(onRequest).listen(8888);
  console.log("Server has started.");
}

exports.start = start;


這樣我們就在start()函數(shù)里添加了handle參數(shù),并且把handle對象作為第一個參數(shù)傳遞給了route()回調(diào)函數(shù)。

然后我們相應(yīng)地在route.js文件中修改route()函數(shù):

復(fù)制代碼 代碼如下:

function route(handle, pathname) {
  console.log("About to route a request for " + pathname);
  if (typeof handle[pathname] === 'function') {
    handle[pathname]();
  } else {
    console.log("No request handler found for " + pathname);
  }
}

exports.route = route;


通過以上代碼,我們首先檢查給定的路徑對應(yīng)的請求處理程序是否存在,如果存在的話直接調(diào)用相應(yīng)的函數(shù)。我們可以用從關(guān)聯(lián)數(shù)組中獲取元素一樣的方式從傳遞的對象中獲取請求處理函數(shù),因此就有了簡潔流暢的形如handle[pathname]();的表達(dá)式,這個感覺就像在前方中提到的那樣:“嗨,請幫我處理了這個路徑”。

有了這些,我們就把服務(wù)器、路由和請求處理程序在一起了?,F(xiàn)在我們啟動應(yīng)用程序并在瀏覽器中訪問http://localhost:8888/start,以下日志可以說明系統(tǒng)調(diào)用了正確的請求處理程序:

復(fù)制代碼 代碼如下:

Server has started.
Request for /start received.
About to route a request for /start
Request handler 'start' was called.

并且在瀏覽器中打開http://localhost:8888/可以看到這個請求同樣被start請求處理程序處理了:
復(fù)制代碼 代碼如下:

Request for / received.
About to route a request for /
Request handler 'start' was called.

讓請求處理程序作出響應(yīng)

很好。不過現(xiàn)在要是請求處理程序能夠向瀏覽器返回一些有意義的信息而并非全是“Hello World”,那就更好了。

這里要記住的是,瀏覽器發(fā)出請求后獲得并顯示的“Hello World”信息仍是來自于我們server.js文件中的onRequest函數(shù)。

其實“處理請求”說白了就是“對請求作出響應(yīng)”,因此,我們需要讓請求處理程序能夠像onRequest函數(shù)那樣可以和瀏覽器進(jìn)行“對話”。

不好的實現(xiàn)方式

對于我們這樣擁有PHP或者Ruby技術(shù)背景的開發(fā)者來說,最直截了當(dāng)?shù)膶崿F(xiàn)方式事實上并不是非??孔V: 看似有效,實則未必如此。

這里我指的“直截了當(dāng)?shù)膶崿F(xiàn)方式”意思是:讓請求處理程序通過onRequest函數(shù)直接返回(return())他們要展示給用戶的信息。

我們先就這樣去實現(xiàn),然后再來看為什么這不是一種很好的實現(xiàn)方式。

讓我們從讓請求處理程序返回需要在瀏覽器中顯示的信息開始。我們需要將requestHandler.js修改為如下形式:

復(fù)制代碼 代碼如下:

function start() {
  console.log("Request handler 'start' was called.");
  return "Hello Start";
}

function upload() {
  console.log("Request handler 'upload' was called.");
  return "Hello Upload";
}

exports.start = start;
exports.upload = upload;


好的。同樣的,請求路由需要將請求處理程序返回給它的信息返回給服務(wù)器。因此,我們需要將router.js修改為如下形式:
復(fù)制代碼 代碼如下:

function route(handle, pathname) {
  console.log("About to route a request for " + pathname);
  if (typeof handle[pathname] === 'function') {
    return handle[pathname]();
  } else {
    console.log("No request handler found for " + pathname);
    return "404 Not found";
  }
}

exports.route = route;


正如上述代碼所示,當(dāng)請求無法路由的時候,我們也返回了一些相關(guān)的錯誤信息。

最后,我們需要對我們的server.js進(jìn)行重構(gòu)以使得它能夠?qū)⒄埱筇幚沓绦蛲ㄟ^請求路由返回的內(nèi)容響應(yīng)給瀏覽器,如下所示:

復(fù)制代碼 代碼如下:

var http = require("http");
var url = require("url");

function start(route, handle) {
  function onRequest(request, response) {
    var pathname = url.parse(request.url).pathname;
    console.log("Request for " + pathname + " received.");

    response.writeHead(200, {"Content-Type": "text/plain"});
    var content = route(handle, pathname)
    response.write(content);
    response.end();
  }

  http.createServer(onRequest).listen(8888);
  console.log("Server has started.");
}

exports.start = start;


如果我們運行重構(gòu)后的應(yīng)用,一切都會工作的很好:請求http://localhost:8888/start,瀏覽器會輸出“Hello Start”,請求http://localhost:8888/upload會輸出“Hello Upload”,而請求http://localhost:8888/foo 會輸出“404 Not found”。

好,那么問題在哪里呢?簡單的說就是: 當(dāng)未來有請求處理程序需要進(jìn)行非阻塞的操作的時候,我們的應(yīng)用就“掛”了。

沒理解?沒關(guān)系,下面就來詳細(xì)解釋下。

阻塞與非阻塞

正如此前所提到的,當(dāng)在請求處理程序中包括非阻塞操作時就會出問題。但是,在說這之前,我們先來看看什么是阻塞操作。

我不想去解釋“阻塞”和“非阻塞”的具體含義,我們直接來看,當(dāng)在請求處理程序中加入阻塞操作時會發(fā)生什么。

這里,我們來修改下start請求處理程序,我們讓它等待10秒以后再返回“Hello Start”。因為,JavaScript中沒有類似sleep()這樣的操作,所以這里只能夠來點小Hack來模擬實現(xiàn)。

讓我們將requestHandlers.js修改成如下形式:

復(fù)制代碼 代碼如下:

function start() {
  console.log("Request handler 'start' was called.");

  function sleep(milliSeconds) {
    var startTime = new Date().getTime();
    while (new Date().getTime() < startTime + milliSeconds);
  }

  sleep(10000);
  return "Hello Start";
}

function upload() {
  console.log("Request handler 'upload' was called.");
  return "Hello Upload";
}

exports.start = start;
exports.upload = upload;


上述代碼中,當(dāng)函數(shù)start()被調(diào)用的時候,Node.js會先等待10秒,之后才會返回“Hello Start”。當(dāng)調(diào)用upload()的時候,會和此前一樣立即返回。

(當(dāng)然了,這里只是模擬休眠10秒,實際場景中,這樣的阻塞操作有很多,比方說一些長時間的計算操作等。)

接下來就讓我們來看看,我們的改動帶來了哪些變化。

如往常一樣,我們先要重啟下服務(wù)器。為了看到效果,我們要進(jìn)行一些相對復(fù)雜的操作(跟著我一起做): 首先,打開兩個瀏覽器窗口或者標(biāo)簽頁。在第一個瀏覽器窗口的地址欄中輸入http://localhost:8888/start, 但是先不要打開它!

在第二個瀏覽器窗口的地址欄中輸入http://localhost:8888/upload, 同樣的,先不要打開它!

接下來,做如下操作:在第一個窗口中(“/start”)按下回車,然后快速切換到第二個窗口中(“/upload”)按下回車。

注意,發(fā)生了什么: /start URL加載花了10秒,這和我們預(yù)期的一樣。但是,/upload URL居然也花了10秒,而它在對應(yīng)的請求處理程序中并沒有類似于sleep()這樣的操作!

這到底是為什么呢?原因就是start()包含了阻塞操作。形象的說就是“它阻塞了所有其他的處理工作”。

這顯然是個問題,因為Node一向是這樣來標(biāo)榜自己的:“在node中除了代碼,所有一切都是并行執(zhí)行的”。

這句話的意思是說,Node.js可以在不新增額外線程的情況下,依然可以對任務(wù)進(jìn)行并行處理 —— Node.js是單線程的。它通過事件輪詢(event loop)來實現(xiàn)并行操作,對此,我們應(yīng)該要充分利用這一點 —— 盡可能的避免阻塞操作,取而代之,多使用非阻塞操作。

然而,要用非阻塞操作,我們需要使用回調(diào),通過將函數(shù)作為參數(shù)傳遞給其他需要花時間做處理的函數(shù)(比方說,休眠10秒,或者查詢數(shù)據(jù)庫,又或者是進(jìn)行大量的計算)。

對于Node.js來說,它是這樣處理的:“嘿,probablyExpensiveFunction()(譯者注:這里指的就是需要花時間處理的函數(shù)),你繼續(xù)處理你的事情,我(Node.js線程)先不等你了,我繼續(xù)去處理你后面的代碼,請你提供一個callbackFunction(),等你處理完之后我會去調(diào)用該回調(diào)函數(shù)的,謝謝!”

(如果想要了解更多關(guān)于事件輪詢細(xì)節(jié),可以閱讀Mixu的博文——理解node.js的事件輪詢。)

接下來,我們會介紹一種錯誤的使用非阻塞操作的方式。

和上次一樣,我們通過修改我們的應(yīng)用來暴露問題。

這次我們還是拿start請求處理程序來“開刀”。將其修改成如下形式:

復(fù)制代碼 代碼如下:

var exec = require("child_process").exec;

function start() {
  console.log("Request handler 'start' was called.");
  var content = "empty";

  exec("ls -lah", function (error, stdout, stderr) {
    content = stdout;
  });

  return content;
}

function upload() {
  console.log("Request handler 'upload' was called.");
  return "Hello Upload";
}

exports.start = start;
exports.upload = upload;


上述代碼中,我們引入了一個新的Node.js模塊,child_process。之所以用它,是為了實現(xiàn)一個既簡單又實用的非阻塞操作:exec()。

exec()做了什么呢?它從Node.js來執(zhí)行一個shell命令。在上述例子中,我們用它來獲取當(dāng)前目錄下所有的文件(“l(fā)s -lah”),然后,當(dāng)/startURL請求的時候?qū)⑽募畔⑤敵龅綖g覽器中。

上述代碼是非常直觀的: 創(chuàng)建了一個新的變量content(初始值為“empty”),執(zhí)行“l(fā)s -lah”命令,將結(jié)果賦值給content,最后將content返回。

和往常一樣,我們啟動服務(wù)器,然后訪問“http://localhost:8888/start” 。

之后會載入一個漂亮的web頁面,其內(nèi)容為“empty”。怎么回事?

這個時候,你可能大致已經(jīng)猜到了,exec()在非阻塞這塊發(fā)揮了神奇的功效。它其實是個很好的東西,有了它,我們可以執(zhí)行非常耗時的shell操作而無需迫使我們的應(yīng)用停下來等待該操作。

(如果想要證明這一點,可以將“l(fā)s -lah”換成比如“find /”這樣更耗時的操作來效果)。

然而,針對瀏覽器顯示的結(jié)果來看,我們并不滿意我們的非阻塞操作,對吧?

好,接下來,我們來修正這個問題。在這過程中,讓我們先來看看為什么當(dāng)前的這種方式不起作用。

問題就在于,為了進(jìn)行非阻塞工作,exec()使用了回調(diào)函數(shù)。

在我們的例子中,該回調(diào)函數(shù)就是作為第二個參數(shù)傳遞給exec()的匿名函數(shù):

復(fù)制代碼 代碼如下:

function (error, stdout, stderr) {
  content = stdout;
}

現(xiàn)在就到了問題根源所在了:我們的代碼是同步執(zhí)行的,這就意味著在調(diào)用exec()之后,Node.js會立即執(zhí)行 return content ;在這個時候,content仍然是“empty”,因為傳遞給exec()的回調(diào)函數(shù)還未執(zhí)行到——因為exec()的操作是異步的。

我們這里“l(fā)s -lah”的操作其實是非??斓模ǔ钱?dāng)前目錄下有上百萬個文件)。這也是為什么回調(diào)函數(shù)也會很快的執(zhí)行到 —— 不過,不管怎么說它還是異步的。

為了讓效果更加明顯,我們想象一個更耗時的命令: “find /”,它在我機器上需要執(zhí)行1分鐘左右的時間,然而,盡管在請求處理程序中,我把“l(fā)s -lah”換成“find /”,當(dāng)打開/start URL的時候,依然能夠立即獲得HTTP響應(yīng) —— 很明顯,當(dāng)exec()在后臺執(zhí)行的時候,Node.js自身會繼續(xù)執(zhí)行后面的代碼。并且我們這里假設(shè)傳遞給exec()的回調(diào)函數(shù),只會在“find /”命令執(zhí)行完成之后才會被調(diào)用。

那究竟我們要如何才能實現(xiàn)將當(dāng)前目錄下的文件列表顯示給用戶呢?

好,了解了這種不好的實現(xiàn)方式之后,我們接下來來介紹如何以正確的方式讓請求處理程序?qū)g覽器請求作出響應(yīng)。

以非阻塞操作進(jìn)行請求響應(yīng)

我剛剛提到了這樣一個短語 —— “正確的方式”。而事實上通?!罢_的方式”一般都不簡單。

不過,用Node.js就有這樣一種實現(xiàn)方案: 函數(shù)傳遞。下面就讓我們來具體看看如何實現(xiàn)。

到目前為止,我們的應(yīng)用已經(jīng)可以通過應(yīng)用各層之間傳遞值的方式(請求處理程序 -> 請求路由 -> 服務(wù)器)將請求處理程序返回的內(nèi)容(請求處理程序最終要顯示給用戶的內(nèi)容)傳遞給HTTP服務(wù)器。

現(xiàn)在我們采用如下這種新的實現(xiàn)方式:相對采用將內(nèi)容傳遞給服務(wù)器的方式,我們這次采用將服務(wù)器“傳遞”給內(nèi)容的方式。 從實踐角度來說,就是將response對象(從服務(wù)器的回調(diào)函數(shù)onRequest()獲取)通過請求路由傳遞給請求處理程序。 隨后,處理程序就可以采用該對象上的函數(shù)來對請求作出響應(yīng)。

原理就是如此,接下來讓我們來一步步實現(xiàn)這種方案。

先從server.js開始:

復(fù)制代碼 代碼如下:

var http = require("http");
var url = require("url");

function start(route, handle) {
  function onRequest(request, response) {
    var pathname = url.parse(request.url).pathname;
    console.log("Request for " + pathname + " received.");

    route(handle, pathname, response);
  }

  http.createServer(onRequest).listen(8888);
  console.log("Server has started.");
}

exports.start = start;


相對此前從route()函數(shù)獲取返回值的做法,這次我們將response對象作為第三個參數(shù)傳遞給route()函數(shù),并且,我們將onRequest()處理程序中所有有關(guān)response的函數(shù)調(diào)都移除,因為我們希望這部分工作讓route()函數(shù)來完成。

下面就來看看我們的router.js:

復(fù)制代碼 代碼如下:

function route(handle, pathname, response) {
  console.log("About to route a request for " + pathname);
  if (typeof handle[pathname] === 'function') {
    handle[pathname](response);
  } else {
    console.log("No request handler found for " + pathname);
    response.writeHead(404, {"Content-Type": "text/plain"});
    response.write("404 Not found");
    response.end();
  }
}

exports.route = route;


同樣的模式:相對此前從請求處理程序中獲取返回值,這次取而代之的是直接傳遞response對象。

如果沒有對應(yīng)的請求處理器處理,我們就直接返回“404”錯誤。

最后,我們將requestHandler.js修改為如下形式:

復(fù)制代碼 代碼如下:

var exec = require("child_process").exec;

function start(response) {
  console.log("Request handler 'start' was called.");

  exec("ls -lah", function (error, stdout, stderr) {
    response.writeHead(200, {"Content-Type": "text/plain"});
    response.write(stdout);
    response.end();
  });
}

function upload(response) {
  console.log("Request handler 'upload' was called.");
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.write("Hello Upload");
  response.end();
}

exports.start = start;
exports.upload = upload;


我們的處理程序函數(shù)需要接收response參數(shù),為了對請求作出直接的響應(yīng)。

start處理程序在exec()的匿名回調(diào)函數(shù)中做請求響應(yīng)的操作,而upload處理程序仍然是簡單的回復(fù)“Hello World”,只是這次是使用response對象而已。

這時再次我們啟動應(yīng)用(node index.js),一切都會工作的很好。

如果想要證明/start處理程序中耗時的操作不會阻塞對/upload請求作出立即響應(yīng)的話,可以將requestHandlers.js修改為如下形式:

復(fù)制代碼 代碼如下:

var exec = require("child_process").exec;

function start(response) {
  console.log("Request handler 'start' was called.");

  exec("find /",
    { timeout: 10000, maxBuffer: 20000*1024 },
    function (error, stdout, stderr) {
      response.writeHead(200, {"Content-Type": "text/plain"});
      response.write(stdout);
      response.end();
    });
}

function upload(response) {
  console.log("Request handler 'upload' was called.");
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.write("Hello Upload");
  response.end();
}

exports.start = start;
exports.upload = upload;


這樣一來,當(dāng)請求http://localhost:8888/start的時候,會花10秒鐘的時間才載入,而當(dāng)請求http://localhost:8888/upload的時候,會立即響應(yīng),縱然這個時候/start響應(yīng)還在處理中。

更有用的場景

到目前為止,我們做的已經(jīng)很好了,但是,我們的應(yīng)用沒有實際用途。

服務(wù)器,請求路由以及請求處理程序都已經(jīng)完成了,下面讓我們按照此前的用例給網(wǎng)站添加交互:用戶選擇一個文件,上傳該文件,然后在瀏覽器中看到上傳的文件。 為了保持簡單,我們假設(shè)用戶只會上傳圖片,然后我們應(yīng)用將該圖片顯示到瀏覽器中。

好,下面就一步步來實現(xiàn),鑒于此前已經(jīng)對JavaScript原理性技術(shù)性的內(nèi)容做過大量介紹了,這次我們加快點速度。

要實現(xiàn)該功能,分為如下兩步: 首先,讓我們來看看如何處理POST請求(非文件上傳),之后,我們使用Node.js的一個用于文件上傳的外部模塊。之所以采用這種實現(xiàn)方式有兩個理由。

第一,盡管在Node.js中處理基礎(chǔ)的POST請求相對比較簡單,但在這過程中還是能學(xué)到很多。
第二,用Node.js來處理文件上傳(multipart POST請求)是比較復(fù)雜的,它不在本書的范疇,但,如何使用外部模塊卻是在本書涉獵內(nèi)容之內(nèi)。

處理POST請求

考慮這樣一個簡單的例子:我們顯示一個文本區(qū)(textarea)供用戶輸入內(nèi)容,然后通過POST請求提交給服務(wù)器。最后,服務(wù)器接受到請求,通過處理程序?qū)⑤斎氲膬?nèi)容展示到瀏覽器中。

/start請求處理程序用于生成帶文本區(qū)的表單,因此,我們將requestHandlers.js修改為如下形式:

function start(response) {
  console.log("Request handler 'start' was called.");

  var body = '<html>'+
    '<head>'+
    '<meta http-equiv="Content-Type" content="text/html; '+
    'charset=UTF-8" />'+
    '</head>'+
    '<body>'+
    '<form action="/upload" method="post">'+
    '<textarea name="text" rows="20" cols="60"></textarea>'+
    '<input type="submit" value="Submit text" />'+
    '</form>'+
    '</body>'+
    '</html>';

    response.writeHead(200, {"Content-Type": "text/html"});
    response.write(body);
    response.end();
}

function upload(response) {
  console.log("Request handler 'upload' was called.");
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.write("Hello Upload");
  response.end();
}

exports.start = start;
exports.upload = upload;
好了,現(xiàn)在我們的應(yīng)用已經(jīng)很完善了,都可以獲得威比獎(Webby Awards)了,哈哈。(譯者注:威比獎是由國際數(shù)字藝術(shù)與科學(xué)學(xué)院主辦的評選全球最佳網(wǎng)站的獎項,具體參見詳細(xì)說明)通過在瀏覽器中訪問http://localhost:8888/start就可以看到簡單的表單了,要記得重啟服務(wù)器哦!

你可能會說:這種直接將視覺元素放在請求處理程序中的方式太丑陋了。說的沒錯,但是,我并不想在本書中介紹諸如MVC之類的模式,因為這對于你了解JavaScript或者Node.js環(huán)境來說沒多大關(guān)系。

余下的篇幅,我們來探討一個更有趣的問題: 當(dāng)用戶提交表單時,觸發(fā)/upload請求處理程序處理POST請求的問題。

現(xiàn)在,我們已經(jīng)是新手中的專家了,很自然會想到采用異步回調(diào)來實現(xiàn)非阻塞地處理POST請求的數(shù)據(jù)。

這里采用非阻塞方式處理是明智的,因為POST請求一般都比較“重” —— 用戶可能會輸入大量的內(nèi)容。用阻塞的方式處理大數(shù)據(jù)量的請求必然會導(dǎo)致用戶操作的阻塞。

為了使整個過程非阻塞,Node.js會將POST數(shù)據(jù)拆分成很多小的數(shù)據(jù)塊,然后通過觸發(fā)特定的事件,將這些小數(shù)據(jù)塊傳遞給回調(diào)函數(shù)。這里的特定的事件有data事件(表示新的小數(shù)據(jù)塊到達(dá)了)以及end事件(表示所有的數(shù)據(jù)都已經(jīng)接收完畢)。

我們需要告訴Node.js當(dāng)這些事件觸發(fā)的時候,回調(diào)哪些函數(shù)。怎么告訴呢? 我們通過在request對象上注冊監(jiān)聽器實現(xiàn)。這里的request對象是每次接收到HTTP請求時候,都會把該對象傳遞給onRequest回調(diào)函數(shù)。
如下所示:

復(fù)制代碼 代碼如下:

request.addListener("data", function(chunk) {
  // called when a new chunk of data was received
});

request.addListener("end", function() {
  // called when all chunks of data have been received
});


問題來了,這部分邏輯寫在哪里呢? 我們現(xiàn)在只是在服務(wù)器中獲取到了request對象 —— 我們并沒有像之前response對象那樣,把 request 對象傳遞給請求路由和請求處理程序。

在我看來,獲取所有來自請求的數(shù)據(jù),然后將這些數(shù)據(jù)給應(yīng)用層處理,應(yīng)該是HTTP服務(wù)器要做的事情。因此,我建議,我們直接在服務(wù)器中處理POST數(shù)據(jù),然后將最終的數(shù)據(jù)傳遞給請求路由和請求處理器,讓他們來進(jìn)行進(jìn)一步的處理。

因此,實現(xiàn)思路就是: 將data和end事件的回調(diào)函數(shù)直接放在服務(wù)器中,在data事件回調(diào)中收集所有的POST數(shù)據(jù),當(dāng)接收到所有數(shù)據(jù),觸發(fā)end事件后,其回調(diào)函數(shù)調(diào)用請求路由,并將數(shù)據(jù)傳遞給它,然后,請求路由再將該數(shù)據(jù)傳遞給請求處理程序。

還等什么,馬上來實現(xiàn)。先從server.js開始:

復(fù)制代碼 代碼如下:

var http = require("http");
var url = require("url");

function start(route, handle) {
  function onRequest(request, response) {
    var postData = "";
    var pathname = url.parse(request.url).pathname;
    console.log("Request for " + pathname + " received.");

    request.setEncoding("utf8");

    request.addListener("data", function(postDataChunk) {
      postData += postDataChunk;
      console.log("Received POST data chunk '"+
      postDataChunk + "'.");
    });

    request.addListener("end", function() {
      route(handle, pathname, response, postData);
    });

  }

  http.createServer(onRequest).listen(8888);
  console.log("Server has started.");
}

exports.start = start;


上述代碼做了三件事情: 首先,我們設(shè)置了接收數(shù)據(jù)的編碼格式為UTF-8,然后注冊了“data”事件的監(jiān)聽器,用于收集每次接收到的新數(shù)據(jù)塊,并將其賦值給postData 變量,最后,我們將請求路由的調(diào)用移到end事件處理程序中,以確保它只會當(dāng)所有數(shù)據(jù)接收完畢后才觸發(fā),并且只觸發(fā)一次。我們同時還把POST數(shù)據(jù)傳遞給請求路由,因為這些數(shù)據(jù),請求處理程序會用到。

上述代碼在每個數(shù)據(jù)塊到達(dá)的時候輸出了日志,這對于最終生產(chǎn)環(huán)境來說,是很不好的(數(shù)據(jù)量可能會很大,還記得吧?),但是,在開發(fā)階段是很有用的,有助于讓我們看到發(fā)生了什么。

我建議可以嘗試下,嘗試著去輸入一小段文本,以及大段內(nèi)容,當(dāng)大段內(nèi)容的時候,就會發(fā)現(xiàn)data事件會觸發(fā)多次。

再來點酷的。我們接下來在/upload頁面,展示用戶輸入的內(nèi)容。要實現(xiàn)該功能,我們需要將postData傳遞給請求處理程序,修改router.js為如下形式:

復(fù)制代碼 代碼如下:

function route(handle, pathname, response, postData) {
  console.log("About to route a request for " + pathname);
  if (typeof handle[pathname] === 'function') {
    handle[pathname](response, postData);
  } else {
    console.log("No request handler found for " + pathname);
    response.writeHead(404, {"Content-Type": "text/plain"});
    response.write("404 Not found");
    response.end();
  }
}

exports.route = route;


然后,在requestHandlers.js中,我們將數(shù)據(jù)包含在對upload請求的響應(yīng)中:
復(fù)制代碼 代碼如下:

function start(response, postData) {
  console.log("Request handler 'start' was called.");

  var body = '<html>'+
    '<head>'+
    '<meta http-equiv="Content-Type" content="text/html; '+
    'charset=UTF-8" />'+
    '</head>'+
    '<body>'+
    '<form action="/upload" method="post">'+
    '<textarea name="text" rows="20" cols="60"></textarea>'+
    '<input type="submit" value="Submit text" />'+
    '</form>'+
    '</body>'+
    '</html>';

    response.writeHead(200, {"Content-Type": "text/html"});
    response.write(body);
    response.end();
}

function upload(response, postData) {
  console.log("Request handler 'upload' was called.");
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.write("You've sent: " + postData);
  response.end();
}

exports.start = start;
exports.upload = upload;


好了,我們現(xiàn)在可以接收POST數(shù)據(jù)并在請求處理程序中處理該數(shù)據(jù)了。

我們最后要做的是: 當(dāng)前我們是把請求的整個消息體傳遞給了請求路由和請求處理程序。我們應(yīng)該只把POST數(shù)據(jù)中,我們感興趣的部分傳遞給請求路由和請求處理程序。在我們這個例子中,我們感興趣的其實只是text字段。

我們可以使用此前介紹過的querystring模塊來實現(xiàn):

復(fù)制代碼 代碼如下:

var querystring = require("querystring");

function start(response, postData) {
  console.log("Request handler 'start' was called.");

  var body = '<html>'+
    '<head>'+
    '<meta http-equiv="Content-Type" content="text/html; '+
    'charset=UTF-8" />'+
    '</head>'+
    '<body>'+
    '<form action="/upload" method="post">'+
    '<textarea name="text" rows="20" cols="60"></textarea>'+
    '<input type="submit" value="Submit text" />'+
    '</form>'+
    '</body>'+
    '</html>';

    response.writeHead(200, {"Content-Type": "text/html"});
    response.write(body);
    response.end();
}

function upload(response, postData) {
  console.log("Request handler 'upload' was called.");
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.write("You've sent the text: "+
  querystring.parse(postData).text);
  response.end();
}

exports.start = start;
exports.upload = upload;


好了,以上就是關(guān)于處理POST數(shù)據(jù)的全部內(nèi)容。

處理文件上傳

最后,我們來實現(xiàn)我們最終的用例:允許用戶上傳圖片,并將該圖片在瀏覽器中顯示出來。

回到90年代,這個用例完全可以滿足用于IPO的商業(yè)模型了,如今,我們通過它能學(xué)到這樣兩件事情: 如何安裝外部Node.js模塊,以及如何將它們應(yīng)用到我們的應(yīng)用中。

這里我們要用到的外部模塊是Felix Geisendörfer開發(fā)的node-formidable模塊。它對解析上傳的文件數(shù)據(jù)做了很好的抽象。 其實說白了,處理文件上傳“就是”處理POST數(shù)據(jù) —— 但是,麻煩的是在具體的處理細(xì)節(jié),所以,這里采用現(xiàn)成的方案更合適點。

使用該模塊,首先需要安裝該模塊。Node.js有它自己的包管理器,叫NPM。它可以讓安裝Node.js的外部模塊變得非常方便。通過如下一條命令就可以完成該模塊的安裝:

復(fù)制代碼 代碼如下:

npm install formidable

如果終端輸出如下內(nèi)容:
復(fù)制代碼 代碼如下:

npm info build Success: formidable@1.0.9
npm ok

就說明模塊已經(jīng)安裝成功了。

現(xiàn)在我們就可以用formidable模塊了——使用外部模塊與內(nèi)部模塊類似,用require語句將其引入即可:

復(fù)制代碼 代碼如下:

var formidable = require("formidable");

這里該模塊做的就是將通過HTTP POST請求提交的表單,在Node.js中可以被解析。我們要做的就是創(chuàng)建一個新的IncomingForm,它是對提交表單的抽象表示,之后,就可以用它解析request對象,獲取表單中需要的數(shù)據(jù)字段。

node-formidable官方的例子展示了這兩部分是如何融合在一起工作的:

復(fù)制代碼 代碼如下:

var formidable = require('formidable'),
    http = require('http'),
    sys = require('sys');

http.createServer(function(req, res) {
  if (req.url == '/upload' && req.method.toLowerCase() == 'post') {
    // parse a file upload
    var form = new formidable.IncomingForm();
    form.parse(req, function(err, fields, files) {
      res.writeHead(200, {'content-type': 'text/plain'});
      res.write('received upload:\n\n');
      res.end(sys.inspect({fields: fields, files: files}));
    });
    return;
  }

  // show a file upload form
  res.writeHead(200, {'content-type': 'text/html'});
  res.end(
    '<form action="/upload" enctype="multipart/form-data" '+
    'method="post">'+
    '<input type="text" name="title"><br>'+
    '<input type="file" name="upload" multiple="multiple"><br>'+
    '<input type="submit" value="Upload">'+
    '</form>'
  );
}).listen(8888);


如果我們將上述代碼,保存到一個文件中,并通過node來執(zhí)行,就可以進(jìn)行簡單的表單提交了,包括文件上傳。然后,可以看到通過調(diào)用form.parse傳遞給回調(diào)函數(shù)的files對象的內(nèi)容,如下所示:
復(fù)制代碼 代碼如下:

received upload:

{ fields: { title: 'Hello World' },
  files:
   { upload:
      { size: 1558,
        path: '/tmp/1c747974a27a6292743669e91f29350b',
        name: 'us-flag.png',
        type: 'image/png',
        lastModifiedDate: Tue, 21 Jun 2011 07:02:41 GMT,
        _writeStream: [Object],
        length: [Getter],
        filename: [Getter],
        mime: [Getter] } } }


為了實現(xiàn)我們的功能,我們需要將上述代碼應(yīng)用到我們的應(yīng)用中,另外,我們還要考慮如何將上傳文件的內(nèi)容(保存在/tmp目錄中)顯示到瀏覽器中。

我們先來解決后面那個問題: 對于保存在本地硬盤中的文件,如何才能在瀏覽器中看到呢?

顯然,我們需要將該文件讀取到我們的服務(wù)器中,使用一個叫fs的模塊。

我們來添加/showURL的請求處理程序,該處理程序直接硬編碼將文件/tmp/test.png內(nèi)容展示到瀏覽器中。當(dāng)然了,首先需要將該圖片保存到這個位置才行。

將requestHandlers.js修改為如下形式:

復(fù)制代碼 代碼如下:

var querystring = require("querystring"),
    fs = require("fs");

function start(response, postData) {
  console.log("Request handler 'start' was called.");

  var body = '<html>'+
    '<head>'+
    '<meta http-equiv="Content-Type" '+
    'content="text/html; charset=UTF-8" />'+
    '</head>'+
    '<body>'+
    '<form action="/upload" method="post">'+
    '<textarea name="text" rows="20" cols="60"></textarea>'+
    '<input type="submit" value="Submit text" />'+
    '</form>'+
    '</body>'+
    '</html>';

    response.writeHead(200, {"Content-Type": "text/html"});
    response.write(body);
    response.end();
}

function upload(response, postData) {
  console.log("Request handler 'upload' was called.");
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.write("You've sent the text: "+
  querystring.parse(postData).text);
  response.end();
}

function show(response, postData) {
  console.log("Request handler 'show' was called.");
  fs.readFile("/tmp/test.png", "binary", function(error, file) {
    if(error) {
      response.writeHead(500, {"Content-Type": "text/plain"});
      response.write(error + "\n");
      response.end();
    } else {
      response.writeHead(200, {"Content-Type": "image/png"});
      response.write(file, "binary");
      response.end();
    }
  });
}

exports.start = start;
exports.upload = upload;
exports.show = show;


我們還需要將這新的請求處理程序,添加到index.js中的路由映射表中:
復(fù)制代碼 代碼如下:

var server = require("./server");
var router = require("./router");
var requestHandlers = require("./requestHandlers");

var handle = {}
handle["/"] = requestHandlers.start;
handle["/start"] = requestHandlers.start;
handle["/upload"] = requestHandlers.upload;
handle["/show"] = requestHandlers.show;

server.start(router.route, handle);


重啟服務(wù)器之后,通過訪問http://localhost:8888/show,就可以看到保存在/tmp/test.png的圖片了。

好,最后我們要的就是:

在/start表單中添加一個文件上傳元素
將node-formidable整合到我們的upload請求處理程序中,用于將上傳的圖片保存到/tmp/test.png
將上傳的圖片內(nèi)嵌到/uploadURL輸出的HTML中
第一項很簡單。只需要在HTML表單中,添加一個multipart/form-data的編碼類型,移除此前的文本區(qū),添加一個文件上傳組件,并將提交按鈕的文案改為“Upload file”即可。 如下requestHandler.js所示:

復(fù)制代碼 代碼如下:

var querystring = require("querystring"),
    fs = require("fs");

function start(response, postData) {
  console.log("Request handler 'start' was called.");

  var body = '<html>'+
    '<head>'+
    '<meta http-equiv="Content-Type" '+
    'content="text/html; charset=UTF-8" />'+
    '</head>'+
    '<body>'+
    '<form action="/upload" enctype="multipart/form-data" '+
    'method="post">'+
    '<input type="file" name="upload">'+
    '<input type="submit" value="Upload file" />'+
    '</form>'+
    '</body>'+
    '</html>';

    response.writeHead(200, {"Content-Type": "text/html"});
    response.write(body);
    response.end();
}

function upload(response, postData) {
  console.log("Request handler 'upload' was called.");
  response.writeHead(200, {"Content-Type": "text/plain"});
  response.write("You've sent the text: "+
  querystring.parse(postData).text);
  response.end();
}

function show(response, postData) {
  console.log("Request handler 'show' was called.");
  fs.readFile("/tmp/test.png", "binary", function(error, file) {
    if(error) {
      response.writeHead(500, {"Content-Type": "text/plain"});
      response.write(error + "\n");
      response.end();
    } else {
      response.writeHead(200, {"Content-Type": "image/png"});
      response.write(file, "binary");
      response.end();
    }
  });
}

exports.start = start;
exports.upload = upload;
exports.show = show;


很好。下一步相對比較復(fù)雜。這里有這樣一個問題: 我們需要在upload處理程序中對上傳的文件進(jìn)行處理,這樣的話,我們就需要將request對象傳遞給node-formidable的form.parse函數(shù)。

但是,我們有的只是response對象和postData數(shù)組。看樣子,我們只能不得不將request對象從服務(wù)器開始一路通過請求路由,再傳遞給請求處理程序。 或許還有更好的方案,但是,不管怎么說,目前這樣做可以滿足我們的需求。

到這里,我們可以將postData從服務(wù)器以及請求處理程序中移除了 —— 一方面,對于我們處理文件上傳來說已經(jīng)不需要了,另外一方面,它甚至可能會引發(fā)這樣一個問題: 我們已經(jīng)“消耗”了request對象中的數(shù)據(jù),這意味著,對于form.parse來說,當(dāng)它想要獲取數(shù)據(jù)的時候就什么也獲取不到了。(因為Node.js不會對數(shù)據(jù)做緩存)

我們從server.js開始 —— 移除對postData的處理以及request.setEncoding (這部分node-formidable自身會處理),轉(zhuǎn)而采用將request對象傳遞給請求路由的方式:

復(fù)制代碼 代碼如下:

var http = require("http");
var url = require("url");

function start(route, handle) {
  function onRequest(request, response) {
    var pathname = url.parse(request.url).pathname;
    console.log("Request for " + pathname + " received.");
    route(handle, pathname, response, request);
  }

  http.createServer(onRequest).listen(8888);
  console.log("Server has started.");
}

exports.start = start;
接下來是 router.js —— 我們不再需要傳遞postData了,這次要傳遞request對象:

function route(handle, pathname, response, request) {
  console.log("About to route a request for " + pathname);
  if (typeof handle[pathname] === 'function') {
    handle[pathname](response, request);
  } else {
    console.log("No request handler found for " + pathname);
    response.writeHead(404, {"Content-Type": "text/html"});
    response.write("404 Not found");
    response.end();
  }
}

exports.route = route;


現(xiàn)在,request對象就可以在我們的upload請求處理程序中使用了。node-formidable會處理將上傳的文件保存到本地/tmp目錄中,而我們需要做的是確保該文件保存成/tmp/test.png。 沒錯,我們保持簡單,并假設(shè)只允許上傳PNG圖片。

這里采用fs.renameSync(path1,path2)來實現(xiàn)。要注意的是,正如其名,該方法是同步執(zhí)行的, 也就是說,如果該重命名的操作很耗時的話會阻塞。 這塊我們先不考慮。

接下來,我們把處理文件上傳以及重命名的操作放到一起,如下requestHandlers.js所示:

復(fù)制代碼 代碼如下:

var querystring = require("querystring"),
    fs = require("fs"),
    formidable = require("formidable");

function start(response) {
  console.log("Request handler 'start' was called.");

  var body = '<html>'+
    '<head>'+
    '<meta http-equiv="Content-Type" content="text/html; '+
    'charset=UTF-8" />'+
    '</head>'+
    '<body>'+
    '<form action="/upload" enctype="multipart/form-data" '+
    'method="post">'+
    '<input type="file" name="upload" multiple="multiple">'+
    '<input type="submit" value="Upload file" />'+
    '</form>'+
    '</body>'+
    '</html>';

    response.writeHead(200, {"Content-Type": "text/html"});
    response.write(body);
    response.end();
}

function upload(response, request) {
  console.log("Request handler 'upload' was called.");

  var form = new formidable.IncomingForm();
  console.log("about to parse");
  form.parse(request, function(error, fields, files) {
    console.log("parsing done");
    fs.renameSync(files.upload.path, "/tmp/test.png");
    response.writeHead(200, {"Content-Type": "text/html"});
    response.write("received image:<br/>");
    response.write("<img src='/show' />");
    response.end();
  });
}

function show(response) {
  console.log("Request handler 'show' was called.");
  fs.readFile("/tmp/test.png", "binary", function(error, file) {
    if(error) {
      response.writeHead(500, {"Content-Type": "text/plain"});
      response.write(error + "\n");
      response.end();
    } else {
      response.writeHead(200, {"Content-Type": "image/png"});
      response.write(file, "binary");
      response.end();
    }
  });
}

exports.start = start;
exports.upload = upload;
exports.show = show;


好了,重啟服務(wù)器,我們應(yīng)用所有的功能就可以用了。選擇一張本地圖片,將其上傳到服務(wù)器,然后瀏覽器就會顯示該圖片。

總結(jié)與展望

恭喜,我們的任務(wù)已經(jīng)完成了!我們開發(fā)完了一個Node.js的web應(yīng)用,應(yīng)用雖小,但卻“五臟俱全”。 期間,我們介紹了很多技術(shù)點:服務(wù)端JavaScript、函數(shù)式編程、阻塞與非阻塞、回調(diào)、事件、內(nèi)部和外部模塊等等。

當(dāng)然了,還有許多本書沒有介紹到的: 如何操作數(shù)據(jù)庫、如何進(jìn)行單元測試、如何開發(fā)Node.js的外部模塊以及一些簡單的諸如如何獲取GET請求之類的方法。

但本書畢竟只是一本給初學(xué)者的教程 —— 不可能覆蓋到所有的內(nèi)容。

幸運的是,Node.js社區(qū)非?;钴S(作個不恰當(dāng)?shù)谋扔骶褪仟q如一群有多動癥小孩子在一起,能不活躍嗎?), 這意味著,有許多關(guān)于Node.js的資源,有什么問題都可以向社區(qū)尋求解答。 其中Node.js社區(qū)的wiki以及 NodeCloud就是最好的資源。

相關(guān)文章

  • JavaScript基礎(chǔ)教程——入門必看篇

    JavaScript基礎(chǔ)教程——入門必看篇

    下面小編就為大家?guī)硪黄狫avaScript基礎(chǔ)教程——入門必看篇。小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧
    2016-05-05
  • JavaScript中判斷兩個字符串是否相等的方法

    JavaScript中判斷兩個字符串是否相等的方法

    這篇文章主要介紹了JavaScript中判斷兩個字符串是否相等的方法,是JS入門學(xué)習(xí)中的基礎(chǔ)知識,需要的朋友可以參考下
    2015-07-07
  • js類式繼承的具體實現(xiàn)方法

    js類式繼承的具體實現(xiàn)方法

    這篇文章主要介紹了js類式繼承的具體實現(xiàn)方法,有需要的朋友可以參考一下
    2013-12-12
  • JavaScript從原型到原型鏈深入理解

    JavaScript從原型到原型鏈深入理解

    這篇文章主要介紹了從原型與原型鏈開始講起,如果你想知道構(gòu)造函數(shù)的實例的原型,原型的原型,原型的原型的原型是什么,就來看看這篇文章吧。下面小編就來帶大家一起學(xué)習(xí)一下
    2019-06-06
  • Javascript中的getUTCDay()方法使用詳解

    Javascript中的getUTCDay()方法使用詳解

    這篇文章主要介紹了Javascript中的getUTCDay()方法使用詳解,是JS入門學(xué)習(xí)中的基礎(chǔ)知識,需要的朋友可以參考下
    2015-06-06
  • parentElement,srcElement的使用小結(jié)

    parentElement,srcElement的使用小結(jié)

    本篇文章主要是對parentElement,srcElement的使用進(jìn)行了詳細(xì)的介紹,需要的朋友可以過來參考下,希望對大家有所幫助
    2014-01-01
  • 在javascript中創(chuàng)建對象的各種模式解析

    在javascript中創(chuàng)建對象的各種模式解析

    下面小編就為大家?guī)硪黄趈avascript中創(chuàng)建對象的各種模式解析。小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考,一起跟隨小編過來看看吧
    2016-05-05
  • 深入理解 JS 垃圾回收

    深入理解 JS 垃圾回收

    JS的垃圾回收機制是為了以防內(nèi)存泄漏,內(nèi)存泄漏的含義就是當(dāng)已經(jīng)不需要某塊內(nèi)存時這塊內(nèi)存還存在著,垃圾回收機制就是間歇的不定期的尋找到不再使用的變量,并釋放掉它們所指向的內(nèi)存。下面我們來一起深入學(xué)習(xí)一下吧
    2019-06-06
  • Javascript基礎(chǔ)教程之函數(shù)對象和屬性

    Javascript基礎(chǔ)教程之函數(shù)對象和屬性

    這篇文章主要介紹了Javascript基礎(chǔ)教程之函數(shù)對象和屬性,需要的朋友可以參考下
    2015-01-01
  • javascript 數(shù)組學(xué)習(xí)資料收集

    javascript 數(shù)組學(xué)習(xí)資料收集

    由于javascript 數(shù)組應(yīng)用比較廣泛,使用的朋友越來越多,腳本之家特為大家整理了一些js 數(shù)據(jù)方面的學(xué)習(xí)資料,大家看完了,基本上應(yīng)該對數(shù)組有個理解了。
    2010-04-04

最新評論