依賴注入(Dependency Injection)聽起來很硬派,其實核心概念不難:不要讓函式自己去 new 出它需要的東西,而是由外部把依賴「送進來」。這篇文章從零開始,用純 JavaScript 做出一個能自動分析參數、自動補上依賴的啟動器。
假設已經有一組以 key-value 形式定義好的服務集合,我們希望新增服務時只要宣告函式參數名稱,容器就能自動對號入座完成注入。
var services = { abc: 123, def: 456, ghi: 789 }; // 已定義好的服務
function Service(abc, ghi){
this.write = function(){
console.log(abc);
console.log(ghi);
};
}
function Activitor(func){
var obj;
// 實作待補
return obj;
}
直覺會想到反射,但 JavaScript 並沒有正式的參數列 introspection API。func.arguments 只有在函式被呼叫且傳入參數時才存在,也無法滿足需求。剩下的路是解析 func.toString() 的字串,用正則運算式把括號內的參數名稱抓出來。
function getFuncParams(func) {
var matches = func.toString().match(/^function\s*[^(]*\(\s*([^)]*)\)/m);
if (matches && matches.length > 1)
return matches[1].replace(/\s*/, '').split(',');
return [];
}
有了名稱清單,就等於有了依賴清單,逐一查表替換即可。
var params = getFuncParams(func);
for (var i in params) {
params[i] = services[params[i]];
}
call 與 apply 都能改變 this 指向,差別在參數傳遞方式:call 需要你逐一列出參數,apply 則直接接受一個陣列並自動對位。既然我們手上就是一個陣列,apply 才是正解。
function Activitor(func){
var obj = {};
func.apply(obj, params);
return obj;
}
var
// 已定義好的服務
services = { abc: 123, def: 456, ghi: 789 },
// 取得函式的參數列表(即依賴列表)
getFuncParams = function (func) {
var matches = func.toString().match(/^function\s*[^(]*\(\s*([^)]*)\)/m);
if (matches && matches.length > 1)
return matches[1].replace(/\s+/, '').split(',');
return [];
},
// 依參數列表填入對應的依賴項
setFuncParams = function (params) {
for (var i in params) {
params[i] = services[params[i]];
}
return params;
};
// 啟動器
function Activitor(func) {
var obj = {};
func.apply(obj, setFuncParams(getFuncParams(func)));
return obj;
}
// 定義新服務
function Service(abc, ghi) {
this.write = function () {
console.log(abc);
console.log(ghi);
};
}
// 建立實例並呼叫方法
var service = Activitor(Service);
service.write();
靠 toString() 解析參數名稱的做法很脆弱:程式碼一旦被壓縮混淆,參數會被改名成 a、b、c,注入就完全失效;箭頭函式、預設參數、解構賦值也都不在原始正則的支援範圍內。因此它適合作為理解原理的練習,正式專案仍建議使用 Angular、InversifyJS 這類以裝飾器或顯式註冊為基礎的成熟方案。