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