基于Node.js、Express和Jscex開發(fā)的ToDo網(wǎng)站示例
Jscex的主要使用場景是“JavaScript異步編程”,不過并沒有限制是跑在瀏覽器還是服務(wù)器端。最近Node.js很火熱,也剛發(fā)布了原生的Windows版,不少同學(xué)會用它來做一些網(wǎng)站這樣的小程序。目前用Node.js開發(fā)網(wǎng)站最著名的框架是Express,使用起來也是比較容易的。前段時間看到CNodeJS社區(qū)的一篇文章,有同學(xué)將一個Python寫的ToDo列表網(wǎng)站移植到了Node.js上,我為了推廣Jscex,就fork了這個項(xiàng)目,將其修改為基于Jscex的版本,大伙兒可以來比較一下。當(dāng)然這個網(wǎng)站過于簡單,我也正在尋找更合適的項(xiàng)目。(網(wǎng)站制作)
51CTO推薦專題:Node.js專區(qū)
JavaScript是一個沒有阻塞特性的語言,因此各類API都會設(shè)計(jì)為異步,這對于服務(wù)器的伸縮性和客戶端網(wǎng)頁的響應(yīng)能力都有好處,不過在程序編寫上就會遇到各種問題了。例如在ToDo示例中的一個簡單的處理函數(shù),因?yàn)樾枰樵償?shù)據(jù)庫,就要寫成帶回調(diào)的樣子:
- exports.index?=?function?(req,?res,?next)?{ ?
- ????db.query('select?*?from?todo?order?by?finished?asc,?id?asc?limit?50',?function?(err,?rows)?{ ?
- ????????if?(err)?return?next(err); ?
- ????????res.render('index',?{?todos:?rows?}); ?
- ????}); ?
- };?
db變量用來操作MySQL數(shù)據(jù)庫,它的query方法傳入sql(可能還會有參數(shù))并提供一個回調(diào)函數(shù),用來提示錯誤或是返回查詢結(jié)果。在回調(diào)中我們必須判斷err是否存在,如果存在便調(diào)用next報(bào)告框架“出錯了”。每個異步操作都必須如此,試想如果在這個查詢后還有另一個查詢,則還需要進(jìn)行一次嵌套和err判斷。每個處理函數(shù)都是如此,這也是異步編程的煩惱之一:難以進(jìn)行統(tǒng)一的異常處理,處理代碼總是需要分散在各處,一不小心就變成“野異常”,還很難排查出來。
我將ToDo網(wǎng)站簡單地Jscex化了一下。首先讓MySQL的查詢能夠接入Jscex(libjscex.mysql.js):
- exports.jscexify?=?function?(db)?{ ?
- ????db.queryAsync?=?function?()?{ ?
- ????????var?_this?=?this; ?
- ?
- ????????var?args?=?[]; ?
- ????????for?(var?i?=?0;?i?
- ????????????args.push(arguments[i]); ?
- ????????} ?
- ?
- ????????var?delegate?=?{ ?
- ????????????onStart:?function?(callback)?{ ?
- ?
- ????????????????args.push(function?(err,?result)?{ ?
- ????????????????????if?(err)?{ ?
- ????????????????????????callback("failure",?err); ?
- ????????????????????}?else?{ ?
- ????????????????????????callback("success",?result); ?
- ????????????????????} ?
- ????????????????}); ?
- ?
- ????????????????_this.query.apply(_this,?args); ?
- ????????????} ?
- ????????}; ?
- ?
- ????????return?new?Jscex.Async.Task(delegate); ?
- ????} ?
- }?
一般來說,將一個異步接口給Jscex化并不需要那么多代碼(最關(guān)鍵的其實(shí)只是onStart函數(shù))。這里近30行代碼,其中大部分是為了支持“變長”參數(shù),因此queryAsync函數(shù)會保留調(diào)用時的所有參數(shù),補(bǔ)上一個callback,再去調(diào)用query函數(shù)本身。此時,便可以去改寫之前的index等處理函數(shù)了(controllerstodo.js),例如:
- exports.index?=?toHandler(eval(Jscex.compile("async",?function?(req,?res)?{ ?
- ?
- ????var?todos?=?$await(db.queryAsync('select?*?from?todo?order?by?finished?asc,?id?asc?limit?50')); ?
- ????res.render("index",?{?todos:?todos?}); ?
- ?
- })));?
toHandler函數(shù)的作用,是將一個“接受req和res,返回Task”的函數(shù),封裝成標(biāo)準(zhǔn)的“接受req、res和next三個參數(shù)”的處理函數(shù),并提供統(tǒng)一的錯誤處理:
- var?toHandler?=?function?(asyncFunc)?{ ?
- ????return?function?(req,?res,?next)?{ ?
- ????????var?task?=?asyncFunc(req,?res); ?
- ????????task.addListener(function?()?{ ?
- ????????????if?(task.status?==?"failed")?{ ?
- ????????????????next(task.error); ?
- ????????????} ?
- ????????}); ?
- ????????task.start(); ?
- ????} ?
- }?
我在todo.js里保留了原有各個處理函數(shù)的實(shí)現(xiàn),感興趣的朋友可以對比一下它們之前的差別。可惜的是,由于ToDo實(shí)在過于簡單,Jscex的優(yōu)勢并沒有表現(xiàn)出來太多。例如,每個處理程序中只有一個MySQL查詢,沒有判斷和循環(huán),更別說為了充分利用IO并發(fā)能力,從而組合多個異步函數(shù)了。因此,我最近也一直在尋找更復(fù)雜一些的示例,不過似乎用Express的開源網(wǎng)站并不多見,我?guī)缀醵枷胱约簩懸粋€了。目前感覺Nodepad似乎還算不錯,接下來可能會對它下手。
ToDo網(wǎng)站依賴Express,ejs和MySQL驅(qū)動,同時我把Jscex作為添加為它的子模塊。如果您要克隆一份ToDo的代碼把玩一番,可以:
- >?git?clone?git://github.com/JeffreyZhao/todo.git ?
- >?cd?todo ?
- >?git?submodule?init ?
- >?git?submodule?update ?
- >?npm?install?express?ejs?mysql ?
- >?node?server.js?
從現(xiàn)在開始,我會在InfoQ中文站上發(fā)表一系列關(guān)于Jscex的文章,既有關(guān)于瀏覽器端的JavaScript開發(fā),也有在服務(wù)器端利用Node.js開發(fā)的內(nèi)容??赡苣壳斑€可能會有所疑惑,例如為什么要使用危險(xiǎn)的eval函數(shù),eval和Jscex.compile函數(shù)不能封裝起來嗎?其實(shí)在看了我的文章并對Jscex有了基本了解之后,就會發(fā)現(xiàn)這些都是以“傳統(tǒng)眼光”來看待Jscex時所形成的誤解。Jscex的做法的確“另辟蹊徑”,否則在JavaScript異步類庫已經(jīng)多如牛毛的情況下,我不知如何讓它脫穎而出。(高端網(wǎng)站建設(shè))