從本質(zhì)上來說,一個 Express 應(yīng)用就是在調(diào)用各種中間件。
中間件是一個可訪問請求對象(req)和響應(yīng)對象(res)的函數(shù),在 Express 應(yīng)用的請求-響應(yīng)循環(huán)里,下一個內(nèi)聯(lián)的中間件通常用變量 next 表示。中間件的功能包括:
如果當(dāng)前中間件沒有終結(jié)請求-響應(yīng)循環(huán),則必須調(diào)用 next() 方法將控制權(quán)交給下一個中間件,否則請求就會掛起。
使用可選則掛載路徑,可在應(yīng)用級別或路由級別裝載中間件??裳b載一系列中間件函數(shù),在掛載點創(chuàng)建一個中間件系統(tǒng)棧。
Express 應(yīng)用可使用如下幾種中間件:
應(yīng)用級中間件綁定到 express 實例,使用 app.use() 和 app.VERB()。
var app = express();
// 沒有掛載路徑的中間件,應(yīng)用的每個請求都會執(zhí)行該中間件
app.use(function (req, res, next) {
console.log('Time:', Date.now());
next();
});
// 掛載至 /user/:id 的中間件,任何指向 /user/:id 的請求都會執(zhí)行它
app.use('/user/:id', function (req, res, next) {
console.log('Request Type:', req.method);
next();
});
// 路由和句柄函數(shù)(中間件系統(tǒng)),處理指向 /user/:id 的 GET 請求
app.get('/user/:id', function (req, res, next) {
res.send('USER');
});
下面這個例子展示了在一個掛載點裝載一組中間件。
// 一個中間件棧,對任何指向 /user/:id 的 HTTP 請求打印出相關(guān)信息
app.use('/user/:id', function(req, res, next) {
console.log('Request URL:', req.originalUrl);
next();
}, function (req, res, next) {
console.log('Request Type:', req.method);
next();
});
作為中間件系統(tǒng)的路由句柄,使得為路徑定義多個路由成為可能。在下面的例子中,為指向 /user/:id 的 GET 請求定義了兩個路由。第二個路由雖然不會帶來任何問題,但卻永遠不會被調(diào)用,因為第一個路由已經(jīng)終止了請求-響應(yīng)循環(huán)。
// 一個中間件棧,處理指向 /user/:id 的 GET 請求
app.get('/user/:id', function (req, res, next) {
console.log('ID:', req.params.id);
next();
}, function (req, res, next) {
res.send('User Info');
});
// 處理 /user/:id, 打印出用戶 id
app.get('/user/:id', function (req, res, next) {
res.end(req.params.id);
});
如果需要在中間件棧中跳過剩余中間件,調(diào)用 next('route') 方法將控制權(quán)交給下一個路由。需要注意的是 next('route') 只對使用 app.VERB() 或 router.VERB() 加載的中間件有效。
// 一個中間件棧,處理指向 /user/:id 的 GET 請求
app.get('/user/:id', function (req, res, next) {
// 如果 user id 為 0, 跳到下一個路由
if (req.params.id == 0) next('route');
// 負責(zé)將控制權(quán)交給棧中下一個中間件
else next(); //
}, function (req, res, next) {
// 渲染常規(guī)頁面
res.render('regular');
});
// 處理 /user/:id, 渲染一個特殊頁面
app.get('/user/:id', function (req, res, next) {
res.render('special');
});
路由級中間件和應(yīng)用級中間件一樣,只是它綁定的對象為 express.Router()。
var router = express.Router();
路由級使用 router.use() 或 router.VERB() 加載。
上述在應(yīng)用級創(chuàng)建的中間件系統(tǒng),可通過如下代碼改寫為路由級:
var app = express();
var router = express.Router();
// 沒有掛載路徑的中間件,通過該路由的每個請求都會執(zhí)行該中間件
router.use(function (req, res, next) {
console.log('Time:', Date.now());
next();
});
// 一個中間件棧,顯示任何指向 /user/:id 的 HTTP 請求的信息
router.use('/user/:id', function(req, res, next) {
console.log('Request URL:', req.originalUrl);
next();
}, function (req, res, next) {
console.log('Request Type:', req.method);
next();
});
// 一個中間件棧,處理指向 /user/:id 的 GET 請求
router.get('/user/:id', function (req, res, next) {
// 如果 user id 為 0, 跳到下一個路由
if (req.params.id == 0) next('route');
// 負責(zé)將控制權(quán)交給棧中下一個中間件
else next(); //
}, function (req, res, next) {
// 渲染常規(guī)頁面
res.render('regular');
});
// 處理 /user/:id, 渲染一個特殊頁面
router.get('/user/:id', function (req, res, next) {
console.log(req.params.id);
res.render('special');
});
// 將路由掛載至應(yīng)用
app.use('/', router);
錯誤處理中間件有 4 個參數(shù),定義錯誤處理中間件時必須使用這 4 個參數(shù)。即使不需要 next 對象,也必須在簽名中聲明它,否則中間件會被識別為一個常規(guī)中間件,不能處理錯誤。
錯誤處理中間件和其他中間件定義類似,只是要使用 4 個參數(shù),而不是 3 個,其簽名如下: (err, req, res, next)
app.use(function(err, req, res, next) {
console.error(err.stack);
res.status(500).send('Something broke!');
});
請參考錯誤處理一章了解更多關(guān)于錯誤處理中間件的內(nèi)容。
在 4.x 版本中,Express 已經(jīng)不再依賴 Connect。除了 express.static,Express 以前包括的中間件現(xiàn)在已經(jīng)在一個單獨的庫里,請參考中間件列表。
express.static 是 Express 唯一內(nèi)置的中間件,它基于 serve-static,負責(zé)在 Express 應(yīng)用中提供靜態(tài)資源。
參數(shù) root 指提供靜態(tài)資源的根目錄。
可選的 options 參數(shù)擁有如下屬性。
| 屬性 | 描述 | 類型 | 缺省值 |
|---|---|---|---|
dotfiles |
是否提供 dotfiles,可選值為 “allow”、“deny” 和 “ignore” | String | “ignore” |
etag |
是否啟用 etag 生成 | Boolean | true |
extensions |
設(shè)置文件擴展回退 | Boolean | false |
index |
發(fā)送目錄索引文件,設(shè)置為 false 禁用目錄索引。 |
Mixed | “index.html” |
lastModified |
設(shè)置 Last-Modified 頭為文件在操作系統(tǒng)上的最后修改日期??赡苤禐?true 或 false。 |
Boolean | true |
maxAge |
以毫秒或者其字符串格式設(shè)置 Cache-Control 頭的 max-age 屬性。 | Number | 0 |
redirect |
當(dāng)路徑為目錄時,重定向至 “/”。 | Boolean | true |
setHeaders |
設(shè)置 HTTP 頭以提供文件的函數(shù)。 | Function | ? |
下面的例子使用了 express.static 中間件,其中的 options 對象經(jīng)過了精心的設(shè)計。
var options = {
dotfiles: 'ignore',
etag: false,
extensions: ['htm', 'html'],
index: false,
maxAge: '1d',
redirect: false,
setHeaders: function (res, path, stat) {
res.set('x-timestamp', Date.now());
}
}
app.use(express.static('public', options));
每個應(yīng)用可有多個靜態(tài)目錄。
app.use(express.static('public'));
app.use(express.static('uploads'));
app.use(express.static('files'));
請參考 serve-static 文檔,了解更多關(guān)于 serve-static 和其選項的信息。
Express 是一款提供路由和中間件的 Web 框架,但其本身的功能卻異常精簡。Express 應(yīng)用的功能通過第三方中間件來添加。
安裝所需功能的 node 模塊,并在應(yīng)用中加載,可以在應(yīng)用級加載,也可以在路由級加載。
下面的例子安裝并加載了一個解析 cookie 的中間件: cookie-parser
$ npm install cookie-parser
var express = require('express');
var app = express();
var cookieParser = require('cookie-parser');
// 加載 cookie 解析中間件
app.use(cookieParser());
請參考 Third-party middleware 獲取 Express 中經(jīng)常用到的第三方中間件列表。