基于Node.js、Express和Jscex開發的ToDo網站示例

Jscex的主要使用場景是“JavaScript異步編程”，不過并沒有限制是跑在瀏覽器還是服務器端。最近Node.js很火熱，也剛發布了原生的Windows版，不少同學會用它來做一些網站這樣的小程序。目前用Node.js開發網站最著名的框架是Express，使用起來也是比較容易的。前段時間看到CNodeJS社區的一篇文章，有同學將一個Python寫的ToDo列表網站移植到了Node.js上，我為了推廣Jscex，就fork了這個項目，將其修改為基于Jscex的版本，大伙兒可以來比較一下。當然這個網站過于簡單，我也正在尋找更合適的項目。(網站制作)

51CTO推薦專題：Node.js專區

JavaScript是一個沒有阻塞特性的語言，因此各類API都會設計為異步，這對于服務器的伸縮性和客戶端網頁的響應能力都有好處，不過在程序編寫上就會遇到各種問題了。例如在ToDo示例中的一個簡單的處理函數，因為需要查詢數據庫，就要寫成帶回調的樣子：

1. exports.index = function (req, res, next) {  
2.     db.query('select * from todo order by finished asc, id asc limit 50', function (err, rows) {  
3.         if (err) return next(err);  
4.         res.render('index', { todos: rows });  
5.     });  
6. }; 

db變量用來操作MySQL數據庫，它的query方法傳入sql(可能還會有參數)并提供一個回調函數，用來提示錯誤或是返回查詢結果。在回調中我們必須判斷err是否存在，如果存在便調用next報告框架“出錯了”。每個異步操作都必須如此，試想如果在這個查詢后還有另一個查詢，則還需要進行一次嵌套和err判斷。每個處理函數都是如此，這也是異步編程的煩惱之一：難以進行統一的異常處理，處理代碼總是需要分散在各處，一不小心就變成“野異常”，還很難排查出來。

我將ToDo網站簡單地Jscex化了一下。首先讓MySQL的查詢能夠接入Jscex(libjscex.mysql.js)：

1. exports.jscexify = function (db) {  
2.     db.queryAsync = function () {  
3.         var _this = this;  
4.  
5.         var args = [];  
6.         for (var i = 0; i < arguments.length; i++) {  
7.             args.push(arguments[i]);  
8.         }  
9.  
10.         var delegate = {  
11.             onStart: function (callback) {  
12.  
13.                 args.push(function (err, result) {  
14.                     if (err) {  
15.                         callback("failure", err);  
16.                     } else {  
17.                         callback("success", result);  
18.                     }  
19.                 });  
20.  
21.                 _this.query.apply(_this, args);  
22.             }  
23.         };  
24.  
25.         return new Jscex.Async.Task(delegate);  
26.     }  
27. } 

一般來說，將一個異步接口給Jscex化并不需要那么多代碼(最關鍵的其實只是onStart函數)。這里近30行代碼，其中大部分是為了支持“變長”參數，因此queryAsync函數會保留調用時的所有參數，補上一個callback，再去調用query函數本身。此時，便可以去改寫之前的index等處理函數了(controllerstodo.js)，例如：

1. exports.index = toHandler(eval(Jscex.compile("async", function (req, res) {  
2.  
3.     var todos = $await(db.queryAsync('select * from todo order by finished asc, id asc limit 50'));  
4.     res.render("index", { todos: todos });  
5.  
6. }))); 

toHandler函數的作用，是將一個“接受req和res，返回Task”的函數，封裝成標準的“接受req、res和next三個參數”的處理函數，并提供統一的錯誤處理：

1. var toHandler = function (asyncFunc) {  
2.     return function (req, res, next) {  
3.         var task = asyncFunc(req, res);  
4.         task.addListener(function () {  
5.             if (task.status == "failed") {  
6.                 next(task.error);  
7.             }  
8.         });  
9.         task.start();  
10.     }  
11. } 

我在todo.js里保留了原有各個處理函數的實現，感興趣的朋友可以對比一下它們之前的差別。可惜的是，由于ToDo實在過于簡單，Jscex的優勢并沒有表現出來太多。例如，每個處理程序中只有一個MySQL查詢，沒有判斷和循環，更別說為了充分利用IO并發能力，從而組合多個異步函數了。因此，我最近也一直在尋找更復雜一些的示例，不過似乎用Express的開源網站并不多見，我幾乎都想自己寫一個了。目前感覺Nodepad似乎還算不錯，接下來可能會對它下手。

ToDo網站依賴Express，ejs和MySQL驅動，同時我把Jscex作為添加為它的子模塊。如果您要克隆一份ToDo的代碼把玩一番，可以：

1. > git clone git://github.com/JeffreyZhao/todo.git  
2. > cd todo  
3. > git submodule init  
4. > git submodule update  
5. > npm install express ejs mysql  
6. > node server.js 

從現在開始，我會在InfoQ中文站上發表一系列關于Jscex的文章，既有關于瀏覽器端的JavaScript開發，也有在服務器端利用Node.js開發的內容。可能您目前還可能會有所疑惑，例如為什么要使用危險的eval函數，eval和Jscex.compile函數不能封裝起來嗎?其實在看了我的文章并對Jscex有了基本了解之后，就會發現這些都是以“傳統眼光”來看待Jscex時所形成的誤解。Jscex的做法的確“另辟蹊徑”，否則在JavaScript異步類庫已經多如牛毛的情況下，我不知如何讓它脫穎而出。(高端網站建設)