Node.js 提供了 http 模塊,其中分裝了一個高效的 HTTP 服務(wù)器和一個簡易的客戶端:
- 作為服務(wù)端使用時,創(chuàng)建一個HTTP服務(wù)器,監(jiān)聽HTTP客戶端請求并返回響應。
- 作為客戶端使用時,發(fā)起一個HTTP客戶端請求,獲取服務(wù)端響應。
http 服務(wù)器
要開發(fā)HTTP服務(wù)器程序,從頭處理TCP連接,解析HTTP是不現(xiàn)實的。這些工作實際上已經(jīng)由Node.js自帶的http模塊完成了。應用程序并不直接和HTTP協(xié)議打交道,而是操作http模塊提供的request和response對象。
request 對象封裝了HTTP請求,我們調(diào)用request對象的屬性和方法就可以拿到所有HTTP請求的信息;
response對象封裝了HTTP響應,我們操作response對象的方法,就可以把HTTP響應返回給瀏覽器。
此處應該有代碼案例
http.Server 的事件
http.Server 是一個基于事件的 HTTP 服務(wù)器,所有的請求都被封裝為獨立的事件,開發(fā)者只需要對它的事件編寫響應函數(shù)即可實現(xiàn) HTTP 服務(wù)器的所有功能。它繼承自EventEmitter,提供了以下幾個事件:
- request:當客戶端請求到來時,該事件被觸發(fā),提供兩個參數(shù) req 和res,分別是http.ServerRequest 和 http.ServerResponse 的實例,表示請求和響應信息。
- connection:當 TCP 連接建立時,該事件被觸發(fā),提供一個參數(shù) socket,為net.Socket 的實例。connection 事件的粒度要大于 request,因為客戶端在Keep-Alive 模式下可能會在同一個連接內(nèi)發(fā)送多次請求。
- close :當服務(wù)器關(guān)閉時,該事件被觸發(fā)。注意不是在用戶連接斷開時。除此之外還有 checkContinue、upgrade、clientError 事件,通常我們不需要關(guān)心,只有在實現(xiàn)復雜的 HTTP 服務(wù)器的時候才會用到。
在這些事件中, 最常用的就是 request 了, 因此 http 提供了一個捷徑:http.createServer([requestListener]) , 功能是創(chuàng)建一個 HTTP 服務(wù)器并將requestListener 作為 request 事件的監(jiān)聽函數(shù),這也是我們前面例子中使用的方法。
var http=require('http');
var server=new http.Server();
server.on('request',function(req,res){
res.writeHead(200,{'Content-Type':'text/html'});
res.end('<p>HelloWorld</p>');
});
server.listen(3000);
console.log('HTTP SERVER is LISTENING AT PORT 3000.');
http.ServerRequest
http.ServerRequest 是 HTTP 請求的信息,是后端開發(fā)者最關(guān)注的內(nèi)容。它一般由http.Server 的 request 事件發(fā)送,作為第一個參數(shù)傳遞,通常簡稱 request 或 req。
HTTP 請求一般可以分為兩部分:請求頭(Request Header)和請求體(Requset Body)。以上內(nèi)容由于長度較短都可以在請求頭解析完成后立即讀取。而請求體可能相對較長,需要一定的時間傳輸,因此 http.ServerRequest 提供了以下3個事件用于控制請求體傳輸:
- data :當請求體數(shù)據(jù)到來時,該事件被觸發(fā)。該事件提供一個參數(shù) chunk,表示接收到的數(shù)據(jù)。如果該事件沒有被監(jiān)聽,那么請求體將會被拋棄。該事件可能會被調(diào)用多次。
- end :當請求體數(shù)據(jù)傳輸完成時,該事件被觸發(fā),此后將不會再有數(shù)據(jù)到來。
- close: 用戶當前請求結(jié)束時,該事件被觸發(fā)。不同于 end,如果用戶強制終止了傳輸,也還是調(diào)用close。
獲取 GET 請求內(nèi)容
由于 GET 請求直接被嵌入在路徑中,URL是完整的請求路徑,包括了 ? 后面的部分,因此可以手動解析后面的內(nèi)容作為 GET請求的參數(shù)。Node.js 的 url 模塊中的 parse 函數(shù)提供了這個功能。
此處可以看例子
獲取 POST 請求內(nèi)容
POST 請求的內(nèi)容全部都在請求體中,http.ServerRequest 并沒有一個屬性內(nèi)容為請求體,原因是等待請求體傳輸可能是一件耗時的工作,譬如上傳文件。
很多時候我們可能并不需要理會請求體的內(nèi)容,惡意的 POST請求會大大消耗服務(wù)器的資源。所以 Node.js 默認是不會解析請求體的,當你需要的時候,需要手動來做。
var http = require('http');
var querystring = require('querystring');
var util = require('util');
http.createServer(function(req,res){
var post='';
req.on('data',function(chunk){
post += chunk;
});
req.on('end',function(){
post=querystring.parse(post);
res.end(util.inspect(post));
});
}).listen(3000);
http.ServerResponse
http.ServerResponse 是返回給客戶端的信息,決定了用戶最終能看到的結(jié)果。它也是由 http.Server 的 request 事件發(fā)送的,作為第二個參數(shù)傳遞,一般簡稱為response 或 res。http.ServerResponse 有三個重要的成員函數(shù),用于返回響應頭、響應內(nèi)容以及結(jié)束請求。
- response.writeHead(statusCode, [headers]):向請求的客戶端發(fā)送響應頭。statusCode 是 HTTP 狀態(tài)碼,如 200 (請求成功)、404 (未找到)等。headers是一個類似關(guān)聯(lián)數(shù)組的對象,表示響應頭的每個屬性。該函數(shù)在一個請求內(nèi)最多只能調(diào)用一次,如果不調(diào)用,則會自動生成一個響應頭。
- response.write(data, [encoding]):向請求的客戶端發(fā)送響應內(nèi)容。data 是一個 Buffer 或字符串,表示要發(fā)送的內(nèi)容。如果 data 是字符串,那么需要指定encoding 來說明它的編碼方式,默認是 utf-8。在 response.end 調(diào)用之前,response.write 可以被多次調(diào)用。
- response.end([data], [encoding]):結(jié)束響應,告知客戶端所有發(fā)送已經(jīng)完成。當要所有返回的內(nèi)容發(fā)送完畢的時候,該函數(shù) 必須 被調(diào)用一次。它接受兩個可選參數(shù),意義和 response.write 相同。如果不調(diào)用該函數(shù),客戶端將永遠處于等待狀態(tài)。
http客戶端
http 模塊提供了兩個函數(shù) http.request 和 http.get,功能是作為客戶端向 HTTP服務(wù)器發(fā)起請求。
http.request(options, callback) 發(fā)起 HTTP 請求。接受兩個參數(shù),option 是一個類似關(guān)聯(lián)數(shù)組的對象,表示請求的參數(shù),callback 是請求的回調(diào)函數(shù)。option常用的參數(shù)如下所示。
- host :請求網(wǎng)站的域名或 IP 地址。
- port :請求網(wǎng)站的端口,默認 80。
- method :請求方法,默認是 GET。
- path :請求的相對于根的路徑,默認是“/”。QueryString 應該包含在其中。例如 /search?query=byvoid。
- headers :一個關(guān)聯(lián)數(shù)組對象,為請求頭的內(nèi)容。
- callback 傳遞一個參數(shù),為 http.ClientResponse 的實例。
http.request 返回一個 http.ClientRequest 的實例。
var http=require('http');
var querystring=require('querystring');
var contents=querystring.stringify({
name:'TOM_SON',
email:'gxhacx@gmail.com',
address:'Changshu Dalian Load'
});
var options={
host:'www.httpvoid.com',
path:'/app/node/post.js',
method:'post',
headers:{
'Content-Type':'application/x-www-form-urlencoded',
'Content-Length':contents.length
}
};
var req=http.request(options,function(res){
res.setEncoding('utf-8');
res.on('data',function(data){
console.log(data);
});
});
req.write(contents);
req.end();
- http.get(options, callback) http 模塊還提供了一個更加簡便的方法用于處理GET請求:http.get。它是 http.request 的簡化版,唯一的區(qū)別在于http.get自動將請求方法設(shè)為了 GET 請求,同時不需要手動調(diào)用 req.end()。
1. http.ClientRequest
http.ClientRequest 是由 http.request 或 http.get 返回產(chǎn)生的對象,表示一個已經(jīng)產(chǎn)生而且正在進行中的 HTTP 請求。它提供一個 response 事件,即 http.request或 http.get 第二個參數(shù)指定的回調(diào)函數(shù)的綁定對象。我們也可以顯式地綁定這個事件的監(jiān)聽函數(shù)://httpresponse.js
var http = require('http');
var req = http.get({host: 'www.byvoid.com'});
req.on('response', function(res){
res.setEncoding('utf8');
res.on('data', function (data) {
console.log(data);
});
});
http.ClientRequest 像 http.ServerResponse 一樣也提供了 write 和 end 函數(shù),用于向服務(wù)器發(fā)送請求體,通常用于 POST、PUT 等操作。所有寫結(jié)束以后必須調(diào)用 end函數(shù)以通知服務(wù)器,否則請求無效。http.ClientRequest 還提供了以下函數(shù):
request.abort():終止正在發(fā)送的請求。
request.setTimeout(timeout, [callback]):設(shè)置請求超時時間,timeout 為毫秒數(shù)。當請求超時以后,callback 將會被調(diào)用。此外還有request.setNoDelay([noDelay])、request.setSocketKeepAlive([enable], [initialDelay]) 等函數(shù)。
2. http.ClientResponse
http.ClientResponse 與 http.ServerRequest 相似,提供了三個事件 data、end和 close,分別在數(shù)據(jù)到達、傳輸結(jié)束和連接結(jié)束時觸發(fā),其中 data 事件傳遞一個參數(shù)chunk,表示接收到的數(shù)據(jù)。
http.ClientResponse 還提供了以下幾個特殊的函數(shù):
response.setEncoding([encoding]):設(shè)置默認的編碼,當 data 事件被觸發(fā)時,數(shù)據(jù)將會以 encoding 編碼。默認值是 null,即不編碼,以 Buffer 的形式存儲。常用編碼為 utf8。
response.pause():暫停接收數(shù)據(jù)和發(fā)送事件,方便實現(xiàn)下載功能。
response.resume():從暫停的狀態(tài)中恢復。