非常教程

AngularJS参考手册

依赖注入

多级注入器

在依赖注入一章中,你已经学过了 Angular 依赖注入的基础知识。

Angular 有一个多级依赖注入系统。 实际上,应用程序中有一个与组件树平行的注入器树(译注:平行是指结构完全相同且一一对应)。 你可以在组件树中的任何级别上重新配置注入器。

本文将浏览这个体系,并告诉你如何善用它。

试试在线例子 / 下载范例。

注入器树

在依赖注入一章中,你学过如何配置依赖注入器,以及如何在需要时用它获取依赖。

实际上,没有那个(唯一的)注入器这回事,一个应用中可能有多个注入器。 一个 Angular 应用是一个组件树。每个组件实例都有自己的注入器! 组件的树与注入器的树平行。

组件的注入器可能是一个组件树中更高级的祖先注入器的代理。 但这只是提升效率的实现细节,你不用在乎这点差异,在你的脑海里只要想象成每个组件都有自己的注入器就可以了。

考虑《英雄指南》应用的一个简单变种。它的顶层是 AppComponent 组件,它有一些子组件。 HeroesListComponent 组件保存和管理着 HeroTaxReturnComponent 的多个实例。 下图展示了当 HeroesCardComponent 的三个 HeroTaxReturnComponent 实例同时展开时的三级组件树状态。

多级注入器

注入器冒泡

当一个组件申请获得一个依赖时,Angular 先尝试用该组件自己的注入器来满足它。 如果该组件的注入器没有找到对应的提供商,它就把这个申请转给它父组件的注入器来处理。 如果那个注入器也无法满足这个申请,它就继续转给它的父组件的注入器。 这个申请继续往上冒泡 —— 直到找到了一个能处理此申请的注入器或者超出了组件树中的祖先位置为止。 如果超出了组件树中的祖先还未找到,Angular 就会抛出一个错误。

你还可以“盖住”这次冒泡。一个中层的组件可以声称自己是“宿主”组件。 向上查找提供商的过程会截止于这个“宿主”组件。 这个问题先放一放,等改天再讨论它。

在不同层级再次提供同一个服务

你可以在注入器树中的多个层次上为指定的依赖令牌重新注册提供商。 但并非必须重新注册,事实上,虽然可以重新注册,但除非有很好的理由,否则不应该这么做。

服务解析逻辑会自下而上查找,碰到的第一个提供商会胜出。 因此,注入器树中间层注入器上的提供商,可以拦截来自底层的对特定服务的请求。 这导致它可以“重新配置”和者说“遮蔽”高层的注入器。

如果你只在顶级(通常是根模块 AppModule),这三个注入器看起来将是“平面”的。 所有的申请都会冒泡到根NgModule进行处理,也就是你在 bootstrapModule 方法中配置的那个。

组件注入器

在不同层次上重新配置一个或多个提供商的能力,开启了一些既有趣又有用的可能性。

场景:服务隔离

出于架构方面的考虑,可能会让你决定把一个服务限制到只能在它所属的特定领域中访问。

本章的范例中包括一个 VillainsListComponent,它显示一个反派的列表。

虽然你也可以在根模块 AppModule 中提供 VillainsService(就像 HeroesService 那样),不过那样一来就会导致在整个应用中到处都能访问到 VillainsService,包括在英雄工作流中。

如果你以后修改了 VillainsService,那就可能会破坏英雄组件中的某些部分。 这可不妙,但是在根模块 AppModule 中提供这个服务可能会导致这种风险。

可以换一种方案:在 VillainsListComponent 元数据的 providers 中提供 VillainsService,就像这样:

src/app/villains-list.component.ts (metadata)

content_copy@Component({
  selector: 'app-villains-list',
  templateUrl: './villains-list.component.html',
  providers: [ VillainsService ]
})

VillainsListComponent 的元数据中而不是其它地方提供 VillainsService 服务,该服务就会只在 VillainsListComponent 及其子组件树中可用。 它仍然是单例,但是这个单例只存在于反派(villain)这个领域中。

现在,你可以确信英雄组件不会访问它,因此减少了犯错误的机会。

场景:多重编辑会话

很多应用允许用户同时进行多个任务。 比如,在纳税申报应用中,申报人可以打开多个报税单,随时可能从一个切换到另一个。

本章要示范的场景仍然是基于《英雄指南》的。 想象一个外层的 HeroListComponent,它显示一个超级英雄的列表。

要打开一个英雄的报税单,申报者点击英雄名,它就会打开一个组件来编辑那个申报单。 每个选中的申报单都会在自己的组件中打开,并且可以同时打开多个申报单。

每个报税单组件都有下列特征:

  • 属于它自己的报税单会话。
  • 可以修改一个报税单,而不会影响另一个组件中的申报单。
  • 能把所做的修改保存到它的报税单中,或者放弃它们。

多级注入器

实现方式之一就是让 HeroTaxReturnComponent 有逻辑来管理和还原那些更改。 这对于简单的报税单来说是很容易的。 不过,在现实世界中,报税单的数据模型非常复杂,对这些修改的管理可能不得不投机取巧。 于是你可以把这种管理任务委托给一个辅助服务,就像这个例子中所做的。

这是一个报税单服务 HeroTaxReturnService。 它缓存了单条 HeroTaxReturn,用于跟踪那个申报单的变更,并且可以保存或还原它。 它还委托给了全应用级的单例服务 HeroService,它是通过依赖注入机制取得的。

src/app/hero-tax-return.service.ts

content_copyimport { Injectable }    from '@angular/core';import { HeroTaxReturn } from './hero';import { HeroesService } from './heroes.service'; @Injectable()export class HeroTaxReturnService {  private currentTaxReturn: HeroTaxReturn;  private originalTaxReturn: HeroTaxReturn;   constructor(private heroService: HeroesService) { }   set taxReturn (htr: HeroTaxReturn) {    this.originalTaxReturn = htr;    this.currentTaxReturn  = htr.clone();  }   get taxReturn (): HeroTaxReturn {    return this.currentTaxReturn;  }   restoreTaxReturn() {    this.taxReturn = this.originalTaxReturn;  }   saveTaxReturn() {    this.taxReturn = this.currentTaxReturn;    this.heroService.saveTaxReturn(this.currentTaxReturn).subscribe();  }}

下面是正在使用它的 HeroTaxReturnComponent 组件。

src/app/hero-tax-return.component.ts

content_copyimport { Component, EventEmitter, Input, Output } from '@angular/core';import { HeroTaxReturn }        from './hero';import { HeroTaxReturnService } from './hero-tax-return.service'; @Component({  selector: 'app-hero-tax-return',  templateUrl: './hero-tax-return.component.html',  styleUrls: [ './hero-tax-return.component.css' ],  providers: [ HeroTaxReturnService ]})export class HeroTaxReturnComponent {  message = '';  @Output() close = new EventEmitter<void>();   get taxReturn(): HeroTaxReturn {    return this.heroTaxReturnService.taxReturn;  }  @Input()  set taxReturn (htr: HeroTaxReturn) {    this.heroTaxReturnService.taxReturn = htr;  }   constructor(private heroTaxReturnService: HeroTaxReturnService ) { }   onCanceled()  {    this.flashMessage('Canceled');    this.heroTaxReturnService.restoreTaxReturn();  };   onClose()  { this.close.emit(); };   onSaved() {    this.flashMessage('Saved');    this.heroTaxReturnService.saveTaxReturn();  }   flashMessage(msg: string) {    this.message = msg;    setTimeout(() => this.message = '', 500);  }}

通过输入属性可以得到要编辑的报税单,这个属性被实现成了读取器(getter)和设置器(setter)。 设置器根据传进来的报税单初始化了组件自己的 HeroTaxReturnService 实例。 读取器总是返回该服务所存英雄的当前状态。 组件也会请求该服务来保存或还原这个报税单。

这里有个大问题,那就是如果这个服务是一个全应用范围的单例,每个组件就都会共享同一个服务实例,每个组件也都会覆盖属于其他英雄的报税单,真是一团糟!

但仔细看 HeroTaxReturnComponent 的元数据,注意 providers 属性。

src/app/hero-tax-return.component.ts (providers)

content_copyproviders: [ HeroTaxReturnService ]

HeroTaxReturnComponent 有它自己的 HeroTaxReturnService 提供商。 回忆一下,每个组件的实例都有它自己的注入器。 在组件级提供服务可以确保组件的每个实例都得到一个自己的、私有的服务实例。 报税单不会再被意外覆盖,这下清楚了。

该场景代码中的其它部分依赖另一些 Angular 的特性和技术,你将会在本文档的其它章节学到。 你可以到在线例子 / 下载范例查看代码和下载它。

场景:专门的提供商

重新提供服务的另一个原因,是在组件树的深层中把该服务替换为一个更特殊的实现。

再次考虑依赖注入一章中车辆(Car)的例子。 假设你在根注入器(代号 A)中配置了通用的提供商:CarServiceEngineServiceTiresService

你创建了一个车辆组件(A),它显示一个从另外三个通用服务构造出的车辆。

然后,你创建一个子组件(B),它为 CarServiceEngineService 定义了自己的特殊的提供商,它们具有更特殊的能力,适用于组件 B 的。

组件 B 是另一个组件 C 的父组件,而组件 C 又定义了自己的,更特殊的CarService 提供商。

多级注入器

在幕后,每个组件都有自己的注入器,这个注入器带有为组件本身准备的 0 个、1 个或多个提供商。

当你在最深层的组件 C 解析 Car 的实例时,它使用注入器 C 解析生成了一个 Car 的实例,使用注入器 B 解析了 Engine,而 Tires 则是由根注入器 A 解析的。

多级注入器

车辆场景下的代码位于 car.components.tscar.services.ts 文件中,这个例子你可以在在线例子 / 下载范例查看和下载。

AngularJS

Angular 是一个开发平台。它能帮你更轻松的构建 Web 应用。Angular 集声明式模板、依赖注入、端到端工具和一些最佳实践于一身,为你解决开发方面的各种挑战。

AngularJS目录

1.快速上手 | quick start
2.语言服务
3.安全
4.环境准备与部署
5.Service Worker
6.保持最新
7.从 AngularJS 升级
8.服务端渲染
9.Visual Studio 2015 快速上手
10.风格指南
11.国际化
12.测试
13.路由与导航
14. 教程 | Tutorial
15.架构
16.组件与模板
17.表单
18.可观察对象与RxJS
19.引导启动
20.Angular 模块
21.依赖注入
22.HttpClient
23.词汇表
24.AngularJS 应用
25.AngularJS 模块
26.AngularJS 事件
27.AngularJS HTML DOM
28.AngularJS 过滤器
29.AngularJS 控制器
30.AngularJS 指令
31.AngularJS 表达式
32.AngularJS 简介
33.AngularJS 参考手册
34.AngularJS 实例
35.AngularJS 输入验证
36.AngularJS 表单
37.AngularJS SQL
38.AngularJS 表格
39.AngularJS Http
40.AngularJS 包含
41.AngularJS Bootstrap
42.AngularJS API
43.AngularJS ng-checked 指令
44.AngularJS ng-change 指令
45.AngularJS ng-blur 指令
46.AngularJS ng-bind-template 指令
47.AngularJS ng-bind-html 指令
48.AngularJS ng-bind 指令
49.AngularJS ng-app 指令
50.AngularJS Scope(作用域)
51.AngularJS ng-model 指令
52.AngularJS ng-dblclick 指令
53.AngularJS ng-cut 指令
54.AngularJS ng-csp 指令
55.AngularJS ng-copy 指令
56.AngularJS ng-controller 指令
57.AngularJS ng-cloak 指令
58.AngularJS ng-click 指令
59.AngularJS ng-class-odd 指令
60.AngularJS ng-class-even 指令
61.AngularJS ng-class 指令
62.AngularJS ng-keyup 指令
63.AngularJS ng-keypress 指令
64.AngularJS ng-keydown 指令
65.AngularJS ng-init 指令
66.AngularJS ng-include 指令
67.AngularJS ng-if 指令
68.AngularJS ng-href 指令
69.AngularJS ng-hide 指令
70.AngularJS ng-focus 指令
71.AngularJS ng-disabled 指令
72.AngularJS ng-non-bindable 指令
73.AngularJS ng-mouseup 指令
74.AngularJS ng-mouseover 指令
75.AngularJS ng-mousemove 指令
76.AngularJS ng-mouseleave 指令
77.AngularJS ng-mouseenter 指令
78.AngularJS ng-mousedown 指令
79.AngularJS ng-model-options 指令
80.AngularJS ng-model 指令
81.AngularJS ng-list 指令
82.AngularJS ng-style 指令
83.AngularJS ng-srcset 指令
84.AngularJS ng-src 指令
85.AngularJS ng-show 指令
86.AngularJS ng-selected 指令
87.AngularJS ng-repeat 指令
88.AngularJS ng-readonly 指令
89.AngularJS ng-paste 指令
90.AngularJS ng-options 指令
91.AngularJS ng-open 指令
92.AngularJS ng-value 指令
93.AngularJS ng-switch 指令
94.AngularJS ng-submit 指令
95.AngularJS 服务(Service)
96.AngularJS Select(选择框)
97.AngularJS 动画
98.AngularJS 依赖注入