一,開頭分析
首先「Http」這個概念大家應該比較熟悉了,它不是基於特定語言的,是一個通用的應用層協議,不同語言有不同的實現細節,但是萬變不離其宗,思想是相同的,
NodeJS作為一個宿主運行環境,以JavaScript為宿主語言,它也有自己實現的一套標準,這篇文章我們就一起來學習一下 “Http模組” 。但作為前提來說,
希望大家可以先閱讀一下官網提供的api,有一個前置了解,這樣就方便多了,以下是Http部分的api概覽:
HTTP
http.STATUS_CODES
http.createServer([requestListener])
http.createClient([連接埠], [主機])
類別:http.Server
事件 : '請求'
事件: '連結'
事件: '關閉'
事件:「檢查繼續」
事件:「連結」
事件:「升級」
事件:「客戶端錯誤」
server.listen(埠, [主機名稱], [積壓], [回呼])
server.listen(路徑, [回呼])
server.listen(句柄, [回呼])
server.close([回呼])
server.maxHeadersCount
server.setTimeout(毫秒, 回呼)
伺服器逾時
類別:http.ServerResponse
事件: '關閉'
response.writeContinue()
response.writeHead(statusCode, [reasonPhrase], [headers])
response.setTimeout(毫秒, 回呼)
回應.statusCode
response.setHeader(name, 值)
response.headersSent
回應.sendDate
response.getHeader(姓名)
response.removeHeader(姓名)
response.write(chunk, [編碼])
response.addTrailers(題)
response.end([資料], [編碼])
http.request(選項, 回呼)
http.get(選項, 回呼)
類別:http.Agent
新代理商([選項])
agent.maxSockets
agent.maxFreeSockets
代理.sockets
agent.freeSockets
代理.請求
agent.destroy()
agent.getName(選項)
http.globalAgent
類別:http.ClientRequest
事件「回應」
事件:「插座」
事件:「連結」
事件:「升級」
事件:「繼續」
request.write(chunk, [編碼])
request.end([資料], [編碼])
request.abort()
request.setTimeout(逾時, [回呼])
request.setNoDelay([noDelay])
request.setSocketKeepAlive([enable], [initialDelay])
http.IncomingMessage
事件: '關閉'
message.httpVersion
訊息.headers
message.rawHeaders
訊息.預告片
message.rawTrailers
message.setTimeout(毫秒, 回呼)
訊息.方法
訊息.url
message.statusCode
訊息.socket
讓我們先從一個簡單的例子開始,建立一個名為server.js的文件,並寫入以下程式碼:
var http = require('http') ;
var server = http.createServer(function(req,res){
res.writeHeader(200,{
'Content-Type' : 'text/plain;charset=utf-8' // 加入charset=utf-8
}) ;
res.end("Hello,大熊!") ;
}) ;
server.listen(8888) ;
console.log("http server running on port 8888 ...") ;
(node server.js)以下是運行結果:
二,細部分析實例
具體看一下這個小例子:
(1行):透過"require"引入NodeJS自帶的"http"模組,並且把它賦值給http變數。
(2行):呼叫http模組提供的函數:"createServer" 。這個函數會傳回一個新的web伺服器物件。
參數 "requestListener" 是一個函數,它將會自動加入到 "request" 事件的監聽佇列。
當一個request到來時,Event-Loop會將這個Listener回呼函數放入執行佇列, node中所有的程式碼都是一個一個從執行佇列中拿出來執行的。
這些執行都是在工作線程上(Event Loop本身可以認為在一個獨立的線程中,我們一般不提這個線程,而將node稱呼為一個單線程的執行環境),
所有的回呼都是在一個工作執行緒上運作。
我們在再看一下"requestListener"這個回呼函數,它提供了兩個參數(request,response),
每次收到一個請求時觸發。注意每個連線又可能有多個請求(在keep-alive的連線中)。
"request"是http.IncomingMessage的一個例子。 "response"是http.ServerResponse的一個實例。
一個http request物件是可讀流,而http response物件則是可寫流。
一個"IncomingMessage"物件是由http.Server或http.ClientRequest建立的,
並作為第一參數分別傳遞給"request"和"response"事件。
它也可以被用來存取應答的狀態,頭檔和資料。
它實作了 "Stream" 介面以及以下額外的事件,方法和屬性。 (具體參考api)。
(3行):“writeHeader”,使用 "response.writeHead()" 函數傳送一個Http狀態200和Http頭的內容型別(content-type)。
向請求回覆回應頭。 "statusCode"是三位是的HTTP狀態碼,例如 404 。最後一個參數,"headers",是回應頭的內容。
舉個栗子:
var body = 'hello world' ;
response.writeHead(200, {
'Content-Length': body.length,
'Content-Type': 'text/plain'
}) ;
注意:Content-Length 是以位元組(byte)計算,而不是以字元(character)計算。
之前的例子原因是字串 “Hello World !” 只包含了單字節的字元。
如果body包含了多字節編碼的字符,就應當使用Buffer.byteLength()來確定在多字節字符編碼情況下字符串的字節數。
需要進一步說明的是Node不檢查Content-Lenth屬性和已傳輸的body長度是否吻合。
statusCode是一個三位是的HTTP狀態碼, 例如:"404" 。這裡要說的是 "http.STATUS_CODES" ,全部標準"Http"回應狀態碼的集合和簡短描述都在裡面。
如下是原始碼參考:
var STATUS_CODES = 匯出。 STATUS_CODES = {
100:'繼續',
101:“切換協定”,
102 : '處理', // RFC 2518,且被 RFC 4918 捨棄
200:'好的',
201:“已建立”,
202:“已接受”,
203:“非權威資訊”,
204:“沒有內容”,
205:“重置內容”,
206:“部分內容”,
207 : '多重狀態', // RFC 4918
300:“多項選擇”,
301:“永久移動”,
302:“暫時移動”,
303:“查看其他”,
304:“未修改”,
305:“使用代理”,
307:“暫時重新導向”,
400:“錯誤請求”,
401:'未經授權',
402:“需要付款”,
403:“禁止”,
404:“未找到”,
405:“不允許的方法”,
406:“不可接受”,
407:“需要代理身份驗證”,
408:'請求超時',
409:“衝突”,
410:“走了”,
411:“需要長度”,
412:“前提條件失敗”,
413:“請求實體太大”,
414:“請求 URI 太大”,
415:“不支援的媒體類型”,
416:“請求的範圍無法滿足”,
417:“期望失敗”,
418:“我是茶壺”, // RFC 2324
422:“無法處理的實體”, // RFC 4918
423 : '鎖定', // RFC 4918
424:“依賴失敗”, // RFC 4918
425 : '無序集合', // RFC 4918
426:“需要升級”, // RFC 2817
500:“內部伺服器錯誤”,
501:“未實施”,
502:“錯誤網關”,
503:“服務不可用”,
504:“網關逾時”,
505 : '不支援 HTTP 版本',
506:“變體也協商”, // RFC 2295
507:“儲存空間不足”, // RFC 4918
509:“超出頻寬限制”,
510 : '未擴充' // RFC 2774
};
節其中,Nodejs源碼 ”http.js“ 143行開始。
其實從客戶端應答結果也難看出:
(6行):「response.end」-----當所有的回應標頭和封包發送完成時此方法將向伺服器發送訊號。伺服器會認為此訊息完成了。
完成回應之後必須呼叫該方法。如果指定了參數 “data” ,就相當於先呼叫 “response.write(data, encoding) ” 之後再呼叫 “response.end()” 。
(8行):」server.listen(8888)「 ------ 伺服器用指定的句柄接受連接,綁定在特定的連接埠。
以上就是一個比較詳細的分析過程,希望有助於加深快速理解,程式碼雖然很少,但是重在理解一些細節機制,以便日後的開發NodeJS應用。
三,實例
除了可以使用「request」物件存取請求頭資料外,還可以把「request」物件設為一個乙太網路資料流來存取請求體資料。
這是一個「POST」請求的範例:
http.createServer(function (request, response) {
var body = [];
console.log(request.method) ;
console.log(request.headers) ;
request.on('data', function (chunk) {
body.push(chunk);
}) ;
request.on('end', function () {
身體 = Buffer.concat(body) ;
console.log(body.toString()) ;
});
}).listen(8888) ;
下是一個完整的「Http」請求資料內容。
POST / HTTP/1.1
User-Agent: curl/7.26.0
Host: localhost
Accept: */*
Content-Length: 11
Content-Type: application/x-www-form-urlencoded
Hello World
四,總結一下
(1),理解 "Http" 概念。
(2),熟練使用 "Http" 相關的api。
(3),注意細節的把控,例如:「POST,GET」之間的處理細節。
(4),"requestListener"的理解。
(5),強調一個概念:一個http request物件是可讀流,而http response物件則是可寫流 。