研究 DSL 時會發現一件有意思的事:JavaScript 裡最氾濫的 DSL 手法就是鏈式調用。但 Martin Fowler 曾指出一個常見誤解——很多人把流暢接口(fluent interface)直接等同於方法鏈。
Fowler 的原話大意是:鏈式調用確實是實現流暢接口的常用技術,但真正的「流暢」遠不止這一點。流暢接口的初衷是構建可讀的 API,畢竟代碼首先是寫給人看的——它追求的是語句讀起來像自然語言,而不僅僅是少寫幾個變量。
用原生 DOM API 創建一個按鈕:
var btn = document.createElement("BUTTON"); // 創建 button 元素
var t = document.createTextNode("CLICK ME"); // 創建文本節點
btn.appendChild(t); // 把文本掛到按鈕上
document.body.appendChild(btn); // 把按鈕掛到 body 上
用 jQuery 則是:
$('<span>').append("CLICK ME");
這就是流暢感的由來。
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();
核心只有一個:return this。有了它,調用就能一直串下去。
上面這個例子更貼切的歸類其實是「表達式生成器」。所謂表達式生成器,是指對象提供一組連貫的接口,然後把這些接口調用翻譯成對底層命令-查詢 API 的調用。
數據庫查詢構造器是最典型的場景:
var query =
SQL('select name, desc from widgets')
.WHERE('price < ', $(params.max_price), AND,
'clearance = ', $(params.clearance))
.ORDERBY('name asc');
這段代碼讀起來幾乎就是英文句子,這才是流暢接口追求的目標。
鏈式寫法有個尷尬之處:不知道什麼時候算「結束」。上面的 query 沒有明確終點,讀者會疑惑它是僅僅構造了語句,還是已經執行。實踐中的解法是顯式加一個終結方法,比如 .query() 或 .end(),讓流的起止清晰可辨——jQuery 的 .end() 就是這個思路,用於從鏈中回退到上一個集合。
與方法鏈容易混淆的另一個概念是方法級聯(method cascading),寫法是不返回值、直接重複調用同一對象:
a.b(); a.c();
Smalltalk 的 Cascade; 語法就是語言級支持。三者的共同點都是「減少重複書寫」,差別在於實現機制與是否返回值。