目录@H_502_1@
Angular 4 依赖注入教程之七 ValueProvider的使用
阅读须知@H_502_1@
Angular 4 依赖注入教程之七 ValueProvider的使用
本系列教程的开发环境及开发语言:
基础知识@H_502_1@
ValueProvider 的作用
ValueProvider 用于告诉 Injector (注入器),但使用 Token
获取依赖对象时,则返回 useValue
指定的值。
ValueProvider 的使用
const provider: ValueProvider = {provide: 'someToken',useValue: 'someValue'};
ValueProvider 接口
export interface ValueProvider { // 用于设置与依赖对象关联的Token值,Token值可能是Type、InjectionToken、 // OpaqueToken的实例或字符串 provide: any; // 设置注入的对象 useValue: any; // 用于标识是否multiple providers,若是multiple类型,则返回与Token关联的依赖 // 对象列表 multi?: boolean; }
json-server 简介
json-server 用于基于 JSON 数据快速地创建本地模拟的 REST
API。
json-server 的安装
npm install -g json-server
json-server 的使用
json-server --watch db.json
Angular CLI 代理配置
创建 proxy.conf.json
文件
{ "/heros": { "target": "http://localhost:3000","secure": false } }
更新 package.json
文件
{ "scripts": { "start": "ng serve --proxy-config proxy.conf.json",} }
ValueProvider@H_502_1@
介绍完基础知识,我们马上进入正题。不知道大家是否还记得,在 "组件服务注入" 文章中提到的内容:
难道一切就这么结束了,No! No!别忘记了我们这节课的主题是介绍如何在组件中注入服务。在目前的
HeroComponent
组件,我们的英雄列表信息是固定的,在实际的开发场景中,一般需要从远程服务器获取相应的信息。
接下来我们将重构我们的 HeroService
服务,从 API 接口中获取英雄数据。要使用 Angular 的 Http
服务,首先需要在 AppModule
模块中导入 HttpModule
,然后在 HeroService
类的构造函数中注入 Http
服务。
更新 HeroService 服务
import { Injectable } from '@angular/core'; import { Http } from '@angular/http'; import { Observable } from 'rxjs/Observable'; import 'rxjs/add/operator/map'; import { LoggerService } from './logger.service'; @Injectable() export class HeroService { constructor(private loggerService: LoggerService,private http: Http) { } apiUrl = 'http://localhost:4200/heros'; getHeros(): Observable<Array<{ id: number; name: string }>> { this.loggerService.log('Fetching heros...'); return this.http.get(this.apiUrl) .map(res => res.json()) } }
在 HeroService
服务中,我们通过注入 Http
服务对象的 get()
方法发送 HTTP
请求,从而从 API
接口中获取英雄的数据。
更新 HeroComponent 组件
import { Component,OnInit } from '@angular/core'; import { HeroService } from '../hero.service'; import { LoggerService } from '../logger.service'; @Component({ selector: 'app-hero',template: ` <ul> <li *ngFor="let hero of heros"> ID: {{hero.id}} - Name: {{hero.name}} </li> </ul> ` }) export class HeroComponent implements OnInit { heros: Array<{ id: number; name: string }>; constructor(private heroService: HeroService,private loggerService: LoggerService) { } ngOnInit() { this.loggerService.log('Fetching heros...'); this.heroService.getHeros() .subscribe(res => { this.heros = res; }); } }
更新完上述代码,成功保存后,你会发现 http://localhost:4200/
页面,一片空白。这就对了,因为我们还没有启动本地的 json-server
服务器。接下来我们来配置并启动本地的 json-server
服务器:
创建 heros.json
文件
{ "heros": [ {"id":11,"name":"Mr. Nice"},{"id":12,"name":"Narco"},{"id":13,"name":"Bombasto"},{"id":14,"name":"Celeritas"},{"id":15,"name":"Magneta"} ] }
启动 json-server
服务器
json-server --watch heros.json
当成功启动 json-server
服务器,在命令行中,你将看到以下输出信息:
\{^_^}/ hi! Loading heros.json Done
这表示本地 json-server
已经成功启动,此时重新刷新以下 http://localhost:4200/
页面,你将看到以下信息:
ID: 11 - Name: Mr. Nice ID: 12 - Name: Narco ID: 13 - Name: Bombasto ID: 14 - Name: Celeritas ID: 15 - Name: Magneta
程序终于又正常运行了,但注意到 HeroService
服务中,我们通过以下方式定义 API
接口地址:
@Injectable() export class HeroService { ... apiUrl = 'http://localhost:4200/heros'; }
这种方式有个问题,假设其它服务也要使用该地址,那么就得按照同样的方式去定义 API
接口地址。另外假设 API
接口地址需要更新,那就需要修改多个地方。针对上述问题,我们可以使用 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()) } }
在 HeroService
类的构造函数中,我们通过 @Inject('apiUrl')
方式,注入 apiUrl
该 Token
对应的依赖对象,即 'http://localhost:4200/heros'
。为什么不能使用 private apiUrl: 'apiUrl'
的方式,希望读者好好回忆一下,之前我们介绍过的相关内容。
以上代码成功运行后,在 http://localhost:4200/
页面,我们将看到预期的结果:
ID: 11 - Name: Mr. Nice ID: 12 - Name: Narco ID: 13 - Name: Bombasto ID: 14 - Name: Celeritas ID: 15 - Name: Magneta
我有话说@H_502_1@
为什么在构造函数中,非 Type 类型的参数只能用 @Inject(Something) 的方式注入 ?
因为 Type
类型的对象,会被 TypeScript
编译器编译。即我们通过 class
关键字声明的服务,最终都会编译成 ES5
的函数对象。
在构造函数中,Type 类型的参数能用 @Inject(Type) 的方式注入么?
Type
类型的参数也能使用 @Inject(Type)
的方式注入,具体如下:
constructor(@Inject(Http) private http) { }
同样也可以使用以下方式:
constructor(@Inject(Http) private http: Http) { }
第一种方式虽然可以正常编译,但 IDE 会有如下的提示信息:
[ts] Parameter 'http' implicitly has an 'any' type.
第二种方式,虽然 Angular 内部会合并 design:paramtypes 与 parameters 内的 Metadata 信息,但本人觉得是有点冗余了。 总而言之,若果是 Type 类型的参数,推荐使用下面的方式:
constructor(private http: Http) { }
若有兴趣了解 Inject
装饰器的详细信息,请参考 Angular 2 Inject 这篇文章。