DIV CSS 佈局教程網

NodeJS 學習筆記:Http 模塊詳解
編輯:關於JavaScript     

HTTP 是通用協議,不綁定任何特定語言,各家語言的實現細節不同但思想一致。NodeJS 作為宿主運行環境,以 JavaScript 為宿主語言,自然也有一套自己的實現。動手之前,建議先掃一遍官方 API 文檔建立前置概念,會省下不少摸索的功夫。

一、從最小伺服器開始

建立 server.js:

var http = require('http');
var server = http.createServer(function (req, res) {
  res.writeHeader(200, {
    'Content-Type': 'text/plain;charset=utf-8'   // 別忘了 charset
  });
  res.end("Hello, 大熊!");
});
server.listen(8888);
console.log("http server running on port 8888 ...");

執行 node server.js,成果如下:

二、逐行拆解這個例子

第一行透過 require 引入 Node 自帶的 http 模塊並賦值給變數。

第二行呼叫 http.createServer,它會回傳一個新的 web 伺服器物件。參數 requestListener 是一個函式,會被自動加入 request 事件的監聽隊列。每當有請求到來,事件迴圈就把這個監聽器放進執行隊列——Node 中所有的代碼都是一個一個從執行隊列裡拿出來執行的,且都在同一個工作線程上運行,這也是我們常說 Node 是單線程執行環境的由來。

再看這個回調函式,它收到兩個參數:request 與 response。要留意的是每個連接可能包含多個請求(keep-alive 連接就是如此)。request 是 http.IncomingMessage 的實例,response 是 http.ServerResponse 的實例。

這裡有個必須記牢的結論:http request 對象是可讀流,http response 對象則是可寫流。 IncomingMessage 由 http.Server 或 http.ClientRequest 創建,分別傳給 request 與 response 事件,除了標準的 Stream 接口之外,還提供了一些額外的事件、方法與屬性用來讀取狀態、標頭與資料。

writeHeader 這一步用 response.writeHead() 送出狀態碼 200 與 Content-Type 標頭。其中 statusCode 是三位的 HTTP 狀態碼,最後一個參數 headers 則是響應標頭的內容:

var body = 'hello world';
response.writeHead(200, {
  'Content-Length': body.length,
  'Content-Type': 'text/plain'
});

注意:Content-Length 是按位元組計算,而不是按字符計算。上面的例子之所以沒問題,是因為字串剛好只包含單位元組字符。若 body 含多位元組字符(例如中文),就該改用 Buffer.byteLength() 來取得實際位元組數。另外要提醒的是,Node 並不會主動檢查 Content-Length 與實際傳輸的 body 長度是否吻合,這件事得由開發者自己負責。

至於狀態碼的說明,http.STATUS_CODES 收錄了所有標準 HTTP 響應狀態碼及其簡短描述,源碼节选如下(節錄自 Nodejs 源碼 http.js):

var STATUS_CODES = exports.STATUS_CODES = {
  100 : 'Continue',
  101 : 'Switching Protocols',
  200 : 'OK',
  201 : 'Created',
  204 : 'No Content',
  206 : 'Partial Content',
  301 : 'Moved Permanently',
  302 : 'Moved Temporarily',
  304 : 'Not Modified',
  400 : 'Bad Request',
  401 : 'Unauthorized',
  403 : 'Forbidden',
  404 : 'Not Found',
  405 : 'Method Not Allowed',
  408 : 'Request Time-out',
  418 : 'I\'m a teapot',        // RFC 2324
  500 : 'Internal Server Error',
  502 : 'Bad Gateway',
  503 : 'Service Unavailable',
  504 : 'Gateway Time-out'
  // ……其餘狀態碼同樣定義在此物件中
};

從客戶端的響應結果也能印證這一點:

response.end 的作用是:當所有響應標頭與報文都送出後,向伺服器發出完成信號。每次響應結束都必須呼叫它;若呼叫時帶了 data 參數,效果等同於先執行 response.write(data, encoding) 再執行 response.end()。

server.listen(8888) 則讓伺服器在指定埠上接受連接。

三、讀取請求體:一個 POST 範例

除了用 request 物件讀取請求標頭,還能把它當作一個只讀數據流來讀取請求體:

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 () {
    body = Buffer.concat(body);
    console.log(body.toString());
  });
}).listen(8888);

這裡的關鍵是先把每個 chunk 推入陣列,等 end 事件觸發後再用 Buffer.concat 合併,避免直接做字串拼接時可能出現的多位元組字符被截斷問題。

對應的完整 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

四、重點回顧

理解 HTTP 協議本身;熟練使用相關 API;注意 GET 與 POST 在處理細節上的差異;透徹理解 requestListener 在事件迴圈中的位置。最後再強調一次:request 是可讀流,response 是可寫流——這個特性直接決定了後續處理檔案上傳、串流回應等場景的寫法。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved