但是 HttpClient 将错误处理留给调用方,换句话说HTTP错误是通过手动处理的,通过挂接到返回的 Observable 的观察者中来处理.

上面的代码尽管清晰灵活,但即使将错误处理委派给Store或任何其他注入. 以这种方式处理错误也是重复性的工作.

HttpInterceptor 能够捕获 HttpErrorResponse 并可用于集中的错误处理. 然而,在必须放置错误处理程序(也就是拦截器)的情况下,需要额外的工作以及对Angular内部机制的理解. 检查了解详情.

ABP核心模块有用于HTTP请求的实用程序服务: RestService. 除非另有明确配置,否则它将捕获HTTP错误并调度 RestOccurError 操作, 然后由 ThemeSharedModule 引入的 ErrorHandler 捕获此操作. 你应该已经在应用程序中导入了此模块,在使用 RestService 时,默认情况下将自动处理所有HTTP错误.

为了使用 RestService, 你必须将它注入到你的类中.

  1. import { RestService } from '@abp/ng.core';
  3. @Injectable({
  4.   /* class metadata here */
  5. })
  6. class DemoService {
  7.   constructor(private rest: RestService) {}
  8. }

你可以使用 RestService 的 request 方法来处理HTTP请求. 示例:

  1. getFoo(id: number) {
  2.   const request: Rest.Request<null> = {
  3.     method: 'GET',
  4.     url: '/api/some/path/to/foo/' + id,
  5.   };
  6.   return this.rest.request<null, FooResponse>(request);
  7. }

request 方法始终返回 . 无论何时使用 getFoo 方法,都可以执行以下操作:

你不必担心关于取消订阅. RestService 在内部使用 HttpClient,因此它返回的每个可观察对象都是有限的可观察对象,成功或出错后将自动关闭订阅.

如你所见,request 方法获取一个具有 Rest.Reques<T> 类型的请求选项对象. 此泛型类型需要请求主体的接口. 当没有正文时,例如在 GET 或 DELETE 请求中,你可以传递 null. 示例:

  1. postFoo(body: Foo) {
  2.   const request: Rest.Request<Foo> = {
  3.     method: 'POST',
  4.     url: '/api/some/path/to/foo',
  5.       body
  6.   };
  8.   return this.rest.request<Foo, FooResponse>(request);
  9. }

你可以在此处检查完整的 Rest.Request<T> 类型,与Angular中的类相比只有很少的改动.

  1. deleteFoo(id: number) {
  2.   const request: Rest.Request<null> = {
  3.     method: 'DELETE',
  4.     url: '/api/some/path/to/foo/' + id,
  5.   };
  7.   return this.rest.request<null, void>(request, { skipHandleError: true });
  8. }

skipHandleError 配置选项设置为 true 时,禁用错误处理程序,并返回 observable 引发错误,你可以在订阅中捕获该错误.

request 方法接收到的另一个配置选项是 (在v2.4中可用),它用于从应用程序配置获取特定的模块端点.

  1. putFoo(body: Foo, id: string) {
  2.   const request: Rest.Request<Foo> = {
  3.     url: '/' + id,
  4.       body
  5.   };
  7.   return this.rest.request<Foo, void>(request, {apiName: 'foo'});
  8. }

上面的putFoo将请求 https://localhost:44305/api/some/path/to/foo/{id} 当环境变量如下:

  1. // environment.ts
  3. export const environment = {
  4.   apis: {
  5.     default: {
  6.       url: 'https://localhost:44305',
  7.     },
  8.     foo: {
  9.       url: 'https://localhost:44305/api/some/path/to/foo',
  10.     },
  11.   },
  13.   /* rest of the environment variables here */
  14. }

RestService 假定你通常对响应的正文感兴趣,默认情况下将 observe 属性设置为 body. 但是有时你可能对其他内容(例如自定义标头)非常感兴趣. 为此, request 方法在 config 对象中接收 watch 属性.

你可以在此处找到 Rest.Observe 枚举.