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

可以把中間件想成一層層的過濾網。如果把一次 HTTP 處理過程比喻成污水處理流程,請求就像水,會依序通過每一層過濾網;每個中間件在過程中改寫 request 或(及)response 的內容與狀態,藉此完成一項特定功能。
也就是說,中間件本質上是「介於客戶端與應用程式之間,負責處理請求與回應的一組方法」。
Connect 可以理解成「一堆中間件的集合體」。每個請求進來時,Connect 會讓請求依序通過中間件鏈,而每一個中間件都能拿到 HTTP 請求物件。
Connect 作者 T.J. Holowaychuk 把中間件分成兩種類型:

解析 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);
依賴 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 維護。
支援 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 中間件已經把這些都處理妥當。
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);
