很多人第一次跑 Express,能跑出 Hello World,卻說不出每一行在做什麼。這篇就把 app.js 從頭到尾拆開來看。
裝了 npm 的話一行搞定:
複製代碼 代碼如下:
npm install express -gd
-g 表示裝到 NODE_PATH 的 lib 目錄下,-d 表示連相依套件一起裝。不加 -g 則會裝進當前目錄的 node_modules 資料夾。兩者差異可以用這兩行對照:
複製代碼 代碼如下:
npm list -g npm list
沒有 npm 的話,也可以從 GitHub 把最新版 express clone 下來。接著建立實例:
複製代碼 代碼如下:
cd ~ express testapp cd testapp node app.js
這就得到一個 testapp 應用,app.js 是預設的進入點。
複製代碼 代碼如下:
var express = require('express');
var app = module.exports = express.createServer();
require() 是 Node 提供的模塊載入函數,預設會在 $NODE_PATH 與當前 js 所在目錄的 node_modules 下尋找模塊,也可以載入自己寫的模塊。第二行的 express.createServer() 建立 HTTP 服務;module.exports 屬於 Node 的模塊機制,讓其他檔案能引用這個 app 實例。
Express 繼承自 Connect 模塊,所以 node_modules 裡若沒有 connect 是跑不起來的。
複製代碼 代碼如下:
app.set('views', __dirname + '/views');
app.set('view engine', 'jade');
__dirname 是 Node 的全域變量,代表當前執行的 js 所在路徑(__filename 則是完整檔名)。這兩行設定了模板檔的位置與渲染引擎。除了 Jade,Express 還支援 EJS、Haml、CoffeeScript、jQuery template 等。
複製代碼 代碼如下:
app.use(express.bodyParser()); app.use(express.methodOverride()); app.use(app.router); app.use(express.static(__dirname + '/public'));
express.bodyParser():Connect 內建中間件,把 client 送來的 POST 內容解析進 request.body。express.methodOverride():協助把 POST 請求偽裝成 PUT、DELETE 等其他 HTTP 方法。app.router:路由處理。官方文件說這行可有可無,實測確實如此,但寫上無妨。express.static():處理靜態請求,指定資料夾內的 css、js、圖片會直接作為靜態資源輸出。複製代碼 代碼如下:
app.configure('development', function(){
app.use(express.errorHandler({ dumpExceptions: true, showStack: true }));
});
app.configure('production', function(){
app.use(express.errorHandler());
});
express.errorHandler() 是 Connect 內建的錯誤處理中間件。這裡順帶說明了 app.configure() 的另一個用法:第一個參數是執行環境名稱,Node 透過 NODE_ENV 環境變數判定,例如 NODE_ENV=production node app.js 就進入 production 模式。開發環境把例外資訊全部 dump 出來方便除錯,正式環境則要收起來,這是基本的安全常識。
複製代碼 代碼如下:
app.get('/', function(req, res){
res.render('index', {
title: 'Express'
});
});
意思是:GET 請求根目錄時,渲染 views 裡的 index 模板,並傳入參數 title 為 "Express",這個值在模板中可直接使用。
處理 POST 則用 app.post():
複製代碼 代碼如下:
app.post('/add', function(req,res){
res.render('add', {
sum: req.body.a + req.body.b
});
});
req.body 就是前面 express.bodyParser() 解析後的結果。此外還有 app.all(),用來攔截所有方法的請求。
複製代碼 代碼如下:
app.listen(3000); console.log( "Express server listening on port %d in %s mode", app.address().port, app.settings.env);
讀完這一段,app.js 裡就不再有看不懂的行了。順帶一提,本文所述為 Express 2.x 的寫法(express.createServer()、express.bodyParser() 等);Express 4 之後這些 API 已大幅調整,中間件需另行安裝,閱讀舊教學時要多留意版本差異。
轉自 JS8.IN ™