AngularJS服务及注入--Provider

Provider简介

在AngularJS中，app中的大多数对象通过injector服务初始化和连接在一起。

Injector创建两种类型的对象，service对象和特别对象。

Service对象由开发者自定义api。

特别对象则遵照AngularJS框架特定的api，这些对象包括：controller, directive, filter or animation。

最详细最全面的是Provider，其他四种（Value, Factory, Service and Constant）只是在Provider“”之上包装了一下而已。

为了使injector知道怎么样创建和链接这些对象，你需要recipe的注册表。每一个recipe都有一个对象的id和怎样创建对象的说明。

当AngularJS使用给定的app module启动app时，angularjs会创建一个新的injector实例，injector会依次把核心module的“配方”加入“配方”注册表，并且创建app module和他的依赖。当需要为app创建对象时，就会去查找“配方”注册表。

Value

代码中可能多个地方需要访问一个共享的字符串，我们先用Value“配方”来实现这种情境。

我们来创建一个非常简单的service，该service提供一个用于远程api鉴权的id字符串，可以这么写：

<!DOCTYPE html>
<html ng-app="myApp">
<head>
    <meta charset="uft-8"/>
    <title></title>
</head>
<script src="script/angular.min.js"></script>
<body ng-controller="DemoController as demo">
Client ID: {{demo.clientId}}
</body>
<script>
    var myApp = angular.module('myApp', []);
    myApp.value('clientId', 'a12345654321x');

    myApp.controller('DemoController', ['clientId', function DemoController(clientId) {
        this.clientId = clientId;
    }]);
</script>
</html>

我们创建了一个名字叫myApp的module，并且指定该module的定义包含一个构建clientId服务的recipe，这个例子中service仅仅是一个字符串。

这个例子中我们使用value“配方”定义了一个值供DemoController需要一个clientId的service时调用。

factory

Value“配方”虽然简单，但是缺少我们创建service时需要的很多重要的功能，Factory“配方”就强大很多，有以下功能：

可以通过依赖使用其他service
service初始化
延迟初始化

Factory“配方”可以使用0个或者多个参数创建service，这些参数可以是依赖的其他service。函数的返回值是一个通过“配方”创建的service实例。

在angularjs中所有的service都是单例的，这意味着injector为了创建对象只使用每个一次，然后injector把service的引用缓存起来，以便将来可以调用。

示例：

<!DOCTYPE html>
<html ng-app="myApp">
<head>
    <meta charset="uft-8"/>
    <title></title>
</head>
<script src="script/angular.min.js"></script>
<body ng-controller="DemoController as demo">
Client ID: {{demo.clientId}}
</body>
<script>
    var myApp = angular.module('myApp', []);
    //myApp.value('clientId', 'a12345654321x');
    myApp.factory("clientId",function(){
        return "a12345654321x";
    });

    myApp.controller('DemoController', ['clientId', function DemoController(clientId) {
        this.clientId = clientId;
    }]);
</script>
</html>

如果仅仅是返回一个token这么简单，那么value“配方”则更合适，因为写起来简单也容易明白。

但是我们希望创建一个复杂点的service来计算token做远程api的身份验证，这个token叫做apiToken，通过clientId的值和浏览器本地存储中的secret值计算得出。

以上代码可以看到如何依赖clientId服务通过Factory“配方”创建apiToken服务。

factory的函数名最好使用<serviceId>Factory形式命名，例如apiTokenFactory，当然函数名是可以不要的，但是为了调试方便还是最好写上。

同Value”配方“一样，Factory”配方“可以创建任意类型的服务，无论是原始类型，对象，函数还是自定义的类型。

service“配方”

javascript开发者经常喜欢写面向对象的自定义类型，现在让我们通过unicornLauncher服务把一个unicorn发射到太空，unicornLauncher是一个自定义类型的实例。

function UnicornLauncher(apiToken) {

  this.launchedCount = 0;
  this.launch = function() {
    // 使用apiToken访问远程api
    ...
    this.launchedCount++;
  }
}

现在我们准备发射独角兽，注意到UnicornLauncher依赖于apiToken，我们通过Factory”配方“来满足这个依赖：

myApp.factory('unicornLauncher', ["apiToken", function(apiToken) {
  return new UnicornLauncher(apiToken);
}]);

然而这个例子使用service“配方”更为合适

Service”配方“可以像Value”配方“和Factory“配方”一样生产service，但是它可以通过new操作符调用对象的构造函数。构造函数的参数可以通过Service“配方中”的依赖项加入。

Service“配方”的设计模式叫做构造器注入（constructor injection）。

既然我已经有了UnicornLauncher多多构造器，我们可以把Factory”配方”替换为Service“配方”。

myApp.service('unicornLauncher', ["apiToken", UnicornLauncher]);

Provider“配方”

Provider“配方”是核心“配方”，其他所有的“配方”仅仅是在它里面加了点糖。它是最多能力最详细的“配方”，但是对于大多数service来说，不是所有的能力都有用。

Provider“配方”定义了一个实现了$get方法的自定义类型。$get方法是一个Factory函数，很像Factory“配方”定义的Factory函数一样。事实上，如果你定义了一个Factory“配方”，框架会创建一个空的Provider类型，其中的$get方法就会指向你定义的Factory方法。

在app启动时，我们需要一些配合时，这个时候才会需要Provider披露的API。通常是一些可以重用的service。

默认情况下，发射器发射unicorn到太空是没有任何防护的，但是有些行星上大气层太厚了，在unicorn开始它的太空旅行之前，我们需要为它包裹tinfoil，否则她没通过大气层时会摩擦燃烧。配置代码如下：

myApp.provider('unicornLauncher', function UnicornLauncherProvider() {
    var useTinfoilShielding = false;

    this.useTinfoilShielding = function(value) {
        useTinfoilShielding = !!value;
    };

    this.$get = ["apiToken", function unicornLauncherFactory(apiToken) {

        // 我们假设UnicornLauncher构造函数已更改，可以接收useTinfoilShielding参数
        return new UnicornLauncher(apiToken, useTinfoilShielding);
    }];
});

在程序启动时，config函数中调用unicornLauncherProvider的方式如下：

myApp.config(["unicornLauncherProvider", function(unicornLauncherProvider) {
  unicornLauncherProvider.useTinfoilShielding(true);
}]);

unicornLauncherProvider是被注入到config方法中的，这里的injector和常规的实例injector不同，它只负责provider的初始化和连接。

在app启动之时，在创建service之前，它会配置和实例化所有的provider，我们把这个叫做app生命周期的配置阶段，在这个阶段，service还不可使用，因为他们还未创建。

一旦配置阶段完成，那么所有的provider变为不可用，创建service的进程开始启动，这个阶段被叫做app生命周期的运行阶段。

Constant“配方”

我们刚刚了解了如何区分app生命周期的配置阶段和运行阶段，还有怎么样通过config函数配置app。因为配置函数在配置阶段执行，这时service都是不可以用的，它甚至无法访问通过Value“配方”创建的简单的值对象。

有一些简单的值，比如url的前缀，没有任何依赖和配置，常常需要配置阶段和运行阶段都可以方便的访问，
Constant“配方”的作用就在这了。

假设我们的unicornLauncher服务需要使用它的所在行星的名字来标记，行星的名字可以在配置阶段提供。行星的名字对于每个app是特定的，运行阶段会在各种各样的controller中使用。我们可以这样这样定义行星的名字作为一个常量：

myApp.constant('planetName', 'Greasy Giant');

配置unicornLauncherProvider如下：

myApp.config(['unicornLauncherProvider', 'planetName', function(unicornLauncherProvider, planetName) {
  unicornLauncherProvider.useTinfoilShielding(true);
  unicornLauncherProvider.stampText(planetName);
}]);

Constant“配方”和Value“配方”一样在配置阶段是可用的，可用用于controller和模板：

myApp.controller('DemoController', ["clientId", "planetName", function DemoController(clientId, planetName) {
  this.clientId = clientId;
  this.planetName = planetName;
}]);

<html ng-app="myApp">
  <body ng-controller="DemoController as demo">
   Client ID: {{demo.clientId}}
   <br>
   Planet Name: {{demo.planetName}}
  </body>
</html>

特殊用途的object

之前提到有些特殊用途的对象和service是不同的，这些对象作为插件来扩展angularjs框架，需要实现angularjs指定的接口，这些接口是Controller, Directive, Filter 和 Animation。

这些特殊对象除controller外，其余的在底层其实是由Factory“配方”创建的。

在下面的例子中，我们演示如何通过Directive的api创建一个简单的组件，这个组件依赖于我们之前定义的planetName常量，并显示这个常量：“Planet Name: Greasy Giant”

由于Directive是通过Factory“配方”注册的，我们采用Factory相同的语法：

myApp.directive('myPlanet', ['planetName', function myPlanetDirectiveFactory(planetName) {
  // directive definition object
  return {
    restrict: 'E',
    scope: {},
    link: function($scope, $element) { $element.text('Planet: ' + planetName); }
  }
}]);

然后使用这个组件：

<html ng-app="myApp">
  <body>
   <my-planet></my-planet>
  </body>
</html>

使用Factory“配方”也可以定义filter和animation，但是controller有点特殊。你能创建controller作为一个自定义类型，它的依赖可以从它的构造函数中传入，这个构造器又被module用来注册controller。我们来看下我之前写的DemoController：

myApp.controller('DemoController', ['clientId', function DemoController(clientId) {
  this.clientId = clientId;
}]);

每次app需要DemoController实例的时候，就好调用它的构造器进行初始化。因此和service不一样，controller不是单例的。构造器可以注入其他service。

总结

让我们来总结一下：

injector使用“配方”创建两种对象：service和特殊用途对象
有五种“配方”可以创建对象：Value, Factory, Service, Provider, Constant.
Factory和Service是使用最多的“配方”。他们之间唯一的区别是：Service“配方”更适合自定义类型的对象，而Factory“配方”更适合原生对象和函数。
Provider“配方”是最核心的“配方”，其他“配方”只是在它上面加点糖。
Provider“配方”是最复杂的“配方”，除非你需要全局配置的代码，而这代码你还想不断复用。
所有的特殊对象除了controller都是使用Factory“配方”创建的

Features / Recipe type	Factory	Service	Value	Constant	Provider
能否依赖与其他对象	yes	yes	no	no	yes
能否友好的注入到其他对象	no	yes	yes*	yes*	no
创建的对象配置阶段是否可用	no	no	no	yes	yes**
能否创建函数	yes	yes	yes	yes	yes
能否创建原生类型	yes	no	yes	yes	yes

* 需要使用new操作符付出预先初始化的代价

** service在配置阶段不可用，但是provider对象在配置阶段可用

posted @ 2017-11-09 11:29 慕容小凡阅读(6394) 评论(1) 编辑收藏举报

刷新页面返回顶部

慕容小凡

天下武功，唯快不破