DIV CSS 佈局教程網

Node.js Connect 中間件筆記(一):概念與內建模組
編輯:關於JavaScript     

寫 Node.js Web 服務時,一定會反覆遇到「請求進來後要做一堆前置處理」的需求:記錄日誌、解析 Cookie、還原表單內容、服務靜態檔案……如果每個功能都自己動手,程式碼很快就失控。Connect 就是為了解這個問題而生的。

一、什麼是「中間件」?

可以把中間件想成一層層的過濾網。如果把一次 HTTP 處理過程比喻成污水處理流程,請求就像水,會依序通過每一層過濾網;每個中間件在過程中改寫 request 或(及)response 的內容與狀態,藉此完成一項特定功能。

也就是說,中間件本質上是「介於客戶端與應用程式之間,負責處理請求與回應的一組方法」。

二、什麼是 Connect?

Connect 可以理解成「一堆中間件的集合體」。每個請求進來時,Connect 會讓請求依序通過中間件鏈,而每一個中間件都能拿到 HTTP 請求物件。

Connect 作者 T.J. Holowaychuk 把中間件分成兩種類型:

  • 過濾器(filter):處理請求但不回應它,例如伺服器日誌記錄。
  • 供應器(provider):會針對請求做出回應。你可以串接多個中間件,請求會一路往下傳,直到某個中間件決定回應它為止。

三、內建模組介紹

(1)cookieParser:Cookie 解析

解析 Cookies 標頭,結果放在 req.cookies;若傳入 secret,還可以對 Cookie 進行簽章加密。

var connect = require('./lib/connect');
var app = connect()
  .use(connect.cookieParser('secret string'))
  .use(function (req, res, next){
      req.cookies.website = "hi, i am bigbear !";
      res.end(JSON.stringify(req.cookies));
  }).listen(8888);

(2)session:會話管理

依賴 cookieParser。主要參數 options 包含:

  • key:Cookie 名稱,預設 connect.sid。
  • store:session 儲存實例。
  • secret:session cookie 的加密金鑰。
  • cookie:session cookie 設定,預設 {path: '/', httpOnly: true, maxAge: null}。
  • proxy:透過 x-forwarded-proto 實作反向代理下的安全 cookie。

其中 cookie.maxAge 預設為 null,代表瀏覽器關閉後 cookie 即被刪除。

var connect = require('./lib/connect');
var app = connect()
  .use(connect.logger('dev'))
  .use(connect.cookieParser())
  .use(connect.session({ secret: '123', cookie: { maxAge: 60000 } }))
  .use(function (req, res, next) {
      if (req.session.pv) {
          res.setHeader('Content-Type', 'text/html');
          res.write('views: ' + req.session.pv);
          res.end();
          req.session.pv++;
      } else {
          req.session.pv = 1;
          res.end('Refresh');
      }
  })
  .listen(8888);

效果是:客戶端每刷新一次,頁面上的 PV 數字就遞增一次,狀態由服務端 session 維護。

(3)bodyParser:請求內容解析

支援 application/json、application/x-www-form-urlencoded、multipart/form-data 等多種型別,解析後的結果放在 req.body。

var connect = require('connect');
var app = connect()
    .use(connect.bodyParser())
    .use(function(req, res) {
        res.end('req.body=>' + JSON.stringify(req.body));
    })
    .listen(8888);

四、對比實例:中間件帶來的好處

同樣是「提供靜態檔案服務」,用 Connect 只要一行:

/*
 * 使用 connect 實現的靜態檔案處理
 */
var connect = require('connect');
connect(connect.static(__dirname + '/public')).listen(
    8888,
    function() {
        console.log('Connect started on port 8888');
    }
);

若改用 Node 原生 API,程式碼量立刻暴增:

/*
 * 使用 node 原生 api 實現
 */
var http = require('http');
http.createServer(
    function(req, res) {
        var url = require('url');
        var fs = require('fs');
        var pathname = __dirname + '/public' + url.parse(req.url).pathname;
        // 讀取本地檔案
        fs.readFile(
            pathname,
            function(err, data) {
                // 異常處理
                if (err) {
                    res.writeHead(500);
                    res.end('500');
                }
                else {
                    res.end(data);
                }
            }
        );
    }
).listen(
    8888,
    function() {
        console.log('Http Server started on port 8888');
    }
);

更關鍵的是,原生版本寫了這麼多行,仍有許多面向未被處理:404 等異常狀態、基本的檔案路徑安全驗證(否則等於把整个作業系統檔案系統都暴露出去)、全域異常處理等等。而 Connect 的 static 中間件已經把這些都處理妥當。

五、小結

  1. 理解中間件的流式處理模型:請求依序穿過 use 註冊的每一層。
var app = connect();
app.use(connect.staticCache());
app.use(connect.static(__dirname + '/public'));
app.use(connect.cookieParser());
app.use(connect.session());
app.use(connect.query());
app.use(connect.bodyParser());
app.use(connect.csrf());
app.use(function (req, res, next) {
  // 中間件
});
app.listen(8888);

  1. 對比原生實作與中間件實作的差異,理解框架替你省下了哪些防禦性程式碼。
  2. 從上述幾個例子掌握用途與使用時機,再搭配官方文件把其餘中間件逐一熟悉。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved