HTTP模塊常用的API有哪些？

HTTP服務(wù)器本質(zhì)上也是一個Socket服務(wù)器，可以理解為在Socket服務(wù)器的基礎(chǔ)上進行了一些封裝，簡化了一些操作。本節(jié)將對HTTP模塊提供的API進行詳細介紹。

1. http.Server

在Node.js中，HTTP服務(wù)器是指http.Server對象，用Node.js做的所有基于HTTP協(xié)議的系統(tǒng)，如網(wǎng)站、社交應(yīng)用甚至代理服務(wù)器，都是基于http.Server實現(xiàn)的。它提供了一套封裝級別很低的API，僅僅是流控制和簡單的消息解析，所有的高層功能都要通過它的接口來實現(xiàn)。創(chuàng)建http.Server對象的語法如下：

    Var server = http.createServer();

在上述代碼中，使用creatServer()函數(shù)創(chuàng)建的server對象就是一個http.Server對象。

http.Server是一個基于事件的HTTP服務(wù)器，繼承自EventEmitter,所有的請求都被封裝為獨立的事件，開發(fā)者只需要對它的事件編寫相應(yīng)函數(shù)即可實現(xiàn)HTTP服務(wù)器的所有功能。http.Server提供了一些函數(shù)，具體如下：

(1)server.close([callback])：服務(wù)器停止已經(jīng)開始的監(jiān)聽。

(2) server.listen(port[, hostname][, backlog][, callback])。

server.listen參數(shù)說明如下：

●port：指定監(jiān)聽的端口。

● hostname：指定主機名。

●backlog：指定被允許進行排隊的最大待處理連接數(shù)，默認是511。

●callback：指定該服務(wù)器已經(jīng)開始在指定的端口上監(jiān)聽時，要執(zhí)行的回調(diào)處理函數(shù)。

（3）)server listen(handle[,callback])和server.listen(path[,callback])：監(jiān)聽文件系統(tǒng)的連接。第一個是監(jiān)聽已打開文件描述句柄，第二個是要監(jiān)聽一個文件的路徑。除此之外，http.Server 還提供了3個事件，具體如下：

（1）request：當(dāng)客戶端請求到來時，該事件被觸發(fā)，提供兩個參數(shù)req和res，分別為http.ServerRequest和http.ServerResponse的實例，表示請求和響應(yīng)信息。

（2）connection：當(dāng)TCP連接建立時，該事件被觸發(fā)，提供一個參數(shù)socket,為net.Socket 的實例。connection事件的粒度要大于request,因為客戶端在Keep-Alive模式下可能會在同一個連接內(nèi)發(fā)送多次請求。

（3）close：當(dāng)服務(wù)器關(guān)閉時，該事件被觸發(fā)。注意不是在用戶連接斷開時。除此之外,還有checkContinue、upgrade、clientError事件,通常不需要關(guān)心,只有在實現(xiàn)復(fù)雜的HTTP服務(wù)器時才會用到。

2. http.IncomingMessage 對象

在HTTP 服務(wù)器和客戶端都會創(chuàng)建http.IncomingMessage對象，它一般由http.Server的request事件發(fā)送，作為第一個參數(shù)傳遞，通常簡稱為request或req。在發(fā)送HTTP 請求時,會發(fā)送請求報文，http.IncomingMessage對象實現(xiàn)了一個可讀流，在服務(wù)器端，http.IncomingMessage 提供了一個close 事件，用戶當(dāng)前請求結(jié)束時，也就是底層的套接字被關(guān)閉時該事件被觸發(fā)。另外，http.IncomingMessage對象中還提供了一些函數(shù)和屬性，用來獲取客戶端請求和服務(wù)器端響應(yīng)的一些信息，如下表所示。

表7-2 http.IncomingMessage 對象的常用函數(shù)和屬性

3. http.ServerResponse

htp.ServerResponse是返回給客戶端的信息，決定了用戶最終能看到的結(jié)果。它也是由http.Server的request事件發(fā)送的，作為第二個參數(shù)傳遞，一般簡稱為response或res。

http.ServerResponse是一個可寫流，用來給客戶端的Socket發(fā)送響應(yīng)報文，在服務(wù)器做出響應(yīng)之前會發(fā)送響應(yīng)報文,http.ServerResponse中有3個重要的成員函數(shù)，前兩個用于返回對應(yīng)響應(yīng)報文的響應(yīng)頭和響應(yīng)內(nèi)容，最后一個用于結(jié)束請求，具體如下：

(1)response.writeHead(statusCode,[headers])：向請求的客戶端發(fā)送響應(yīng)頭。status-Code是HTTP狀態(tài)碼，如200(請求成功)、404(未找到)等。headers是一個類似關(guān)聯(lián)數(shù)組的對象，表示響應(yīng)頭的每個屬性。該函數(shù)在一個請求內(nèi)最多只能調(diào)用一次，如果不調(diào)用，則會自動生成一個響應(yīng)頭。

(2)response.write(data,[encoding])：向請求的客戶端發(fā)送響應(yīng)內(nèi)容。data是一個Buffer或字符串，表示要發(fā)送的內(nèi)容。如果data是字符串，那么需要指定encoding來說明它的編碼方式，默認是utf-8。在response.end 調(diào)用之前，response.write可以被多次調(diào)用。

(3)response.end([data],[encoding])：結(jié)束響應(yīng)，告知客戶端所有發(fā)送已經(jīng)完成。當(dāng)所有返回的內(nèi)容發(fā)送完畢時，該函數(shù)必須被調(diào)用一次。它接收兩個可選參數(shù)，意義和response.write相同。如果不調(diào)用該函數(shù)，客戶端將永遠處于等待狀態(tài)。除上述成員函數(shù)外，還有一些函數(shù)和屬性可供開發(fā)者使用，如表7-3所示。

表7-3 http.ServerResponse其他函數(shù)和屬性