Class WechatRequestTemplate<CC>

微信小程序请求封装类，继承自RequestTemplate

Type Parameters

CC extends WechatCustomConfig = WechatCustomConfig

Hierarchy

RequestTemplate<CC>
- WechatRequestTemplate

Constructors

constructor

new WechatRequestTemplate<CC>(globalConfigs?: Partial<Configs<CC>>): WechatRequestTemplate<CC>
Type Parameters
- CC extends WechatCustomConfig = WechatCustomConfig
Parameters
- globalConfigs: Partial<Configs<CC>> = {}
Returns WechatRequestTemplate<CC>
Inherited from RequestTemplate.constructor
- Defined in packages/request-template/src/RequestTemplate.ts:71

Properties

`Protected` cache

cache: Cache<Promise<unknown> | AxiosPromise<unknown>>

缓存

`Protected` globalConfigs

globalConfigs: Configs<CC>

全局配置

`Protected` cancelerManager

cancelerManager: Canceler<CustomConfig>

缓存管理器

Accessors

cancelCurrentRequest

get cancelCurrentRequest(): undefined | Canceler
Returns undefined | Canceler
Inherited from RequestTemplate.cancelCurrentRequest
- Defined in packages/request-template/src/RequestTemplate.ts:426

Methods

`Protected` isCancel

isCancel(value: unknown): boolean
使用小程序的取消判断逻辑
Parameters
- value: unknown
Returns boolean
Overrides RequestTemplate.isCancel
- Defined in packages/wechat/src/WechatRequestTemplate.ts:31

`Protected` handleRequestConfig

handleRequestConfig(config: AxiosRequestConfig<any>): AxiosRequestConfig<any>
axios配置对接wx.request配置
Parameters
- config: AxiosRequestConfig<any>
Returns AxiosRequestConfig<any>
Overrides RequestTemplate.handleRequestConfig
- Defined in packages/wechat/src/WechatRequestTemplate.ts:38

`Protected` fetch

fetch(ctx: any): Promise<unknown>
使用小程序内部的请求重写fetch方法
Parameters
- ctx: any
Returns Promise<unknown>
Overrides RequestTemplate.fetch
- Defined in packages/wechat/src/WechatRequestTemplate.ts:58

`Protected` handleCanceler

handleCanceler(_ctx: any): void
设置取消handler
Parameters
- _ctx: any
Returns void
Overrides RequestTemplate.handleCanceler
- Defined in packages/wechat/src/WechatRequestTemplate.ts:76

`Protected` beforeRequest

beforeRequest(ctx: Context<CC>): void
请求前配置loading和配置处理
Parameters
- ctx: Context<CC>
Returns void
Overrides RequestTemplate.beforeRequest
- Defined in packages/wechat/src/WechatRequestTemplate.ts:81

`Protected` afterRequest

afterRequest(ctx: any): void
请求后回调
Parameters
- ctx: any
Returns void
Overrides RequestTemplate.afterRequest
- Defined in packages/wechat/src/WechatRequestTemplate.ts:97

`Protected` init

init(): void
初始化

Returns void
Inherited from RequestTemplate.init
- Defined in packages/request-template/src/RequestTemplate.ts:79

`Protected` generateRequestKey

generateRequestKey(ctx: Omit<Context<CC>, "requestKey">): string
根据配置生成key
Parameters
- ctx: Omit<Context<CC>, "requestKey">
Returns string
Inherited from RequestTemplate.generateRequestKey
- Defined in packages/request-template/src/RequestTemplate.ts:89

`Protected` handleResponse

handleResponse<T>(ctx: Context<CC>, response: AxiosResponse<any, any>): ResType<T>
转换数据结构为ResType
Type Parameters
- T
Parameters
- ctx: Context<CC>
- response: AxiosResponse<any, any>
Returns ResType<T>
Inherited from RequestTemplate.handleResponse
- Defined in packages/request-template/src/RequestTemplate.ts:98

`Protected` registerCanceler

registerCanceler(ctx: Context<CC>, canceler: Canceler): void
注册canceler
Parameters
- ctx: Context<CC>
- canceler: Canceler
Returns void
Inherited from RequestTemplate.registerCanceler
- Defined in packages/request-template/src/RequestTemplate.ts:105

`Protected` mergeCacheConfig

mergeCacheConfig(cacheConfig: undefined | boolean | CustomCacheConfig): CustomCacheConfig
合并缓存配置
Parameters
- cacheConfig: undefined | boolean | CustomCacheConfig
Returns CustomCacheConfig
Inherited from RequestTemplate.mergeCacheConfig
- Defined in packages/request-template/src/RequestTemplate.ts:137

`Protected` mergeRetryConfig

mergeRetryConfig(retryConfig: undefined | number | RetryConfig): RetryConfig
合并retry配置
Parameters
- retryConfig: undefined | number | RetryConfig
Returns RetryConfig
Inherited from RequestTemplate.mergeRetryConfig
- Defined in packages/request-template/src/RequestTemplate.ts:158

`Protected` handleCustomConfig

handleCustomConfig(customConfig: CC): CC
处理CustomConfig
Parameters
- customConfig: CC
Returns CC
Inherited from RequestTemplate.handleCustomConfig
- Defined in packages/request-template/src/RequestTemplate.ts:176

`Protected` handleStatus

handleStatus(ctx: Context<CC>, response: AxiosResponse<ResType<unknown>, any>, data: ResType<unknown>): ResType<unknown> | AxiosResponse<ResType<unknown>, any> | Promise<unknown>
处理响应结果
Parameters
- ctx: Context<CC>
- response: AxiosResponse<ResType<unknown>, any>
- data: ResType<unknown>
Returns ResType<unknown> | AxiosResponse<ResType<unknown>, any> | Promise<unknown>
Inherited from RequestTemplate.handleStatus
- Defined in packages/request-template/src/RequestTemplate.ts:186

`Protected` useCache

useCache(ctx: Context<CC>, request: (() => Promise<unknown>)): Promise<unknown> | AxiosPromise<unknown>
使用缓存
Parameters
- ctx: Context<CC>
- request: (() => Promise<unknown>)
  - - (): Promise<unknown>
    - Returns Promise<unknown>
Returns Promise<unknown> | AxiosPromise<unknown>
Inherited from RequestTemplate.useCache
- Defined in packages/request-template/src/RequestTemplate.ts:212

`Protected` handleRetry

handleRetry(ctx: Context<CC>): void
处理重试
Parameters
- ctx: Context<CC>
Returns void
Inherited from RequestTemplate.handleRetry
- Defined in packages/request-template/src/RequestTemplate.ts:248

`Protected` beforeExecRequest

beforeExecRequest(ctx: Context<CC>): void
执行请求前回调
Parameters
- ctx: Context<CC>
Returns void
Inherited from RequestTemplate.beforeExecRequest
- Defined in packages/request-template/src/RequestTemplate.ts:296

`Protected` generateContext

generateContext(customConfig: CC, requestConfig: AxiosRequestConfig<any>): Context<CC>
生成上下文
Parameters
- customConfig: CC
- requestConfig: AxiosRequestConfig<any>
Returns Context<CC>
Inherited from RequestTemplate.generateContext
- Defined in packages/request-template/src/RequestTemplate.ts:319

`Protected` execRequest

execRequest(ctx: RetryContext<CC>): Promise<unknown>
执行请求，重试会调用该方法
Parameters
- ctx: RetryContext<CC>
Returns Promise<unknown>
Inherited from RequestTemplate.execRequest
- Defined in packages/request-template/src/RequestTemplate.ts:336

request

request<T, RC>(requestConfig: Omit<AxiosRequestConfig<any>, "url" | "cancelToken" | "responseType"> & {
url: string;
responseType?: "json";
}, customConfig?: DynamicCustomConfig<CC, RC>): Promise<RC extends true ? AxiosResponse<ResType<T>, any> : ResType<T>>
json类返回值类型

模板方法，请求入口，重试不会执行该方法
Type Parameters
- T = never
- RC extends boolean = false
Parameters
- requestConfig: Omit<AxiosRequestConfig<any>, "url" | "cancelToken" | "responseType"> & {
  url: string;
  responseType?: "json";
  }
- Optional customConfig: DynamicCustomConfig<CC, RC>
Returns Promise<RC extends true ? AxiosResponse<ResType<T>, any> : ResType<T>>
Inherited from RequestTemplate.request
- Defined in packages/request-template/src/RequestTemplate.ts:359
request<T, RC>(requestConfig: Omit<AxiosRequestConfig<any>, "url" | "cancelToken"> & {
url: string;
}, customConfig?: DynamicCustomConfig<CC, RC>): Promise<RC extends true ? AxiosResponse<T, any> : T>
非json返回值类型

模板方法，请求入口，重试不会执行该方法
Type Parameters
- T = never
- RC extends boolean = false
Parameters
- requestConfig: Omit<AxiosRequestConfig<any>, "url" | "cancelToken"> & {
  url: string;
  }
- Optional customConfig: DynamicCustomConfig<CC, RC>
Returns Promise<RC extends true ? AxiosResponse<T, any> : T>
Inherited from RequestTemplate.request
- Defined in packages/request-template/src/RequestTemplate.ts:373

`Protected` handleError

handleError(ctx: Context<CC>, e: AxiosError<ResType<unknown>, any>): ResType<unknown> | AxiosResponse<ResType<unknown>, any> | Promise<unknown>
请求失败回调
Parameters
- ctx: Context<CC>
- e: AxiosError<ResType<unknown>, any>
Returns ResType<unknown> | AxiosResponse<ResType<unknown>, any> | Promise<unknown>
Inherited from RequestTemplate.handleError
- Defined in packages/request-template/src/RequestTemplate.ts:397

cancelAll

cancelAll(msg?: string): void
取消所有请求
Parameters
- Optional msg: string
Returns void
Inherited from RequestTemplate.cancelAll
- Defined in packages/request-template/src/RequestTemplate.ts:415

cancelWithTag

cancelWithTag(tag: undefined | Tag, msg?: string): void
根据tag标签取消请求
Parameters
- tag: undefined | Tag
- Optional msg: string
Returns void
Inherited from RequestTemplate.cancelWithTag
- Defined in packages/request-template/src/RequestTemplate.ts:422

methodFactory

methodFactory(method: Method, handler?: ((configs: Configs<CustomConfig>) => void)): (<T, RC>(requestConfig: Omit<AxiosRequestConfig<any>, "url" | "method" | "cancelToken"> & {
url: string;
}, customConfig?: DynamicCustomConfig<CC, RC>) => Promise<RC extends true ? AxiosResponse<ResType<T>, any> : ResType<T>>)
简单工厂：生成get post delete等method
Parameters
- method: Method
- Optional handler: ((configs: Configs<CustomConfig>) => void)
  - - (configs: Configs<CustomConfig>): void
    - Parameters
      
      configs: Configs<CustomConfig>
      
      Returns void
Returns (<T, RC>(requestConfig: Omit<AxiosRequestConfig<any>, "url" | "method" | "cancelToken"> & {
url: string;
}, customConfig?: DynamicCustomConfig<CC, RC>) => Promise<RC extends true ? AxiosResponse<ResType<T>, any> : ResType<T>>)
- - <T, RC>(requestConfig: Omit<AxiosRequestConfig<any>, "url" | "method" | "cancelToken"> & {
    url: string;
    }, customConfig?: DynamicCustomConfig<CC, RC>): Promise<RC extends true ? AxiosResponse<ResType<T>, any> : ResType<T>>
  - Type Parameters
    - T = never
    - RC extends boolean = false
    Parameters
    - requestConfig: Omit<AxiosRequestConfig<any>, "url" | "method" | "cancelToken"> & {
      url: string;
      }
    - Optional customConfig: DynamicCustomConfig<CC, RC>
    Returns Promise<RC extends true ? AxiosResponse<ResType<T>, any> : ResType<T>>
Inherited from RequestTemplate.methodFactory
- Defined in packages/request-template/src/RequestTemplate.ts:433

simplifyMethodFactory

simplifyMethodFactory(method: Method, urlPrefix?: string): (<T, RC>(url: string, data?: {}, customConfig?: DynamicCustomConfig<CC, RC>) => Promise<RC extends true ? AxiosResponse<ResType<T>, any> : ResType<T>>)
简化版请求方法工厂忽略data还是params；url前缀；只改axios的url，data/params，method,及自定义配置
Parameters
- method: Method
- urlPrefix: string = ''
Returns (<T, RC>(url: string, data?: {}, customConfig?: DynamicCustomConfig<CC, RC>) => Promise<RC extends true ? AxiosResponse<ResType<T>, any> : ResType<T>>)
- - <T, RC>(url: string, data?: {}, customConfig?: DynamicCustomConfig<CC, RC>): Promise<RC extends true ? AxiosResponse<ResType<T>, any> : ResType<T>>
  - Type Parameters
    - T = never
    - RC extends boolean = false
    Parameters
    - url: string
    - data: {} = {}
    - customConfig: DynamicCustomConfig<CC, RC> = ...
    Returns Promise<RC extends true ? AxiosResponse<ResType<T>, any> : ResType<T>>
Inherited from RequestTemplate.simplifyMethodFactory
- Defined in packages/request-template/src/RequestTemplate.ts:453

use

use(configs: Partial<Configs<CC>>): (<T, RC>(requestConfig: Omit<AxiosRequestConfig<any>, "url" | "cancelToken"> & {
url: string;
}, customConfig?: DynamicCustomConfig<CC, RC>) => Promise<T>)
本质上跟methodFactory是一样的
Parameters
- configs: Partial<Configs<CC>>
Returns (<T, RC>(requestConfig: Omit<AxiosRequestConfig<any>, "url" | "cancelToken"> & {
url: string;
}, customConfig?: DynamicCustomConfig<CC, RC>) => Promise<T>)
- - <T, RC>(requestConfig: Omit<AxiosRequestConfig<any>, "url" | "cancelToken"> & {
    url: string;
    }, customConfig?: DynamicCustomConfig<CC, RC>): Promise<T>
  - Type Parameters
    - T = never
    - RC extends boolean = false
    Parameters
    - requestConfig: Omit<AxiosRequestConfig<any>, "url" | "cancelToken"> & {
      url: string;
      }
    - Optional customConfig: DynamicCustomConfig<CC, RC>
    Returns Promise<T>
Inherited from RequestTemplate.use
- Defined in packages/request-template/src/RequestTemplate.ts:472

deleteCacheByTag

deleteCacheByTag(tag: Tag): void
根据tag移除缓存

为什么要做这个功能：因为在移动端这类无限上拉下一页分页场景，如果下拉刷新了缓存，那么必须清除这一url下所有分页的缓存，然而分页场景下每一页都会生成一个key，不好删除缓存
Parameters
- tag: Tag
Returns void
Inherited from RequestTemplate.deleteCacheByTag
- Defined in packages/request-template/src/RequestTemplate.ts:497

clearCache

clearCache(): void
清理所有缓存

Returns void
Inherited from RequestTemplate.clearCache
- Defined in packages/request-template/src/RequestTemplate.ts:504

Class WechatRequestTemplate<CC>

Type Parameters

CC extends WechatCustomConfig = WechatCustomConfig

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Type Parameters

CC extends WechatCustomConfig = WechatCustomConfig

Parameters

globalConfigs: Partial<Configs<CC>> = {}

Returns WechatRequestTemplate<CC>

Properties

Protected cache

Protected globalConfigs

Protected cancelerManager

Accessors

cancelCurrentRequest

Returns undefined | Canceler

Methods

Protected isCancel

Parameters

value: unknown

Returns boolean

Protected handleRequestConfig

Parameters

config: AxiosRequestConfig<any>

Returns AxiosRequestConfig<any>

Protected fetch

Parameters

ctx: any

Returns Promise<unknown>

Protected handleCanceler

Parameters

_ctx: any

Returns void

Protected beforeRequest

Parameters

ctx: Context<CC>

Returns void

Protected afterRequest

Parameters

ctx: any

Returns void

Protected init

Returns void

Protected generateRequestKey

Parameters

ctx: Omit<Context<CC>, "requestKey">

Returns string

Protected handleResponse

Type Parameters

T

Parameters

ctx: Context<CC>

response: AxiosResponse<any, any>

Returns ResType<T>

Protected registerCanceler

Parameters

ctx: Context<CC>

canceler: Canceler

Returns void

Protected mergeCacheConfig

Parameters

cacheConfig: undefined | boolean | CustomCacheConfig

Returns CustomCacheConfig

Protected mergeRetryConfig

Parameters

retryConfig: undefined | number | RetryConfig

Returns RetryConfig

Protected handleCustomConfig

Parameters

customConfig: CC

Returns CC

Protected handleStatus

Parameters

`Protected` cache

`Protected` globalConfigs

`Protected` cancelerManager

`Protected` isCancel

`Protected` handleRequestConfig

`Protected` fetch

`Protected` handleCanceler

`Protected` beforeRequest

`Protected` afterRequest

`Protected` init

`Protected` generateRequestKey

`Protected` handleResponse

`Protected` registerCanceler

`Protected` mergeCacheConfig

`Protected` mergeRetryConfig

`Protected` handleCustomConfig

`Protected` handleStatus

`Protected` useCache

`Protected` handleRetry

`Protected` beforeExecRequest

`Protected` generateContext

`Protected` execRequest

requestConfig: Omit<AxiosRequestConfig<any>, "url" | "cancelToken" | "responseType"> & {
url: string;
responseType?: "json";
}

`Optional` customConfig: DynamicCustomConfig<CC, RC>

requestConfig: Omit<AxiosRequestConfig<any>, "url" | "cancelToken"> & {
url: string;
}

`Optional` customConfig: DynamicCustomConfig<CC, RC>

`Protected` handleError

`Optional` msg: string

`Optional` msg: string

`Optional` handler: ((configs: Configs<CustomConfig>) => void)

Returns (<T, RC>(requestConfig: Omit<AxiosRequestConfig<any>, "url" | "method" | "cancelToken"> & {
url: string;
}, customConfig?: DynamicCustomConfig<CC, RC>) => Promise<RC extends true ? AxiosResponse<ResType<T>, any> : ResType<T>>)