萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

深入理解 JavaScript 依賴注入:從手寫容器到 Angular 風格反射實現

為什麼需要依賴注入 (DI)?

硬編碼依賴導致強耦合、難測試、難擴展。DI 容器負責創建、管理依賴實例,消費者僅聲明需求,實現控制反轉 (IoC)。

目標接口設計

// 期望用法
var doSomething = injector.resolve(['service', 'router'], function(service, router, customArg) {
    // service、router 由容器注入,customArg 由調用者傳入
    expect(service().name).toBe('Service');
    expect(router().name).toBe('Router');
    expect(customArg).toBe('Custom');
});

doSomething('Custom'); // 傳遞自定義參數

方案一:顯式依賴聲明(RequireJS/AMD 風格)

var injector = {
    dependencies: {},

    register: function(key, factory) {
        this.dependencies[key] = factory; // 支援工廠函數或實例
    },

    resolve: function(deps, func, scope) {
        var self = this;
        // 解析依賴
        var args = deps.map(function(key) {
            var dep = self.dependencies[key];
            if (!dep) throw new Error('Cannot resolve dependency: ' + key);
            return typeof dep === 'function' ? dep() : dep; // 支援工廠函數懶加載
        });

        // 返回包裝函數,合併注入依賴與調用時參數
        return function() {
            var callArgs = Array.prototype.slice.call(arguments);
            func.apply(scope || {}, args.concat(callArgs));
        };
    }
};

// 註冊
injector.register('service', function() { return { name: 'Service' }; });
injector.register('router', function() { return { name: 'Router' }; });

// 使用
var doSomething = injector.resolve(['service', 'router'], function(s, r, other) { ... });
doSomething('Other');

優點:明確、無魔法、壓縮安全。缺點:依賴名稱與參數順序強綁定,維護麻煩。

方案二:函數參數名反射(Angular 1.x 風格)

injector.resolve = function(func, scope) {
    var self = this;
    // 正則提取參數名:function(a, b, c) -> ['a','b','c']
    var STRIP_COMMENTS = /((\/\/.*$)|(\/\*[\s\S]*?\*\/))/mg;
    var ARGUMENT_NAMES = /([^\s,]+)/g;
    var fnStr = func.toString().replace(STRIP_COMMENTS, '');
    var args = fnStr.slice(fnStr.indexOf('(')+1, fnStr.indexOf(')')).match(ARGUMENT_NAMES) || [];

    return function() {
        var callArgs = Array.prototype.slice.call(arguments);
        var injectArgs = args.map(function(name) {
            var dep = self.dependencies[name];
            if (dep) return typeof dep === 'function' ? dep() : dep;
            // 依賴未註冊,嘗試從調用參數補齊(按順序)
            return callArgs.shift();
        });
        func.apply(scope || {}, injectArgs);
    };
};

// 使用:無需聲明依賴數組,參數名即聲明
var doSomething = injector.resolve(function(service, router, other) { ... });
doSomething('Other');

反射方案的致命缺陷:代碼壓縮

壓縮後 function(service, router) 變為 function(a, b),參數名丟失,映射失效。

Angular 解決方案:內聯數組註解

// 手寫註解(開發態)
var doSomething = injector.resolve(['service', 'router', function(service, router) { ... }]);

// 或構建時自動轉換:ng-annotate / babel-plugin-angularjs-annotate
// 輸入:injector.resolve(function(service, router) { ... })
// 輸出:injector.resolve(['service', 'router', function(service, router) { ... }])

融合版 Injector:支援兩種調用風格

var injector = {
    dependencies: {},

    register: function(key, value) { this.dependencies[key] = value; },

    resolve: function() {
        var self = this, func, deps, scope;

        // 判斷調用形式:resolve(['dep1', 'dep2'], fn, scope?) 或 resolve(fn, scope?)
        if (Array.isArray(arguments[0])) {
            deps = arguments[0];
            func = arguments[1];
            scope = arguments[2];
        } else {
            func = arguments[0];
            scope = arguments[1];
            // 反射提取參數名
            var STRIP_COMMENTS = /((\/\/.*$)|(\/\*[\s\S]*?\*\/))/mg;
            var ARGUMENT_NAMES = /([^\s,]+)/g;
            var fnStr = func.toString().replace(STRIP_COMMENTS, '');
            deps = fnStr.slice(fnStr.indexOf('(')+1, fnStr.indexOf(')')).match(ARGUMENT_NAMES) || [];
        }

        return function() {
            var callArgs = Array.prototype.slice.call(arguments);
            var injectArgs = deps.map(function(name) {
                var dep = self.dependencies[name];
                if (dep !== undefined && dep !== null) return typeof dep === 'function' ? dep() : dep;
                return callArgs.shift(); // 未註冊依賴從調用參數補齊
            });
            func.apply(scope || {}, injectArgs);
        };
    }
};

生產環境最佳實踐

  1. 構建時註解:集成 ng-annotate 或 TypeScript emitDecoratorMetadata + 裝飾器(Angular 2+ 風格)。
  2. TypeScript 裝飾器方案(現代標準):
// 依賴注入容器(簡化版)
@Injectable()
class ServiceA { getName() { return 'ServiceA'; } }

@Injectable()
class ServiceB { getName() { return 'ServiceB'; } }

@Component({...})
class MyComponent {
    constructor(private svcA: ServiceA, private svcB: ServiceB) {} // 類型即聲明
}
  • 避免手寫容器:成熟方案(Angular DI、InversifyJS、TSyringe、NestJS 內置)已解決生命週期、作用域、循環依賴、AOP 攔截等複雜問題。
  • 前端模塊化已天然解耦:ES Module import/export 靜態依賴圖,構建時 Tree Shaking、Code Splitting,運行時無需 DI 容器。DI 主要用於**運行時動態插件系統、框架內部、複雜企業級應用插件架構**。

總結

從手寫 register/resolve 理解 DI 核心,到反射自動注入、壓縮兼容註解、現代裝飾器元編程,依賴注入是管理復雜依賴圖的強大模式。但在現代前端工程中,**靜態模塊依賴 + 構建時優化** 往往比運行時 DI 容器更高效、更可維護。按需選擇,切勿過度設計。

copyright © 萬盛學電腦網 all rights reserved