angular核心原理解析2：注入器的创建和使用

上一课没有讲到创建注入器的方法createInjector。

此方法，会创建两种不同的注入器：第一种叫做providerInjector，第二种叫做instanceInjector。providerInjector是用来创建provider的，instanceInjector是用来创建一个对象实例的。

我们可以在js代码中直接使用注入器：

var myModule = angular.module("myModule", []);

myModule.factory("person", function(){    //定义了一个服务person

　　return {

　　　　name:"chaojidan"

　　}

});

myModule.controller("myController", ["$scope", "$injector",     //myController依赖于服务person，但是它不声明依赖于person，而是通过注入器$injector来获得服务person的实例对象。

　　function($scope, $injector){

　　　　$injector.invoke(function(person){   //通过注入器$injector的invoke方法，把服务person的实例注入到函数function中。

　　　　　　console.log(person.name);

　　　　});

　　}

])

注入器$injector的annotate方法的作用：它主要分析函数的参数签名。比如：

$injector.annotate(function(arg1,arg2){})会得到[arg1, arg2]。

在前面的操作中，我们经常使用函数参数声明的方式来注入一个服务（实例对象），其实angular就是通过annotate方法得到参数的名字，然后通过注入器实例化这些对象，最后注入到函数中。

function annotate(fn) {
        var $inject,
            fnText,
            argDecl,
            last;

        if (typeof fn == 'function') {
            if (!($inject = fn.$inject)) {
                $inject = [];
                if (fn.length) {
                    fnText = fn.toString().replace(STRIP_COMMENTS, '');
                    argDecl = fnText.match(FN_ARGS);
                    forEach(argDecl[1].split(FN_ARG_SPLIT), function(arg){
                        arg.replace(FN_ARG, function(all, underscore, name){
                            $inject.push(name);
                        });
                    });
                }
                fn.$inject = $inject;
            }
        } else if (isArray(fn)) {
            last = fn.length - 1;
            assertArgFn(fn[last], 'fn');
            $inject = fn.slice(0, last);
        } else {
            assertArgFn(fn, 'fn', true);
        }
        return $inject;
    }

它是怎么获得函数的参数声明的呢？其实它是通过函数的toString方法得到整个函数的描述，然后通过正则表达式得到函数的参数。

在angular中，所有的provider都可以用来进行注入。我们创建provider有以下几种方式：

provider/factory/service/constant/value。

我们创建好provider之后，注入到哪里去呢？我们有以下几种方式来注入provider：

controller/directive/filter/service/factory等。

举个例子：

var myModule = angular.module("myModule", []);

myModule.provider("helloAngular", function(){      //通过provider方法创建一个服务提供者helloAngular

　　return {

　　　　$get : function(){    //provider方法来定义服务提供者的话，必须定义$get方法。

　　　　　　var name = "chaojidan";

　　　　　　function getName(){

　　　　　　　　return name;

　　　　　　}

　　　　　　return {

　　　　　　　　getName: getName

　　　　　　}

　　　　}

　　}

});

myModule.controller("myController", ["$scope", "helloAngular" ,     //通过controller方法注入helloAngular服务，也就是注入一个helloAngular服务的实例对象

　　function($scope, helloAngular){

　　　　$scope.name = helloAngular.getName();     //使用helloAngular服务的实例对象

　　}

])

第二个例子：

var myModule = angular.module("myModule", []);

myModule.factory("helloAngular", function(){      //通过factory方法创建一个服务提供者helloAngular

　　var name = "chaojidan";

　　function getName(){

　　　　return name;

　　}

　　return {

　　　　getName:getName

　　}

});

myModule.controller("myController", ["$scope", "helloAngular" ,     //通过controller方法注入helloAngular服务，也就是注入一个helloAngular服务的实例对象

　　function($scope, helloAngular){

　　　　$scope.name = helloAngular.getName();     //使用helloAngular服务的实例对象

　　}

])

第三个例子：

var myModule = angular.module("myModule", []);

myModule.service("helloAngular", function(){      //通过service方法创建一个服务提供者helloAngular

　　this.name = "chaojidan";

　　this.getName = function(){

　　　　return this.name;

　　}

});

myModule.controller("myController", ["$scope", "helloAngular" ,     //通过controller方法注入helloAngular服务，也就是注入一个helloAngular服务的实例对象

　　function($scope, helloAngular){

　　　　$scope.name = helloAngular.getName();     //使用helloAngular服务的实例对象

　　}

])

其实从angular源码可以知道，创建provider的这几种方式：provider/factory/service/constant/value，其中，

provider方法是基础，其他都是调用provider方法实现的，只是参数不同。从左到右，灵活性越差。

function provider(name, provider_) {
           assertNotHasOwnProperty(name, 'service');
           if (isFunction(provider_) || isArray(provider_)) {
                provider_ = providerInjector.instantiate(provider_);
           }
           if (!provider_.$get) {
               throw $injectorMinErr('pget', "Provider '{0}' must define $get factory method.", name);
           }
           return providerCache[name + providerSuffix] = provider_;
}

function factory(name, factoryFn) { 

　　　　return provider(name, { $get: factoryFn }); 
}
function service(name, constructor) {
            return factory(name, ['$injector', function($injector) {
                return $injector.instantiate(constructor);
            }]);
}
function value(name, val) { 

　　return factory(name, valueFn(val)); 
}
function constant(name, value) {
            assertNotHasOwnProperty(name, 'constant');
            providerCache[name] = value;
            instanceCache[name] = value;
}

createInjector方法里面，其实是通过createInternalInjector方法来创建注入器的。

function createInternalInjector(cache, factory) {
        function getService(serviceName) {     //注入器可以用来获取一个服务的实例
                if (cache.hasOwnProperty(serviceName)) {
                    if (cache[serviceName] === INSTANTIATING) {
                        throw $injectorMinErr('cdep', 'Circular dependency found: {0}', path.join(' <- '));
                    }
                    return cache[serviceName];
                } else {
                    try {
                        path.unshift(serviceName);
                        cache[serviceName] = INSTANTIATING;
                        return cache[serviceName] = factory(serviceName);
                    } catch (err) {
                        if (cache[serviceName] === INSTANTIATING) {
                            delete cache[serviceName];
                        }
                        throw err;
                    } finally {
                        path.shift();
                    }
                }
        }

        function invoke(fn, self, locals){    //可以用来调用一个方法
                var args = [],
                    $inject = annotate(fn),
                    length, i,
                    key;

                for(i = 0, length = $inject.length; i < length; i++) {
                    key = $inject[i];
                    if (typeof key !== 'string') {
                        throw $injectorMinErr('itkn',
                            'Incorrect injection token! Expected service name as string, got {0}', key);
                    }
                    args.push(
                        locals && locals.hasOwnProperty(key)
                            ? locals[key]
                            : getService(key)
                    );
                }
                if (!fn.$inject) {
                    // this means that we must be an array.
                    fn = fn[length];
                }

                // http://jsperf.com/angularjs-invoke-apply-vs-switch
                // #5388
                return fn.apply(self, args);
      }

     function instantiate(Type, locals) {   //可以用来实例化一个对象
                var Constructor = function() {},
                    instance, returnedValue;

                // Check if Type is annotated and use just the given function at n-1 as parameter
                // e.g. someModule.factory('greeter', ['$window', function(renamed$window) {}]);
                Constructor.prototype = (isArray(Type) ? Type[Type.length - 1] : Type).prototype;
                instance = new Constructor();
                returnedValue = invoke(Type, instance, locals);

                return isObject(returnedValue) || isFunction(returnedValue) ? returnedValue : instance;
    }

    return {    //返回的对象，其实就是注入器
                invoke: invoke,
                instantiate: instantiate,
                get: getService,
                annotate: annotate,    //可以用来分析一个函数的签名
                has: function(name) {
                    return providerCache.hasOwnProperty(name + providerSuffix) || cache.hasOwnProperty(name);
                }
    };
}

注入器总共有invoke，instantiate，get，annotate，has五个方法，其中，annotate用来分析一个函数的签名，也就是函数的参数，invoke用来调用一个函数，get用来获得一个服务的实例对象，instantiate用来实例化一个对象。

angularJS在初始化启动时，注册了一些内置的provider。在publishExternalAPI方法中：

$provide.provider({
                    $anchorScroll: $AnchorScrollProvider,
                    $animate: $AnimateProvider,
                    $browser: $BrowserProvider,
                    $cacheFactory: $CacheFactoryProvider,
                    $controller: $ControllerProvider,
                    $document: $DocumentProvider,
                    $exceptionHandler: $ExceptionHandlerProvider,
                    $filter: $FilterProvider,
                    $interpolate: $InterpolateProvider,
                    $interval: $IntervalProvider,
                    $http: $HttpProvider,
                    $httpBackend: $HttpBackendProvider,
                    $location: $LocationProvider,
                    $log: $LogProvider,
                    $parse: $ParseProvider,
                    $rootScope: $RootScopeProvider,
                    $q: $QProvider,
                    $sce: $SceProvider,
                    $sceDelegate: $SceDelegateProvider,
                    $sniffer: $SnifferProvider,
                    $templateCache: $TemplateCacheProvider,
                    $timeout: $TimeoutProvider,
                    $window: $WindowProvider
});

我们以$controller: $ControllerProvider,为例子，来看下内置的provider是如何定义的？

    function $ControllerProvider() {
        var controllers = {},
            CNTRL_REG = /^(\S+)(\s+as\s+(\w+))?$/;
        this.register = function(name, constructor) {
            assertNotHasOwnProperty(name, 'controller');
            if (isObject(name)) {
                extend(controllers, name);
            } else {
                controllers[name] = constructor;
            }
        };
        this.$get = ['$injector', '$window', function($injector, $window) {    //provider必须有$get方法
            return function(expression, locals) {
                var instance, match, constructor, identifier;
                if(isString(expression)) {
                    match = expression.match(CNTRL_REG),
                        constructor = match[1],
                        identifier = match[3];
                    expression = controllers.hasOwnProperty(constructor)
                        ? controllers[constructor]
                        : getter(locals.$scope, constructor, true) || getter($window, constructor, true);
                    assertArgFn(expression, constructor, true);
                }
                instance = $injector.instantiate(expression, locals);    //当你想去拿控制器，也就是controller实例时，实际上是注入器帮你实例化的。
                if (identifier) {
                    if (!(locals && typeof locals.$scope == 'object')) {
                        throw minErr('$controller')('noscp',
                            "Cannot export controller '{0}' as '{1}'! No $scope object provided via `locals`.",
                            constructor || expression.name, identifier);
                    }
                    locals.$scope[identifier] = instance;
                }
                return instance;
            };
        }];
    }

当你的应用中，需要控制器实例对象时，也就是需要controller这个服务时，实际上是注入器在ControllerProvider（控制器服务提供者）中实例化一个控制器实例对象，然后给应用的（注入进去）。

加油！