花了一些時間研究 DSL 之後,有幾個頗有意思的發現。JavaScript 裡被使用得最為泛濫的一項技巧,大概就是鏈式調用(Method Chaining)了。而有趣的是,Martin Fowler 早就指出過一個常見的誤解:
I've also noticed a common misconception - many people seem to equate fluent interfaces with Method Chaining. Certainly chaining is a common technique to use with fluent interfaces, but true fluency is much more than that.
換句話說,很多人把鏈式調用直接等同於流暢接口。鏈式調用確實是流暢接口常用的實現手段,但真正的「流暢」遠不止於此。
流暢接口想要解決的核心問題是:API 應該是可讀的。畢竟代碼首先是寫給人看的,其次才是給機器執行。
對比一下原生 DOM 的操作方式,你就能感受到差異:
var btn = document.createElement("BUTTON"); // 建立 button 元素
var t = document.createTextNode("CLICK ME"); // 建立文字節點
btn.appendChild(t); // 把文字掛到 button 上
document.body.appendChild(btn); // 再把 button 掛到 body 上
同樣的事情,用 jQuery 一行就能搞定:
$('<span>').append("CLICK ME");
這正是流暢風格帶來的改變:語句像是在描述意圖,而不是在指揮每一步操作。
我們可以自己動手做一個最小的示範:
var Func = function () {
this.add = function () {
console.log('1');
return this; // 關鍵:返回自身,才能繼續串下去
};
this.result = function () {
console.log('2');
return this;
};
return this;
};
var func = new Func();
func.add().result();
看起來確實很像一個「表達式生成器」——這就引出了下一個話題。
表達式生成器對象提供了一組語意連貫的接口,再把這些接口調用翻譯成對底層「命令—查詢」式 API 的調用。數據庫相關的庫裡經常能看到這種設計:
var query =
SQL('select name, desc from widgets')
.WHERE('price < ', $(params.max_price), AND,
'clearance = ', $(params.clearance))
.ORDERBY('name asc');
鏈式調用有個容易被忽略的問題:收尾。上面這段代碼沒有明確的終結點,讀的人會一時摸不著頭腦——這條鏈到底在哪裡結束、什麼時候真正執行?補上一個 .query() 或 .end(),往往就能讓意圖清晰很多。
與鏈式調用容易混淆的另一個概念是方法級聯,形式上看起來像是這樣:
a.b(); a.c();
兩者形似而神不同:級聯始終作用在同一個對象上,鏈式則依賴返回值把上下文往下傳。理解這層區別,再去讀各種 ORM、測試框架或構建工具的 API,會通透許多。