找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/core/http/HttpDefine.ts
1/** HTTP 方法(与常见 REST 约定一致) */
2export enum HttpMethod {
3 GET = "GET",
4 POST = "POST",
5 PUT = "PUT",
6 DELETE = "DELETE",
7}
8
9/** 统一返回:业务层可再解析 data */
10export type HttpRawResult = {
11 statusCode: number;
12 data: unknown;
13};
14
15export type HttpRequestOptions = {
16 /** 相对路径(配合 host/serverAddress)或完整 https URL */
17 url: string;
18 data?: unknown;
19 method?: HttpMethod | string;
20 /** 前缀;为空则用 HttpManager.serverAddress */
21 host?: string;
22 headers?: Record<string, string>;
23 /** 为 true 时允许同一 key 并发重复请求 */
24 enableMult?: boolean;
25 /** XHR 超时毫秒,默认 15000;wx.request 使用 timeout 字段(若宿主支持) */
26 timeoutMs?: number;
27 /** callback 风格完成时回调(与 Promise 二选一或并存) */
28 callback?: (res: HttpRawResult) => void;
29};
讲解30 行
HTTP 请求类型与枚举人工通读

HttpDefine.ts

定义四种 HTTP 方法、统一返回结构 HttpRawResult,以及请求参数 HttpRequestOptions 的全部可选字段。HttpManager 的两个入口都以这套类型为参数,业务只需按这里声明传入地址、数据、方法与头部。

先看 HttpMethod 与 HttpRawResult,再逐个读 HttpRequestOptions 的字段注释,最后回 HttpManager 看哪些字段真正被使用。

特殊处理与易错点

2注释HTTP 方法(与常见 REST 约定一致)
10注释统一返回:业务层可再解析 data
11属性统一返回:业务层可再解析 data
12属性请求数据,GET 时序列化为查询串,其它方法作为请求体。
17属性相对路径或完整 http 地址,是拼接最终请求地址的基准。
21注释前缀;为空则用 HttpManager.serverAddress
24注释为 true 时允许同一 key 并发重复请求
26注释XHR 超时毫秒,默认 15000;wx.request 使用 timeout 字段(若宿主支持)
28注释callback 风格完成时回调(与 Promise 二选一或并存)