大多数前端应用程序须要通过 HTTP 协定与服务器通信,以下载或上传数据并拜访其余后端服务,SAP 电商云 Spartacus UI 也不例外。 Angular 为 Angular 应用程序提供了一个客户端 HTTP API,即开发包 @angular/common/http 中的 HttpClient 服务类。
HTTP 客户端服务提供以下次要性能。
- 申请类型化响应对象(
typed response objects
)的能力 - 简化的错误处理
- 可测试性特色
- 申请和响应拦挡
下图是 Spartacus OCC Adapter 实现中对 HTTPClient 的导入:
在应用 HttpClient 之前,须要导入 Angular HttpClientModule。 大多数应用程序都在根 AppModule 中执行此操作。
import { NgModule } from '@angular/core';import { BrowserModule } from '@angular/platform-browser';import { HttpClientModule } from '@angular/common/http';@NgModule({ imports: [ BrowserModule, // import HttpClientModule after BrowserModule. HttpClientModule, ], declarations: [ AppComponent, ], bootstrap: [ AppComponent ]})export class AppModule {}
SAP Spartacus 的例子:
Requesting data from a server
应用 HttpClient.get() 办法从服务器获取数据。 异步办法发送一个 HTTP 申请,并在客户端真正收到服务器端返回的响应时,返回一个可能收回(emit)被申请数据(requested data)的 Observable。 返回类型因您传递给调用的察看和响应类型值而异。
get() 办法有两个参数; 要从中获取的端点 URL,以及用于配置申请的选项对象。
options 的参数定义:
options: { headers?: HttpHeaders | {[header: string]: string | string[]}, observe?: 'body' | 'events' | 'response', params?: HttpParams|{[param: string]: string | number | boolean | ReadonlyArray<string | number | boolean>}, reportProgress?: boolean, responseType?: 'arraybuffer'|'blob'|'json'|'text', withCredentials?: boolean,}
下图是 Spartacus 通过 HTTPClient 获取 Language 列表的代码:
因为服务办法返回一个配置数据的 Observable,所以组件订阅了该办法的返回值。 订阅回调执行起码的后处理。 它将数据字段复制到组件的配置对象中,该对象在组件模板中进行数据绑定以进行显示。
代码如下:
showConfig() { this.configService.getConfig() .subscribe((data: Config) => this.config = { heroesUrl: data.heroesUrl, textfile: data.textfile, date: data.date, });}