JavaScript里的依賴注入

2018-06-16 19:19 更新

我喜歡引用這句話,“程序是對(duì)復(fù)雜性的管理”。計(jì)算機(jī)世界是一個(gè)巨大的抽象建筑群。我們簡(jiǎn)單的包裝一些東西然后發(fā)布新工具,周而復(fù)始。現(xiàn)在思考下,你所使用的語言包括的一些內(nèi)建的抽象函數(shù)或是低級(jí)操作符。這在JavaScript里是一樣的。

遲早你需要用到其他開發(fā)人員的抽象成果——即你依靠別人的代碼。我喜歡依賴自由(無依賴)的模塊,但那是難以實(shí)現(xiàn)的。甚至你創(chuàng)建的那些漂亮的黑盒子組件也或多或少會(huì)依賴一些東西。這正是依賴注入大顯身手的之處?,F(xiàn)在有效地管理依賴的能力是絕對(duì)必要的。本文總結(jié)了我對(duì)問題探索和一些的解決方案。

目標(biāo)

設(shè)想我們有兩個(gè)模塊。第一個(gè)是負(fù)責(zé)Ajax請(qǐng)求服務(wù)(service),第二個(gè)是路由(router)。

var service = function() {
    return { name: 'Service' };
}
var router = function() {
    return { name: 'Router' };
}
我們有另一個(gè)函數(shù)需要用到這兩個(gè)模塊。

var doSomething = function(other) {
    var s = service();
    var r = router();
};

為使看起來更有趣,這函數(shù)接受一個(gè)參數(shù)。當(dāng)然,我們完全可以使用上面的代碼,但這顯然不夠靈活。如果我們想使用ServiceXMLServiceJSON呢,或者如果我們需要一些測(cè)試模塊呢。我們不能僅靠編輯函數(shù)體來解決問題。首先,我們可以通過函數(shù)的參數(shù)來解決依賴性。即:

var doSomething = function(service, router, other) {
    var s = service();
    var r = router();
};

我們通過傳遞額外的參數(shù)來實(shí)現(xiàn)我們想要的功能,然而,這會(huì)帶來新的問題。想象如果我們的doSomething 方法散落在我們的代碼中。如果我們需要更改依賴條件,我們不可能更改所有調(diào)用函數(shù)的文件。

我們需要一個(gè)能幫我們搞定這些的工具。這就是依賴注入嘗試解決的問題。讓我們寫下一些我們的依賴注入解決辦法應(yīng)該達(dá)到的目標(biāo):

  • 我們應(yīng)該能夠注冊(cè)依賴關(guān)系
  • 注入應(yīng)該接受一個(gè)函數(shù),并返回一個(gè)我們需要的函數(shù)
  • 我們不能寫太多東西——我們需要精簡(jiǎn)漂亮的語法
  • 注入應(yīng)該保持被傳遞函數(shù)的作用域
  • 被傳遞的函數(shù)應(yīng)該能夠接受自定義參數(shù),而不僅僅是依賴描述
  • 堪稱完美的清單,下面 讓我們實(shí)現(xiàn)它。

RequireJS / AMD的方法

你可能對(duì)RequireJS早有耳聞,它是解決依賴注入不錯(cuò)的選擇。

define(['service', 'router'], function(service, router) {       
    // ...
});

這種想法是先描述需要的依賴,然后再寫你的函數(shù)。這里參數(shù)的順序很重要。如上所說,讓我們寫一個(gè)叫做injector的模塊,能接受相同的語法。

var doSomething = injector.resolve(['service', 'router'], function(service, router, other) {
    expect(service().name).to.be('Service');
    expect(router().name).to.be('Router');
    expect(other).to.be('Other');
});
doSomething("Other");

再繼續(xù)之前我應(yīng)該解釋清楚doSomething函數(shù)體內(nèi)容,我使用expect.js (斷言方面的庫)僅是為了保證我寫的代碼的行為和我期望的是一樣的,體現(xiàn)一點(diǎn)點(diǎn)TDD(測(cè)試驅(qū)動(dòng)開發(fā))方法。

下面開始我們的injector模塊,這是非常棒的一個(gè)單例模式,所以它能在我們程序的不同部分工作的很好。

var injector = {
    dependencies: {},
    register: function(key, value) {
        this.dependencies[key] = value;
    },
    resolve: function(deps, func, scope) {

    }
}

這是一個(gè)非常簡(jiǎn)單的對(duì)象,有兩個(gè)方法,一個(gè)用來存儲(chǔ)的屬性。我們要做的是檢查deps數(shù)組并在dependencies變量中搜索答案。剩下的只是調(diào)用.apply方法并傳遞之前的func方法的參數(shù)。

resolve: function(deps, func, scope) {
    var args = [];
    for(var i=0; i<deps.length, d=deps[i]; i++) {
        if(this.dependencies[d]) {
            args.push(this.dependencies[d]);
        } else {
            throw new Error('Can\'t resolve ' + d);
        }
    }
    return function() {
        func.apply(scope || {}, args.concat(Array.prototype.slice.call(arguments, 0)));
    }        
}

scope是可選的,Array.prototype.slice.call(arguments, 0)是必須的,用來將arguments變量轉(zhuǎn)換為真正的數(shù)組。到目前為止還不錯(cuò)。我們的測(cè)試通過了。這種實(shí)現(xiàn)的問題是,我們需要寫所需部件兩次,并且我們不能混淆他們的順序。附加的自定義參數(shù)總是位于依賴之后。

反射方法

根據(jù)維基百科的定義反射是指一個(gè)程序在運(yùn)行時(shí)檢查和修改一個(gè)對(duì)象的結(jié)構(gòu)和行為的能力。簡(jiǎn)單的說,在JavaScript的上下文里,這具體指讀取和分析的對(duì)象或函數(shù)的源代碼。讓我們完成文章開頭提到的doSomething函數(shù)。如果你在控制臺(tái)輸出doSomething.tostring()。你將得到如下的字符串:

"function (service, router, other) {
    var s = service();
    var r = router();
}"

通過此方法返回的字符串給我們遍歷參數(shù)的能力,更重要的是,能夠獲取他們的名字。這其實(shí)是Angular 實(shí)現(xiàn)它的依賴注入的方法。我偷了一點(diǎn)懶,直接截取Angular代碼中獲取參數(shù)的正則表達(dá)式。

/^function\s*[^\(]*\(\s*([^\)]*)\)/m

我們可以像下面這樣修改resolve 的代碼:

resolve: function() {
    var func, deps, scope, args = [], self = this;
    func = arguments[0];
    deps = func.toString().match(/^function\s*[^\(]*\(\s*([^\)]*)\)/m)[1].replace(/ /g, '').split(',');
    scope = arguments[1] || {};
    return function() {
        var a = Array.prototype.slice.call(arguments, 0);
        for(var i=0; i<deps.length; i++) {
            var d = deps[i];
            args.push(self.dependencies[d] && d != '' ? self.dependencies[d] : a.shift());
        }
        func.apply(scope || {}, args);
    }        
}

我們執(zhí)行正則表達(dá)式的結(jié)果如下:

["function (service, router, other)", "service, router, other"] 看起來,我們只需要第二項(xiàng)。一旦我們清楚空格并分割字符串就得到`deps`數(shù)組。只有一個(gè)大的改變:

var a = Array.prototype.slice.call(arguments, 0);
...
args.push(self.dependencies[d] && d != '' ? self.dependencies[d] : a.shift());

我們循環(huán)遍歷dependencies數(shù)組,如果發(fā)現(xiàn)缺失項(xiàng)則嘗試從arguments對(duì)象中獲取。謝天謝地,當(dāng)數(shù)組為空時(shí),shift方法只是返回undefined,而不是拋出一個(gè)錯(cuò)誤(這得益于web的思想)。新版的injector 能像下面這樣使用:

var doSomething = injector.resolve(function(service, other, router) {
    expect(service().name).to.be('Service');
    expect(router().name).to.be('Router');
    expect(other).to.be('Other');
});
doSomething("Other");

不必重寫依賴并且他們的順序可以打亂。它仍然有效,我們成功復(fù)制了Angular的魔法。

然而,這種做法并不完美,這就是反射類型注射一個(gè)非常大的問題。壓縮會(huì)破壞我們的邏輯,因?yàn)樗淖儏?shù)的名字,我們將無法保持正確的映射關(guān)系。例如,doSometing()壓縮后可能看起來像這樣:

var doSomething=function(e,t,n){var r=e();var i=t()}

Angular團(tuán)隊(duì)提出的解決方案看起來像:

var doSomething = injector.resolve(['service', 'router', function(service, router) {

}]);

這看起來很像我們開始時(shí)的解決方案。我沒能找到一個(gè)更好的解決方案,所以決定結(jié)合這兩種方法。下面是injector的最終版本。

var injector = {
    dependencies: {},
    register: function(key, value) {
        this.dependencies[key] = value;
    },
    resolve: function() {
        var func, deps, scope, args = [], self = this;
        if(typeof arguments[0] === 'string') {
            func = arguments[1];
            deps = arguments[0].replace(/ /g, '').split(',');
            scope = arguments[2] || {};
        } else {
            func = arguments[0];
            deps = func.toString().match(/^function\s*[^\(]*\(\s*([^\)]*)\)/m)[1].replace(/ /g, '').split(',');
            scope = arguments[1] || {};
        }
        return function() {
            var a = Array.prototype.slice.call(arguments, 0);
            for(var i=0; i<deps.length; i++) {
                var d = deps[i];
                args.push(self.dependencies[d] && d != '' ? self.dependencies[d] : a.shift());
            }
            func.apply(scope || {}, args);
        }        
    }
}

resolve訪客接受兩或三個(gè)參數(shù),如果有兩個(gè)參數(shù)它實(shí)際上和文章前面寫的一樣。然而,如果有三個(gè)參數(shù),它會(huì)將第一個(gè)參數(shù)轉(zhuǎn)換并填充deps數(shù)組,下面是一個(gè)測(cè)試?yán)樱?/p>

var doSomething = injector.resolve('router,,service', function(a, b, c) {
    expect(a().name).to.be('Router');
    expect(b).to.be('Other');
    expect(c().name).to.be('Service');
});
doSomething("Other");

你可能注意到在第一個(gè)參數(shù)后面有兩個(gè)逗號(hào)——注意這不是筆誤??罩祵?shí)際上代表“Other”參數(shù)(占位符)。這顯示了我們是如何控制參數(shù)順序的。

直接注入Scope

有時(shí)我會(huì)用到第三個(gè)注入變量,它涉及到操作函數(shù)的作用域(換句話說,就是this對(duì)象)。所以,很多時(shí)候不需要使用這個(gè)變量。

var injector = {
    dependencies: {},
    register: function(key, value) {
        this.dependencies[key] = value;
    },
    resolve: function(deps, func, scope) {
        var args = [];
        scope = scope || {};
        for(var i=0; i<deps.length, d=deps[i]; i++) {
            if(this.dependencies[d]) {
                scope[d] = this.dependencies[d];
            } else {
                throw new Error('Can\'t resolve ' + d);
            }
        }
        return function() {
            func.apply(scope || {}, Array.prototype.slice.call(arguments, 0));
        }        
    }
}

我們所做的一切其實(shí)就是將依賴添加到作用域。這樣做的好處是,開發(fā)人員不用再寫依賴性參數(shù);它們已經(jīng)是函數(shù)作用域的一部分。

var doSomething = injector.resolve(['service', 'router'], function(other) {
    expect(this.service().name).to.be('Service');
    expect(this.router().name).to.be('Router');
    expect(other).to.be('Other');
});
doSomething("Other");

結(jié)束語

其實(shí)我們大部分人都用過依賴注入,只是我們沒有意識(shí)到。即使你不知道這個(gè)術(shù)語,你可能在你的代碼里用到它百萬次了。希望這篇文章能加深你對(duì)它的了解。

在這篇文章中提到的例子都可以在這里找到。

譯者注

本文為譯文,原文為“Dependency Injection in JavaScript”。

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)