Angular 4 依赖注入教程之八 InjectToken的使用

8

目录

阅读须知

本系列教程的开发环境及开发语言:

基础知识

OpaqueToken 简介

OpaqueToken 用于创建可在 Provider 中使用的 Token

OpaqueToken 类的定义

export class OpaqueToken {
  constructor(protected _desc: string) {}

  toString(): string { return `Token ${this._desc}`; }
}

OpaqueToken 类的使用

import { ReflectiveInjector } from '@angular/core';

var t = new OpaqueToken("value");
var injector = ReflectiveInjector.resolveAndCreate([
  {provide: t, useValue: "bindingValue"}
]);
injector.get(t); // "bindingValue"

InjectionToken 简介

InjectionToken 用于创建可在 Provider 中使用的 Token

InjectionToken 类的定义

export class InjectionToken<T> extends OpaqueToken {
  private _differentiate_from_OpaqueToken_structurally: any;
  constructor(desc: string) { super(desc); }

  toString(): string { return `InjectionToken ${this._desc}`; }
}

InjectionToken 类的使用

import { ReflectiveInjector } from '@angular/core';

var t = new InjectionToken<string>("value");
var injector = ReflectiveInjector.resolveAndCreate([
  {provide: t, useValue: "bindingValue"}
]);
injector.get(t); // "bindingValue"

InjectionToken

在介绍 InjectionToken 相关内容之前,我们先回顾一下 "ValueProvider的使用" 这篇中我们介绍的内容:

使用 ValueProvider

@NgModule({
   ...,
   providers: [
    {
      provide: 'apiUrl',
      useValue: 'http://localhost:4200/heros'
    }
   ],
  bootstrap: [AppComponent]
})
export class AppModule { }

更新 HeroService 服务

@Injectable()
export class HeroService {
    constructor(private loggerService: LoggerService,
        private http: Http,
        @Inject('apiUrl') private apiUrl) { }

    getHeros(): Observable<Array<{ id: number; name: string }>> {
        this.loggerService.log('Fetching heros...');
        return this.http.get(this.apiUrl)
            .map(res => res.json())
    }
}

为了能够更方便地管理与维护 apiUrl 地址,我们利用了 ValueProviderInject 装饰器。一切看起来非常顺利,但某一天假设我们引入了一个第三方库 - third-lib.ts,该文件的内容如下所示:

export const THIRD_PARTY_PROVIDERS = [
    {
        provide: 'apiUrl',
        useValue: 'Other Url'
    }
];

接着我们在 AppModule 中配置对应的 Provider 信息,具体如下:

import { THIRD_PARTY_PROVIDERS } from './third-party';

@NgModule({
   ...,
   providers: [
    {
      provide: 'apiUrl',
      useValue: 'http://localhost:4200/heros'
    },
    THIRD_PARTY_PROVIDERS
   ],
  bootstrap: [AppComponent]
})
export class AppModule { }

当更新完上述代码,成功保存后,你会发现 http://localhost:4200/ 页面,又是空空如也了。这时如果我们打开开发者工具,切换到 Console 面板你会看到如下异常信息:

GET http://localhost:4200/Other%20value 404 (Not Found)

什么情况,我们的英雄信息的接口地址被替换了,其实真正的原因是使用字符串作为 Token 引起冲突了。那么怎么解决呢?最简单的方式是对调一下 ValueProviderTHIRD_PARTY_PROVIDERS 的位置。你会发现在 http://localhost:4200/ 页面,你又能看到英雄信息。当然这不能解决本质问题,因为这样会导致你引入的第三方库不能正常工作。

相信很多读者已经习惯了我的 "套路",当然要让我们的主角 - InjectionToken 出马,来解决这个问题咯。为了统一管理应用中的 Token 信息 ,我们新建一个 app.tokens.ts 文件来保存应用中的 Token 信息。该文件的具体内容如下:

import { InjectionToken } from '@angular/core';

export const API_URL = new InjectionToken<string>('apiUrl');

接下来我们在更新一下 AppModule

import { API_URL } from './app.tokens';

@NgModule({
   ...,
   providers: [
    {
      provide: API_URL,
      useValue: 'http://localhost:4200/heros'
    },
    THIRD_PARTY_PROVIDERS
   ],
  bootstrap: [AppComponent]
})
export class AppModule { }

然后在更新 HeroService 服务,具体更新内容如下:

import { API_URL } from './app.tokens';

@Injectable()
export class HeroService {
  constructor(private loggerService: LoggerService,
    private http: Http,
    @Inject(API_URL) private apiUrl) { }
}

当更新完上述代码,成功保存后,你会发现 http://localhost:4200/ 页面,又能正常显示英雄信息了。问题已经解决了,但其实这是因为我们使用了不同的 Token 。我们再来验证一个问题:

import { InjectionToken } from '@angular/core';

const API_URL = new InjectionToken<string>('apiUrl');

export const THIRD_PARTY_PROVIDERS = [
    {
        provide: API_URL,
        useValue: 'Other value'
    }
];

你会发现更新完 third-lib.ts 库,且成功保存后,在 http://localhost:4200/ 页面,还是能正常显示英雄信息。此时,我们的 Angular 4 依赖注入教程已经结束了,但其实本教程只介绍了 Angular 依赖注入的部分知识。如果读者有兴趣的话,可以继续了解以下的内容:

我有话说

OpaqueToken 与 InjectionToken 有什么区别?

相同点

  • 它们都是用于创建可在 Provider 中使用的 Token

不同点

  • OpaqueTokenAngular 2.x 版本中引入的类。

  • InjectionToken 是在 Angular 4.x 版本中引入的类,该类继承于 OpaqueToken,且引入了泛型用于定义所关联的依赖对象的类型。

AngularJS 1.x DI 系统存在的问题

  • 内部缓存:AngularJS 1.x 应用程序中所有的依赖项都是单例,我们不能灵活地控制是否使用新的实例。

  • 命名空间冲突: 在系统中我们使用字符串来标识服务 (Service) 的名称,假设我们在项目中已有一个 CarService,然而第三方库中也引入了同样的服务,这样的话就容易出现冲突。

  • DI 耦合度太高: AngularJS 1.x 中 DI 功能已经被框架集成了,我们不能单独使用它的依赖注入功能。

  • 未能和模块加载器结合: 在浏览器环境中,很多场景都是异步的过程,我们需要的依赖模块并不是一开始就加载好的,或许我们在创建的时候才会去加载依赖模块,再进行依赖创建,而 AngularJS 1.x 的 DI 系统没法做到这点。


如果觉得我的文章对你有用,请随意赞赏

你可能感兴趣的

李运华 · 2018年07月03日

Angular Element Injector 这个系列的不知道完成了没有?谢谢作者 辛苦!

回复

颛赤隐 · 4月29日

写的真的好,深入浅出,看原文档很多不懂的地方都有所领悟,谢谢

回复

载入中...