162 lines
3.8 KiB
TypeScript
162 lines
3.8 KiB
TypeScript
import { LogLabel } from "./LogLabel";
|
||
import { Logger } from "./Logger";
|
||
import { LevelLogLabel, colorRadio } from "./PresetLogLabel";
|
||
|
||
interface IAnyData {
|
||
[x:string]: any
|
||
}
|
||
|
||
type DeepReadonly<T> = {
|
||
readonly [P in keyof T]: DeepReadonly<T[P]>;
|
||
};
|
||
|
||
/**
|
||
* 请求参数设置
|
||
*/
|
||
type IParamSetting<T extends IAnyData> = {
|
||
[P in keyof T]: {
|
||
|
||
/**
|
||
* 默认值
|
||
*/
|
||
defaultValue?: T[P],
|
||
|
||
/**
|
||
* 测试
|
||
*/
|
||
tester?: RegExp | ((data:T[P]) => boolean) | string,
|
||
|
||
/**
|
||
* 预解析函数
|
||
*/
|
||
parse?: ((data:T[P], key:string, all:DeepReadonly<Partial<T>>) => T[P]),
|
||
|
||
/**
|
||
* 是否为请求头数据
|
||
*/
|
||
isHeader?: boolean,
|
||
|
||
/**
|
||
* 是否为模板
|
||
*/
|
||
isTemplate?: boolean
|
||
|
||
/**
|
||
* 是否可选
|
||
*/
|
||
Optional?: boolean
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 接口调用
|
||
*/
|
||
class API<I extends IAnyData, O extends IAnyData> {
|
||
|
||
public static defaultLogLabel:LogLabel = new LogLabel(
|
||
`API:API`, colorRadio(200, 120, 222)
|
||
);
|
||
|
||
/**
|
||
* Logger 使用的标签
|
||
*/
|
||
private LogLabel:LogLabel = API.defaultLogLabel;
|
||
|
||
/**
|
||
* Api 唯一 ID
|
||
*/
|
||
public key:string = "API";
|
||
|
||
/**
|
||
* API 需要的参数列表
|
||
*/
|
||
public params:IParamSetting<I> = {} as any;
|
||
|
||
/**
|
||
* API 需要的数据
|
||
*/
|
||
public data:Partial<I>;
|
||
|
||
/**
|
||
* 请求数据
|
||
*/
|
||
public requestData:IAnyData = {} as any;
|
||
|
||
/**
|
||
* 构造函数
|
||
* 注意：data 是不安全的，请传入数据副本
|
||
* @param data API需要的全部数据
|
||
*/
|
||
public constructor(data? :Partial<I>) {
|
||
this.data = data ?? {};
|
||
}
|
||
|
||
/**
|
||
* 初始化标签
|
||
*/
|
||
public initLabel() {
|
||
this.LogLabel = new LogLabel(
|
||
`API:${ this.key }`, colorRadio(200, 120, 222)
|
||
);
|
||
}
|
||
|
||
/**
|
||
* 初始化数据
|
||
*/
|
||
public initData() {
|
||
for(let key in this.params) {
|
||
|
||
let data = this.data[key];
|
||
let { defaultValue, Optional, tester, parse } = this.params[key];
|
||
|
||
// 默认值赋予
|
||
if(data === void 0 && defaultValue !== void 0) {
|
||
this.data[key] = defaultValue;
|
||
}
|
||
|
||
// 数据存在测试
|
||
if(data === void 0 && !Optional) {
|
||
Logger.log(`数据校验异常: 数据 [${key}] 是必须的，但是并没有接收到!`,
|
||
LevelLogLabel.FatalLabel, this.LogLabel);
|
||
}
|
||
|
||
// 用户自定义测试
|
||
if(data !== void 0 && tester !== void 0) {
|
||
let testRes:boolean = false;
|
||
|
||
if(tester instanceof RegExp) {
|
||
testRes = tester.test(data!);
|
||
} else if(typeof tester === "string") {
|
||
testRes = tester === data;
|
||
} else if(tester instanceof Function) {
|
||
testRes = tester(data!);
|
||
} else {
|
||
Logger.logMultiple(
|
||
[LevelLogLabel.FatalLabel, this.LogLabel],
|
||
`数据校验异常: [${ key }] 参数存在未知类型的 tester:`, tester
|
||
);
|
||
}
|
||
|
||
if(!testRes) {
|
||
Logger.logMultiple(
|
||
[LevelLogLabel.FatalLabel, this.LogLabel],
|
||
`数据校验异常: [${ key }] 参数数据未通过自定义的 tester:`, data
|
||
);
|
||
}
|
||
}
|
||
|
||
// 数据预解析
|
||
if(parse !== void 0 && data !== void 0) {
|
||
this.data[key] = parse(data!, key, this.data as DeepReadonly<Partial<I>>);
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 收集请求数据
|
||
*/
|
||
public collectData() {}
|
||
}
|
||
|
||
export default API;
|
||
export { API, IParamSetting } |