讀《Ajax in Action》時,作者提到 Adapter 與 Facade 這兩種模式,讓我停下來思考了一下。以目前 Web 開發的生態而言,尤其是客戶端 JavaScript 的開發,我們得同時面對大量變化與跨平台的挑戰。在這個背景下引入 Adapter 與 Facade,對提升可維護性、降低整體開發成本都很有幫助。
GoF 的定義是:Adapter 模式將一個類別的介面轉換為客戶端期待的另一種介面,讓原本因介面不相容而無法協同工作的類別得以合作。
它要解決的,就是介面不一致的問題。實務上,呼叫方想用的介面,往往與被呼叫方實際提供的介面對不上。此時你有兩種選擇:改動其中一方的介面讓彼此適應,或者在兩者之間插入一個 Adapter 作為橋梁。
Adapter 扮演的是介面轉接器的角色。一個 Adapter 類別會實作呼叫方期待的介面,並在內部透過委派(delegate)去調用被呼叫方,於是把兩套不同的介面連了起來。
依實作方式,Adapter 模式分為兩種:物件轉接器(Object Adapter)透過組合(composition)實現,類別轉接器(Class Adapter)則透過多重繼承實現。
這個模式的關鍵點在於「意圖」——讓兩個原本不相容的介面變得相容,使一個並非呼叫方期待的介面,看起來就像期待中的那樣。《Head First Design Patterns》裡有個既傳神又有趣的說法:如果它走起路來像鸭子、叫起來也像鸭子,那它可能只是一隻披了 Adapter 偽裝的火鸡。
GoF 的定義是:Facade 模式為子系統中的一組介面提供統一的入口,它所定義的高階介面,讓子系統更容易被使用。
它的意圖同樣明顯。當呼叫方需要操作的子系統過於複雜時,往往得連續調用 N 個介面才能完成一項特定任務。每次重複這一連串操作既繁瑣又容易出錯,於是本著 DRY(Don't Repeat Yourself)原則,我們把常用操作提煉組合為單一介面。此後呼叫方只要呼叫這個 Facade,就能輕鬆完成任務。
Facade 的作用主要有兩點:
它的關鍵點是:引入 Facade 是為了簡化與統一介面,這個介面通常是子系統的一條「捷徑」。若呼叫方還需要其他複雜功能,依然可以直接調用子系統的介面。
分辨模式的根本依據是意圖。有一句話把 Adapter、Decorator 與 Facade 的差別說得很清楚:Adapter 包裝一個物件以改變它的介面;Decorator 包裝一個物件以添加新的行為與責任;而 Facade 則是包裝「一組」物件,目的是簡化。
AJAX 時代的 Web 開發有個共同特點:瀏覽器端不再是傳統的簡單頁面,而是複雜的 JavaScript 客戶端應用程式。隨著程式碼量攀升,我們必須以更嚴謹的軟體工程方式來看待 AJAX 應用。此時若能引入各種物件導向原則與模式,整體品質會有明顯提升。
目前瀏覽器端的 JavaScript 開發,主要面臨兩個問題:
你應該已經看出來了:這兩種情況正好對應 Adapter 與 Facade 的需求。
《Ajax in Action》裡有一段程式碼正好體現了這種需求。以下是一個稍作修改後的 ContentLoader 類別(省略部分細節):
CGIAJax.util.STATICS = {};
CGIAJax.util.STATICS.READY_STATE_UNINITIALIZED = 0;
CGIAJax.util.STATICS.READY_STATE_LOADING = 1;
CGIAJax.util.STATICS.READY_STATE_LOADED = 2;
CGIAJax.util.STATICS.READY_STATE_INTERACTIVE = 3;
CGIAJax.util.STATICS.READY_STATE_COMPLETE = 4;
// 建構子:集中所有屬性
CGIAJax.util.ContentLoader = function (url, onload, method, msgBody, onerror) {
this.url = url;
this.onload = onload;
this.method = method ? method : "GET"; // 預設 GET
this.msgBody = msgBody ? msgBody : null; // 送給伺服器的訊息主體
this.onerror = onerror ? onerror : this.defaultError;
this.req = null;
};
CGIAJax.util.ContentLoader.prototype = {
// 送出請求以取得回應
loadXMLDoc: function () {
if (window.XMLHttpRequest) {
this.req = new XMLHttpRequest();
} else if (window.ActiveXObject) {
this.req = new ActiveXObject("Microsoft.XMLHTTP");
}
if (!this.req) { return; }
try {
var loader = this;
this.req.onreadystatechange = function () {
loader.onReadyState.call(loader);
};
if ("GET" == this.method) {
this.req.open("GET", this.url, true);
this.req.send(null);
} else {
if (!this.msgBody) { this.onerror.call(this); return; }
this.req.open(this.method, this.url, true);
this.req.send(this.msgBody);
}
} catch (err) {
this.onerror.call(this);
}
},
onReadyState: function () {
var req = this.req;
var ready = req.readyState;
if (ready == CGIAJax.util.STATICS.READY_STATE_COMPLETE) {
var httpStatus = req.status;
if (httpStatus == 200 || httpStatus == 0) {
this.onload.call(this);
} else {
this.onerror.call(this);
}
}
},
defaultError: function () {
alert("error fetching data!"
+ "\n\nreadyState: " + this.req.readyState
+ "\nstatus: " + this.req.status
+ "\nheaders: " + this.req.getAllResponseHeaders());
}
};
AJAX 應用中經常使用的 XHR(XMLHttpRequest)物件,正是需要 Adapter 模式的一個絕佳例子。
XHR 並非 W3C 標準,所以即使現有的主流瀏覽器都支援它,具體實作卻各不相同:在 IE 中它以 ActiveXObject 的形式存在,在 Mozilla 系瀏覽器中則是內建物件。誰也無法保證其他瀏覽器、或日後的版本不會再變。
而對我們的日常開發來說,這些細節並不重要。我們真正關心的只有一件事:當我需要一個 XHR 物件時,就會有一個 XHR 物件被建立並供我使用。至於背後怎麼建立,我不需要知道。上面那段程式碼中的條件判斷,正是扮演了這個角色:
if (window.XMLHttpRequest) {
this.req = new XMLHttpRequest();
} else if (window.ActiveXObject) {
this.req = new ActiveXObject("Microsoft.XMLHTTP");
}
這個判斷式為我們換來了跨平台能力,它本身就是一個 Adapter。我們的程式碼期待的是一個統一的「建立 XHR」介面;這段程式碼實作了該介面,並透過委派機制,自動在各平台上完成實例化。
想像一下:若某天出現一個爆紅的新瀏覽器 Xbrowser 需要相容,我們只要修改這個 Adapter,其他客戶端程式碼一行都不用動。這不是很美好嗎?
當你想用 XHR 向伺服器取資料時,總得痛苦地走完一連串步驟:建立 XHR 物件、註冊回呼函式、用 open 設定請求方式與網址、用 send 送出請求,然後監視請求狀態,等到特定狀態時再執行相應處理。光是取一次資料就要做這麼多事。
我們為什麼要不斷重複自己?ContentLoader 這個類別就把上述複雜性完全屏蔽掉了。當你想從伺服器取得資料時,你關心的是資料本身,而不是整個流程。有了它,兩行程式碼就能完成取數:
var myRequest = new CGIAJax.util.ContentLoader(url, refreshTable); myRequest.loadXMLDoc();
ContentLoader 本質上就是一個簡化而統一的介面,把繁瑣流程收攏到一處,於是我們得以 DRY。它也不會削弱靈活性——需要時你仍可直接調用瀏覽器提供的原生 XHR 介面;只是多數時候,用 ContentLoader 就能漂亮地完成任務。
再往遠處想:假如未來 W3C 把 XHR 列為標準並擴充了介面功能,我們該怎麼辦?擴充往往意味著介面或呼叫順序的改變。若沒有 Facade,我們就得逐處修改程式碼中所有用到 XHR 的地方,直到一切看似正常為止;而現在就套上 Facade,到時只需改動那一處介面內容,剩下的時間就能拿去看球了。
為什麼要對 AJAX 開發保持警惕?因為 AJAX 帶來的開發模式轉變,會讓客戶端程式碼量激增,量的變化最終會演變為質的變化。更關鍵的是,AJAX 所涉用的技術中,很大一部分尚未成為標準,或才剛剛成為標準——這意味著它們在未來一段時間內仍會頻繁變動。
如果我們在設計應用時對這些變化毫無準備,到頭來承受痛苦的只有自己。在 AJAX 開發中應用物件導向模式與原則,目的從來不是炫耀技術,而是希望這套已被反覆驗證的強大方法,能為我們的開發帶來實質的好處。