DIV CSS 佈局教程網

Node.js 微博實作踩坑筆記:把《Node.js 開發指南》範例遷移到 Express 4.x
編輯:關於JavaScript     

寫久了前端,第一次看到「用 JavaScript 寫後端」這種事,很難不興奮。但興奮歸興奮,後端的思維模式跟瀏覽器完全不同,一路走來踩到的坑,比程式碼本身還多。

我從《深入淺出 Node.js》入手,讀了幾章後結論是:書很好,但我還是寫不出東西。於是換成《Node.js 開發指南》,跳過前面幾章,直接挑戰第五章的微博範例。真正動手才發現,因為 Express 已經升到 4.x,書裡大量寫法都失效了——這對新手來說相當折磨。因此有了這篇「遷移記錄」。

一、Express 4 的破壞性變更

Express 4 最大的差異,是把大量中介軟體從核心中拆了出去,改由開發者自行安裝。這正是所有錯誤的根源。官方對新舊差異的說明可參考:https://scotch.io/bar-talk/expressjs-4-0-new-features-and-upgrading-from-3-0

問題 1:-t 參數失效

書中的建立指令已不能用:

express -t ejs microblog

Express 4 的預設模板引擎是 jade,要指定 ejs 得改寫成:

express -e ejs microblog

問題 2:3000 埠不會自動監聽

照書上執行 supervisor app.js 後拜訪 https://localhost:3000/ 只會一片空白。原因是新版 scaffolding 不再自動 listen,必須手動在 app.js 中補上:

 app.listen(3000);
 console.log('something happening');

問題 3:partials 被移除了

views 目錄下不會自動產生 layout.ejs,因為 Express 4 不再支援 ejs 的 partials 方法,需要額外安裝:

 npm install express-partials

並在 app.js 中註冊:

 var partials = require('express-partials');
 app.use(partials());

這段必須放在 app.set('view engine', 'ejs'); 之後。若放到 app.use('/', routes); 後面,會出現 CSS 載入失敗的怪現象。完成後即可建立 layout.ejs 並貼上書中範例,畫面就正常了。

二、資料庫連線一連串崩壞

前面那些都還算小事,真正的考驗在 MongoDB。使用前請先完成 MongoDB 安裝,Windows 環境可參考這篇:https://be-evil.org/install-mongodb-on-windows7.html

settings.js 照書寫沒問題,但 models/db.js 需要調整。書中的寫法:

 var settings = require('../settings');
 var Db = require('mongodb').Db;
 var Connection = require('mongodb').Connection;
 var Server = require('mongodb').Server;
 module.exports = new Db(settings.db, new Server(settings.host, Connection.DEFAULT_PORT, {}));

在 Express 4 環境下會直接報錯,必須補上 safe 選項:

 var settings = require('../settings'),
   Db = require('mongodb').Db,
   Connection = require('mongodb').Connection,
   Server = require('mongodb').Server;

 module.exports = new Db(settings.db,
   new Server(settings.host, Connection.DEFAULT_PORT, {}), { safe: true });

問題 4:模組路徑寫錯

接著 require('../settings') 又出問題:

因為 db.js 與 settings.js 同樣位於專案根目錄的下一層,相對路徑應該是:

 var settings = require('./settings');

問題 5:session 與 store 全部要自己裝

Express 4 把 session 也拆出去了,需要安裝 express-session 並改用新的引用方式(寫法參考:https://www.cnblogs.com/yumianhu/p/3709558.html):

 var session = require('express-session');
 var MongoStore = require('connect-mongo')(session);

原本的中介軟體註冊:

 app.use(express.session({ secret: settings.cookie_secret,
   store: new MongoStore({ db: settings.db }) }));

改寫為:

 app.use(session({ secret: settings.cookie_secret,
   store: new MongoStore({ db: settings.db }) }));

問題 6:dynamicHelpers 不存在了

書中用來把 user、error、success 注入視圖的 dynamicHelpers 已被移除,改以 res.locals 實作:

 app.use(function(req, res, next) {
  res.locals.user = req.session.user;
  res.locals.post = req.session.post;
  var error = req.flash('error');
  res.locals.error = error.length ? error : null;
  var success = req.flash('success');
  res.locals.success = success.length ? success : null;
  next();
});

問題 7:flash 需要獨立安裝

註冊頁面的錯誤提示用到 flash,Express 4 也不再內建:

 npm install connect-flash

然後在 app.js 補上:

 app.use(flash());

處理完這些,後續照書進行就大致順利了,最後終於跑出預期的畫面:

三、這趟遷移教我的事

整趟過程遇到的問題,幾乎全部來自同一個原因:框架把功能從核心中拆出去了。Express 4 的設計哲學是「核心極簡、其餘自選」,這讓框架更輕、更可替換,但代價是舊教學資料迅速失效。

給同樣在啃老書的建議:養成查官方 CHANGELOG 與 migration guide 的習慣,遇到 API 找不到時,先確認「它是不是被搬到獨立套件了」,往往比繼續 debug 有效得多。

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