本節(jié)我們展示如何在組件中獲取一個(gè)`YzAsyncValidators`實(shí)例。
## 手動(dòng)構(gòu)建
`YzAsyncValidators`的構(gòu)造函數(shù)中聲明了`HttpClient`,也就是構(gòu)造一個(gè)`YzAsyncValidators`實(shí)例的前提是需要一個(gè)`HttpClient`實(shí)例。
```typescript
/**
* 異步驗(yàn)證器.
*/
export class YzAsyncValidators {
constructor(private httpClient: HttpClient) {
}
```
在學(xué)生添加組件中,可以采取自動(dòng)注入的方式,輕構(gòu)的獲取到一個(gè)`HttpClient`實(shí)例:
```typescript
+++ b/first-app/src/app/student/add/add.component.ts
- constructor() {
+ constructor(private httpClient: HttpClient) {
```
然后就可以使用這個(gè)`HttpClient`實(shí)例來(lái)構(gòu)造一個(gè)`YzAsyncValidators`實(shí)例了:
```typescript
constructor(private httpClient: HttpClient) {
- const yzAsyncValidators = null as unknown as YzAsyncValidators;
+ const yzAsyncValidators = new YzAsyncValidators(httpClient);
this.formGroup = new FormGroup({
```
執(zhí)行學(xué)生新增組件的單元測(cè)試,錯(cuò)誤信息消失,當(dāng)輸入學(xué)號(hào)時(shí),在控制臺(tái)中打印信息如下:

## 完成功能
`YzAsyncValidators`有了`HttpClient`后,便可以向后臺(tái)發(fā)起請(qǐng)求,然后根據(jù)后臺(tái)的返回值情況來(lái)決定驗(yàn)證是否通過(guò)。
```typescript
+++ b/first-app/src/app/yz-async-validators.ts
numberNotExist(): (control: AbstractControl) => Observable<ValidationErrors | null> {
return (control: AbstractControl): Observable<ValidationErrors | null> => {
- console.log(this.httpClient);
- console.log('異步驗(yàn)證器被調(diào)用');
- return of(null)
- .pipe(delay(1000), tap(data => console.log('驗(yàn)證器返回?cái)?shù)據(jù)', data)));
+ const httpParams = new HttpParams()
+ .append('number', control.value); ①
+ return this.httpClient.get<boolean>③('/student/numberIsExist', {params: httpParams}) ②
+ .pipe④(map⑤(exists => exists ? {numberExist: true} : null)⑥);
};
}
}
```
- ① 創(chuàng)建了請(qǐng)求參數(shù),并將`number`加入請(qǐng)求參數(shù)中
- ② 發(fā)起了一個(gè)加入了請(qǐng)求參數(shù)的**預(yù)**請(qǐng)求,該**預(yù)**請(qǐng)求僅當(dāng)被訂閱時(shí)才會(huì)發(fā)起真正的請(qǐng)求,而`FormControl`的異步驗(yàn)證器會(huì)根據(jù)情況來(lái)決定是否進(jìn)行訂閱,從而控制是否向后臺(tái)發(fā)起請(qǐng)求。
- ③ 該預(yù)請(qǐng)求的返回值的類(lèi)型為`boolean`,這是由后面臺(tái)API返回類(lèi)型決定的。所以預(yù)請(qǐng)求的返回值類(lèi)型為`Observable<boolean>`
- ④ `pipe`的作用是使數(shù)據(jù)依次通過(guò)各個(gè)管道(操作符)。
- ⑤ `map`操作符能起到數(shù)據(jù)轉(zhuǎn)換的作用。`boolean`類(lèi)型的值由管道這頭輸入,然后它按自己的規(guī)則決定管道那頭的輸出。
- ⑥ 當(dāng)前的轉(zhuǎn)換規(guī)則是:如果管道這頭接收的是`true`,則管道那頭輸出`{numberExist: true}`;如果管道這頭接收提`false`,則管道那頭輸出的是`null`。該規(guī)則將`boolean`類(lèi)型的值成功的轉(zhuǎn)換為了`ValidationErrors | null`。便得最終的返回值類(lèi)型由`Observable<boolean>`變更為` Observable<ValidationErrors | null>`
為了更好的理解`map`操作符,我們?cè)诋?dāng)前的學(xué)生增加組件的測(cè)試文件中增加一個(gè)測(cè)試方法:
```typescript
+++ b/first-app/src/app/student/add/add.component.spec.ts
fit('理解map操作符', () => {
// 數(shù)據(jù)源發(fā)送數(shù)據(jù)1
const a = of(1) as Observable<number>;
a.subscribe(data => console.log(data));
// 數(shù)據(jù)源還是發(fā)送數(shù)據(jù)1
const b = of(1) as Observable<number>;
// 使用pipe,但不加任何管道
const c = b.pipe() as Observable<number>;
c.subscribe(data => console.log(data));
// 接著發(fā)送數(shù)據(jù)源1,通過(guò)map操作符完成number到string的轉(zhuǎn)換
const d = of(1) as Observable<number>;
const e = d.pipe(map(data => {
console.log('map操作符接收到的值的類(lèi)型為:', typeof data);
const result = data.toString();
console.log('map操作符轉(zhuǎn)換后的值的類(lèi)型為:', typeof result);
return result;
})) as Observable<string>;
e.subscribe(data => console.log(data));
// 下面的寫(xiě)法與上面的效果一樣,當(dāng)箭頭函數(shù)中僅有一行代碼時(shí),可以省略該代碼的return關(guān)鍵字
const f = of(1) as Observable<number>;
const g = f.pipe(map(data => data.toString())) as Observable<string>;
g.subscribe(data => console.log(data));
// 除進(jìn)行一般的類(lèi)型轉(zhuǎn)換外,還可以轉(zhuǎn)換為任意類(lèi)型
const h = of(1).pipe(map(data => {
return {value: data};
})) as Observable<{ value: number }>;
h.subscribe(data => console.log(data));
// 當(dāng)然也可以轉(zhuǎn)換為null類(lèi)型
const i = of(1).pipe(map(data => {
if (data !== 1) {
return {test: data};
} else {
return null;
}
})) as Observable<{ value: number } | null>;
i.subscribe(data => console.log(data));
});
```
測(cè)試結(jié)果如下:

## 測(cè)試
接著回到學(xué)號(hào)的異步驗(yàn)證器的測(cè)試上來(lái):當(dāng)輸入032282時(shí)錯(cuò)誤時(shí)顯示錯(cuò)誤提示。

當(dāng)輸入其它學(xué)號(hào)時(shí),錯(cuò)誤提示消失:

上述測(cè)試足以說(shuō)明異步驗(yàn)證是有效的。
## 完善提示信息
輸入032282的學(xué)號(hào)時(shí),異步驗(yàn)證器返回了驗(yàn)證失效的信息,但提示信息卻為:學(xué)號(hào)不能為空。正確的信息應(yīng)該是:該學(xué)號(hào)已存在。
當(dāng)一個(gè)`FormControl`存在多個(gè)驗(yàn)證器時(shí),當(dāng)驗(yàn)證不通過(guò)時(shí)可以通過(guò)`FormControl`的`errors`來(lái)定制驗(yàn)證信息:
```html
+++ b/first-app/src/app/student/add/add.component.html
@@ -11,7 +11,7 @@
<div class="mb-3 row">
<label class="col-sm-2 col-form-label">學(xué)號(hào)</label>
<div class="col-sm-10">
- {{formGroup.get('number').pending}}
+ {{formGroup.get('number').errors | json}}
<input type="text" class="form-control" formControlName="number">
<small class="text-danger" *ngIf="formGroup.get('number').invalid">
學(xué)號(hào)不能為空
```
此時(shí),當(dāng)學(xué)號(hào)為空時(shí),顯示的提示信息如下:

當(dāng)學(xué)號(hào)為032282時(shí),顯示的提示信息為:

如此以來(lái),便可以利用`errors`如下定義提示信息了:
```html
<small class="text-danger" *ngIf="formGroup.get('number').invalid">
- 學(xué)號(hào)不能為空
+ <span *ngIf="formGroup.get('number').errors.required">學(xué)號(hào)不能為空</span>
+ <span *ngIf="formGroup.get('number').errors.numberExist">該學(xué)號(hào)已存在</span>
</small>
```
此時(shí)將輸入032282時(shí),將提示**該學(xué)號(hào)已存在**。

提示信息解決后,還需要解決異步驗(yàn)證器在發(fā)起后臺(tái)請(qǐng)求時(shí)保存按鈕被點(diǎn)亮的BUG。解決該問(wèn)題可以利用`FormControl`的`pending`屬性:
```html
<div class="col-sm-10 offset-2">
- <button class="btn btn-primary" [disabled]="formGroup.invalid">保存
+ <button class="btn btn-primary" [disabled]="formGroup.invalid || formGroup.pending">保存
</button>
</div>
```
如此以來(lái),當(dāng)異步驗(yàn)證器發(fā)起異步驗(yàn)證時(shí)`pending`的值為`true`,保存按鈕不可用;當(dāng)異步驗(yàn)證器完成異步驗(yàn)證時(shí)`pending`的值為`false`,此時(shí)保存按鈕是否可以則取決于`invalid`屬性。
## 自動(dòng)構(gòu)建
完善完異步驗(yàn)證器后,讓我們把思緒拉回來(lái)在組件中構(gòu)造`YzAsyncValidators`實(shí)例上來(lái)。剛剛我們通過(guò)在組件中注入`HttpClient`,然后再構(gòu)建 `YzAsyncValidators`實(shí)例。
但隨著項(xiàng)目的更新,上述方法可能會(huì)引發(fā)比較嚴(yán)重的問(wèn)題。

1. 組件a、b、c、d、e全部依賴(lài)于`YzAsyncValidators`驗(yàn)證器。所以在組件a、b、c、d、e全部注入`HttpClient`實(shí)例,進(jìn)而使用`new `YzAsyncValidators(httpClient)`來(lái)獲取一個(gè)驗(yàn)證器實(shí)例。
2. 有一天`YzAsyncValidators`除依賴(lài)于`HttpClient`外,還依賴(lài)于`ActivedRouter`實(shí)例,構(gòu)造函數(shù)變更為:`constructor(private httpClient: HttpClient, private activedRouter: ActivedRouter) {`。
3. 這時(shí)候?yàn)?zāi)難便發(fā)生了,我們需要依次修改組件a、b、c、d、e,每個(gè)組件中都需要再注入個(gè)`ActivedRouter`實(shí)例。
這明顯是不可接受的,我們的理想目標(biāo)是當(dāng)`YzAsyncValidators`變更時(shí),依賴(lài)于該`YzAsyncValidators`組件可以在不進(jìn)行任何變更的情況下繼續(xù)正常工作。
預(yù)解決這個(gè)問(wèn)題,便需要將手動(dòng)實(shí)例化`YzAsyncValidators`改為自動(dòng)注入了:
```typescript
+++ b/first-app/src/app/student/add/add.component.ts
@@ -12,8 +12,7 @@ import {HttpClient} from '@angular/common/http';
export class AddComponent implements OnInit {
formGroup: FormGroup;
- constructor(private httpClient: HttpClient) {
- const yzAsyncValidators = new YzAsyncValidators(httpClient);
+ constructor(private httpClient: HttpClient, private yzAsyncValidators: YzAsyncValidators) {
this.formGroup = new FormGroup({
name: new FormControl('', Validators.required),
number: new FormControl('', Validators.required, yzAsyncValidators.numberNotExist()),
```
此時(shí)當(dāng)前測(cè)試將發(fā)生一個(gè)錯(cuò)誤:

該錯(cuò)誤提示我們說(shuō):沒(méi)有找到`YzAsyncValidators`的提供者。沒(méi)錯(cuò),由于我們未對(duì)`YzAsyncValidators`類(lèi)進(jìn)行任何的配置,所以當(dāng)前動(dòng)態(tài)測(cè)試模塊中并沒(méi)有提供`YzAsyncValidators`的能力。這時(shí)候就需要復(fù)習(xí)一下6.7.2中的單例服務(wù)了:

上圖的`AuthService`只所以能夠被Angular注入到任意的模塊中,是由于`AuthService`并聲明在`root`模塊中。按上述思想,我們將`YzAsyncValidators`也聲明到`root`模塊中:
```typescript
+++ b/first-app/src/app/yz-async-validators.ts
@@ -2,10 +2,14 @@ import {AbstractControl, ValidationErrors} from '@angular/forms';
import {Observable, of} from 'rxjs';
import {delay, map, tap} from 'rxjs/operators';
import {HttpClient, HttpParams} from '@angular/common/http';
+import {Injectable} from '@angular/core';
/**
* 異步驗(yàn)證器.
*/
+@Injectable({
+ providedIn: 'root'
+})
export class YzAsyncValidators {
constructor(private httpClient: HttpClient) {
```
此時(shí)Anguar便有了提供`YzAsyncValidators`的能力,單元測(cè)試中的錯(cuò)誤隨即消失,異步驗(yàn)證器工作正常。

此時(shí),即使有一天我們變更`YzAsyncValidators`的依賴(lài),依賴(lài)于該`YzAsyncValidators`組件也可以在不進(jìn)行任何變更的情況下繼續(xù)正常工作。
| 名稱(chēng) | 鏈接 |
| --------------- | ------------------------------------------------------------ |
| Angular依賴(lài)注入 | [https://angular.cn/guide/dependency-injection](https://angular.cn/guide/dependency-injection) |
| 本節(jié)源碼 | [https://github.com/mengyunzhi/angular11-guild/archive/step7.2.4.zip](https://github.com/mengyunzhi/angular11-guild/archive/step7.2.4.zip) |
- 序言
- 第一章 Hello World
- 1.1 環(huán)境安裝
- 1.2 Hello Angular
- 1.3 Hello World!
- 第二章 教師管理
- 2.1 教師列表
- 2.1.1 初始化原型
- 2.1.2 組件生命周期之初始化
- 2.1.3 ngFor
- 2.1.4 ngIf、ngTemplate
- 2.1.5 引用 Bootstrap
- 2.2 請(qǐng)求后臺(tái)數(shù)據(jù)
- 2.2.1 HttpClient
- 2.2.2 請(qǐng)求數(shù)據(jù)
- 2.2.3 模塊與依賴(lài)注入
- 2.2.4 異步與回調(diào)函數(shù)
- 2.2.5 集成測(cè)試
- 2.2.6 本章小節(jié)
- 2.3 新增教師
- 2.3.1 組件初始化
- 2.3.2 [(ngModel)]
- 2.3.3 對(duì)接后臺(tái)
- 2.3.4 路由
- 2.4 編輯教師
- 2.4.1 組件初始化
- 2.4.2 獲取路由參數(shù)
- 2.4.3 插值與模板表達(dá)式
- 2.4.4 初識(shí)泛型
- 2.4.5 更新教師
- 2.4.6 測(cè)試中的路由
- 2.5 刪除教師
- 2.6 收尾工作
- 2.6.1 RouterLink
- 2.6.2 fontawesome圖標(biāo)庫(kù)
- 2.6.3 firefox
- 2.7 總結(jié)
- 第三章 用戶(hù)登錄
- 3.1 初識(shí)單元測(cè)試
- 3.2 http概述
- 3.3 Basic access authentication
- 3.4 著陸組件
- 3.5 @Output
- 3.6 TypeScript 類(lèi)
- 3.7 瀏覽器緩存
- 3.8 總結(jié)
- 第四章 個(gè)人中心
- 4.1 原型
- 4.2 管道
- 4.3 對(duì)接后臺(tái)
- 4.4 x-auth-token認(rèn)證
- 4.5 攔截器
- 4.6 小結(jié)
- 第五章 系統(tǒng)菜單
- 5.1 延遲及測(cè)試
- 5.2 手動(dòng)創(chuàng)建組件
- 5.3 隱藏測(cè)試信息
- 5.4 規(guī)劃路由
- 5.5 定義菜單
- 5.6 注銷(xiāo)
- 5.7 小結(jié)
- 第六章 班級(jí)管理
- 6.1 新增班級(jí)
- 6.1.1 組件初始化
- 6.1.2 MockApi 新建班級(jí)
- 6.1.3 ApiInterceptor
- 6.1.4 數(shù)據(jù)驗(yàn)證
- 6.1.5 教師選擇列表
- 6.1.6 MockApi 教師列表
- 6.1.7 代碼重構(gòu)
- 6.1.8 小結(jié)
- 6.2 教師列表組件
- 6.2.1 初始化
- 6.2.2 響應(yīng)式表單
- 6.2.3 getTestScheduler()
- 6.2.4 應(yīng)用組件
- 6.2.5 小結(jié)
- 6.3 班級(jí)列表
- 6.3.1 原型設(shè)計(jì)
- 6.3.2 初始化分頁(yè)
- 6.3.3 MockApi
- 6.3.4 靜態(tài)分頁(yè)
- 6.3.5 動(dòng)態(tài)分頁(yè)
- 6.3.6 @Input()
- 6.4 編輯班級(jí)
- 6.4.1 測(cè)試模塊
- 6.4.2 響應(yīng)式表單驗(yàn)證
- 6.4.3 @Input()
- 6.4.4 FormGroup
- 6.4.5 自定義FormControl
- 6.4.6 代碼重構(gòu)
- 6.4.7 小結(jié)
- 6.5 刪除班級(jí)
- 6.6 集成測(cè)試
- 6.6.1 惰性加載
- 6.6.2 API攔截器
- 6.6.3 路由與跳轉(zhuǎn)
- 6.6.4 ngStyle
- 6.7 初識(shí)Service
- 6.7.1 catchError
- 6.7.2 單例服務(wù)
- 6.7.3 單元測(cè)試
- 6.8 小結(jié)
- 第七章 學(xué)生管理
- 7.1 班級(jí)列表組件
- 7.2 新增學(xué)生
- 7.2.1 exports
- 7.2.2 自定義驗(yàn)證器
- 7.2.3 異步驗(yàn)證器
- 7.2.4 再識(shí)DI
- 7.2.5 屬性型指令
- 7.2.6 完成功能
- 7.2.7 小結(jié)
- 7.3 單元測(cè)試進(jìn)階
- 7.4 學(xué)生列表
- 7.4.1 JSON對(duì)象與對(duì)象
- 7.4.2 單元測(cè)試
- 7.4.3 分頁(yè)模塊
- 7.4.4 子組件測(cè)試
- 7.4.5 重構(gòu)分頁(yè)
- 7.5 刪除學(xué)生
- 7.5.1 第三方dialog
- 7.5.2 批量刪除
- 7.5.3 面向?qū)ο?/a>
- 7.6 集成測(cè)試
- 7.7 編輯學(xué)生
- 7.7.1 初始化
- 7.7.2 自定義provider
- 7.7.3 更新學(xué)生
- 7.7.4 集成測(cè)試
- 7.7.5 可訂閱的路由參數(shù)
- 7.7.6 小結(jié)
- 7.8 總結(jié)
- 第八章 其它
- 8.1 打包構(gòu)建
- 8.2 發(fā)布部署
- 第九章 總結(jié)