本系列教程的開發(fā)環(huán)境及開發(fā)語(yǔ)言:
ValueProvider 用于告訴 Injector (注入器),但使用 Token
獲取依賴對(duì)象時(shí),則返回 useValue
指定的值。
const provider: ValueProvider = {provide: 'someToken', useValue: 'someValue'};
export interface ValueProvider {
// 用于設(shè)置與依賴對(duì)象關(guān)聯(lián)的Token值,Token值可能是Type、InjectionToken、
// OpaqueToken的實(shí)例或字符串
provide: any;
// 設(shè)置注入的對(duì)象
useValue: any;
// 用于標(biāo)識(shí)是否multiple providers,若是multiple類型,則返回與Token關(guān)聯(lián)的依賴
// 對(duì)象列表
multi?: boolean;
}
json-server 用于基于 JSON 數(shù)據(jù)快速地創(chuàng)建本地模擬的 REST
API。
npm install -g json-server
json-server --watch db.json
proxy.conf.json
文件{
"/heros": {
"target": "http://localhost:3000",
"secure": false
}
}
package.json
文件{
"scripts": {
"start": "ng serve --proxy-config proxy.conf.json",
}
}
介紹完基礎(chǔ)知識(shí),我們馬上進(jìn)入正題。不知道大家是否還記得,在 "組件服務(wù)注入" 文章中提到的內(nèi)容:
難道一切就這么結(jié)束了,No! No!別忘記了我們這節(jié)課的主題是介紹如何在組件中注入服務(wù)。在目前的
HeroComponent
組件,我們的英雄列表信息是固定的,在實(shí)際的開發(fā)場(chǎng)景中,一般需要從遠(yuǎn)程服務(wù)器獲取相應(yīng)的信息。
接下來(lái)我們將重構(gòu)我們的 HeroService
服務(wù),從 API 接口中獲取英雄數(shù)據(jù)。要使用 Angular 的 Http
服務(wù),首先需要在 AppModule
模塊中導(dǎo)入 HttpModule
,然后在 HeroService
類的構(gòu)造函數(shù)中注入 Http
服務(wù)。
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
服務(wù)中,我們通過(guò)注入 Http
服務(wù)對(duì)象的 get()
方法發(fā)送 HTTP
請(qǐng)求,從而從 API
接口中獲取英雄的數(shù)據(jù)。
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;
});
}
}
更新完上述代碼,成功保存后,你會(huì)發(fā)現(xiàn) http://localhost:4200/
頁(yè)面,一片空白。這就對(duì)了,因?yàn)槲覀冞€沒有啟動(dòng)本地的 json-server
服務(wù)器。接下來(lái)我們來(lái)配置并啟動(dòng)本地的 json-server
服務(wù)器:
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
服務(wù)器json-server --watch heros.json
當(dāng)成功啟動(dòng) json-server
服務(wù)器,在命令行中,你將看到以下輸出信息:
\{^_^}/ hi!
Loading heros.json
Done
這表示本地 json-server
已經(jīng)成功啟動(dòng),此時(shí)重新刷新以下 http://localhost:4200/
頁(yè)面,你將看到以下信息:
ID: 11 - Name: Mr. Nice
ID: 12 - Name: Narco
ID: 13 - Name: Bombasto
ID: 14 - Name: Celeritas
ID: 15 - Name: Magneta
程序終于又正常運(yùn)行了,但注意到 HeroService
服務(wù)中,我們通過(guò)以下方式定義 API
接口地址:
@Injectable()
export class HeroService {
...
apiUrl = 'http://localhost:4200/heros';
}
這種方式有個(gè)問(wèn)題,假設(shè)其它服務(wù)也要使用該地址,那么就得按照同樣的方式去定義 API
接口地址。另外假設(shè) API
接口地址需要更新,那就需要修改多個(gè)地方。針對(duì)上述問(wèn)題,我們可以使用 ValueProvider
來(lái)解決問(wèn)題。
@NgModule({
...,
providers: [
{
provide: 'apiUrl',
useValue: 'http://localhost:4200/heros'
}
],
bootstrap: [AppComponent]
})
export class AppModule { }
@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
類的構(gòu)造函數(shù)中,我們通過(guò) @Inject('apiUrl')
方式,注入 apiUrl
該 Token
對(duì)應(yīng)的依賴對(duì)象,即 'http://localhost:4200/heros'
。為什么不能使用 private apiUrl: 'apiUrl'
的方式,希望讀者好好回憶一下,之前我們介紹過(guò)的相關(guān)內(nèi)容。
以上代碼成功運(yùn)行后,在 http://localhost:4200/
頁(yè)面,我們將看到預(yù)期的結(jié)果:
ID: 11 - Name: Mr. Nice
ID: 12 - Name: Narco
ID: 13 - Name: Bombasto
ID: 14 - Name: Celeritas
ID: 15 - Name: Magneta
因?yàn)?Type
類型的對(duì)象,會(huì)被 TypeScript
編譯器編譯。即我們通過(guò) class
關(guān)鍵字聲明的服務(wù),最終都會(huì)編譯成 ES5
的函數(shù)對(duì)象。
Type
類型的參數(shù)也能使用 @Inject(Type)
的方式注入,具體如下:
constructor(@Inject(Http) private http) { }
同樣也可以使用以下方式:
constructor(@Inject(Http) private http: Http) { }
第一種方式雖然可以正常編譯,但 IDE 會(huì)有如下的提示信息:
[ts] Parameter 'http' implicitly has an 'any' type.
第二種方式,雖然 Angular 內(nèi)部會(huì)合并 design:paramtypes 與 parameters 內(nèi)的 metadata 信息,但本人覺得是有點(diǎn)冗余了。 總而言之,若果是 Type 類型的參數(shù),推薦使用下面的方式:
constructor(private http: Http) { }
若有興趣了解 Inject
裝飾器的詳細(xì)信息,請(qǐng)參考 Angular 2 Inject 這篇文章。
更多建議: