_HttpClient

@delon/theme 包含了一个叫 _HttpClient 类，其本质还是调用 Angular 的 HttpClient。

特性

• 更友好的调用方法
• 维护 loading 属性
• 处理空值
• 统一时间格式为时间戳
• 支持修饰器 @GET、@POST 等

示例

网络请求一般情况下是同 Object 对象做为参数一起使用，例如一个 get 请求，原始写法：

HttpClient.get(url, { params: { pi: 1 } });

而对于 _HttpClient 来讲，将参数进一步优化为：

_HttpClient.get(url, { pi: 1 });

AlainThemeConfig

通用配置项，例如统一对 _HttpClient 设置空值、时间处理方式。

import { AlainThemeConfig } from '@delon/theme';
export function fnAlainThemeConfig(): AlainThemeConfig {
  return Object.assign(new AlainThemeConfig(), <AlainThemeConfig>{
    http: {
      nullValueHandling: 'ignore',
    },
  });
}

@NgModule({})
export class DelonModule {
  static forRoot(): ModuleWithProviders {
    return {
      ngModule: DelonModule,
      providers: [
        { provide: AlainThemeConfig, useFactory: fnAlainThemeConfig },
      ],
    };
  }
}

API

使用修饰器

目标类都必须继承 BaseApi 基类。

示例

@BaseUrl('/user')
@BaseHeaders({ bh: 'a' })
class RestService extends BaseApi {
  @GET()
  query(@Query('pi') pi: number, @Query('ps') ps: number): Observable<any> {
    return;
  }

  @GET(':id')
  get(@Path('id') id: number): Observable<any> {
    return;
  }

  @GET()
  get(@Payload data: {}): Observable<any> {
    return;
  }

  // 使用 `::id` 来表示转义，若 `id` 值为 `undefined` 会忽略转换，例如：
  // 当 `id` 为 `10` 时 => 10:type
  // 当 `id` 为 `undefined` 时 => :id:type
  @GET(':id::type')
  get(@Path('id') id: number): Observable<any> {
    return;
  }

  @POST(':id')
  save(@Path('id') id: number, @Body data: Object): Observable<any> {
    return;
  }

  @POST()
  save(@Payload data: {}): Observable<any> {
    return;
  }

  @FORM()
  save(@Payload data: {}): Observable<any> {
    return;
  }
  
  // 若请求的URL不符合授权要求，会直接抛出 `401` 错误，且不发送请求
  @GET('', { acl: 'admin' })
  ACL(): Observable<any> {
    return;
  }
}

类

• @BaseUrl(url: string)
• @BaseHeaders(headers: HttpHeaders | { [header: string]: string | string[] })

方法

• @GET(url: string = '', options?: HttpOptions)
• @POST(url: string = '', options?: HttpOptions)
• @DELETE(url: string = '', options?: HttpOptions)
• @PUT(url: string = '', options?: HttpOptions)
• @HEAD(url: string = '', options?: HttpOptions)
• @PATCH(url: string = '', options?: HttpOptions)
• @JSONP(url: string = '', options?: HttpOptions)
• @OPTIONS(url: string = '', options?: HttpOptions)

HttpOptions

参数

• @Path(key?: string) URL 路由参数
• @Query(key?: string) URL 参数 QueryString
• @Body 参数 Body
• @Headers(key?: string) 参数 Headers
• @Payload 请求负载
  • 当支持 Body 时（例如：POST、PUT）为内容体等同 @Body
  • 当不支持 Body 时（例如：GET、DELETE 等）为 QueryString

HttpContext

CUSTOM_ERROR

是否自定义处理异常消息。

this.http.post(`login`, {
 name: 'cipchk', pwd: '123456'
}, {
 context: new HttpContext()
             .set(ALLOW_ANONYMOUS, true)
             .set(CUSTOM_ERROR, true)
}).subscribe({
 next: console.log,
 error: console.log
});

IGNORE_BASE_URL

是否忽略API前缀。

// When environment.api.baseUrl set '/api'

this.http.get(`/path`) // Request Url: /api/path
this.http.get(`/path`, { context: new HttpContext().set(IGNORE_BASE_URL, true) }) // Request Url: /path

RAW_BODY

是否原样返回请求Body。