背景
1、在ArkTS的架构中,没有明确的可管理的加载请求状态的脚手架,在进行网络请求过程中,无法简单的进行交互响应。
2、参考Android中的LoadState写了一个简单的脚手架,以便在日常开发过程中,管理加载请求状态和UI交互。
脚手架说明与源码
1、状态机LoadState
使用一个状态机,分别对应网络请求过程中的Loading(发起请求)、Loaded(请求成功)、LoadError(请求失败)状态,并支持链式调用:
/** | |
* 网络请求MVVM数据模型,由子类实现状态机管理,由方法实现回调监听 | |
*/ | |
export abstract class LoadState { | |
/** | |
* loading函数,如果当前状态是Loading,则调用回调函数 | |
* @param callBack 回调函数 | |
* @returns this | |
*/ | |
loading(callBack?: () => void): this { | |
if (this instanceof Loading) { | |
callBack?.call(null); | |
} | |
return this; | |
} | |
/** | |
* loaded函数,如果当前状态是Loaded,则调用回调函数 | |
* @param callBack 回调函数 | |
* @returns this | |
*/ | |
loaded(callBack?: (result: Loaded<any>) => void): this { | |
if (this instanceof Loaded) { | |
callBack?.call(null, this); | |
} | |
return this; | |
} | |
/** | |
* loadError函数,如果当前状态是LoadError,则调用回调函数 | |
* @param callBack 回调函数 | |
* @returns this | |
*/ | |
loadError(callBack?: (error: LoadError) => void): this { | |
if (this instanceof LoadError) { | |
callBack?.call(null, this); | |
} | |
return this; | |
} | |
} | |
/** | |
* Loading类,继承自LoadState类 | |
*/ | |
export class Loading extends LoadState {} | |
/** | |
* Loaded类,继承自LoadState类,包含一个result属性和一个data方法 | |
*/ | |
export class Loaded<T> extends LoadState { | |
result?: T; | |
constructor(data: T) { | |
super(); | |
this.result = data; | |
} | |
data(): T | undefined { | |
return this.result; | |
} | |
} | |
/** | |
* LoadError类,继承自LoadState类,包含code和message属性 | |
*/ | |
export class LoadError extends LoadState { | |
code?: number; | |
message?: string; | |
constructor(code: number, message: string) { | |
super(); | |
this.code = code; | |
this.message = message; | |
} | |
} | |
2、观察者模式
ArtTS没有提供开箱即用的观察者模式框架,也无法直接使用RxJS框架,所以自己手写一个简单的ValueNotifier作为观察者实现类:
/** | |
* ValueNotifier类,包含_value、listeners属性和addListener、notifyListeners、value方法 | |
*/ | |
export class ValueNotifier<T> { | |
private _value: T; | |
listeners: Array<() => void> = []; | |
constructor(value: T) { | |
this._value = value; | |
} | |
get value(): T { | |
return this._value; | |
} | |
set value(value: T) { | |
this._value = value; | |
this.notifyListeners(); | |
} | |
addListener(listener: () => void) { | |
this.listeners.push(listener); | |
} | |
notifyListeners() { | |
for (let listener of this.listeners) { | |
listener(); | |
} | |
} | |
} |
使用示例
以获取一个车辆详情的场景来模拟网络请求和数据处理
1、ViewModel
import { Loaded, LoadError, Loading, LoadState, ValueNotifier } from './LoadState'; | |
export class VehicleViewModel { | |
lsVehicleDetail: ValueNotifier<LoadState | null>; | |
constructor() { | |
this.lsVehicleDetail = new ValueNotifier<LoadState | null>(null); | |
} | |
// 获取车辆详情 | |
async getVehicleDetail() { | |
// 发起请求 | |
this.lsVehicleDetail.value = new Loading(); | |
await new Promise(resolve => setTimeout(resolve, 3000)); | |
// 获得数据 | |
this.lsVehicleDetail.value = new Loaded("aa"); | |
await new Promise(resolve => setTimeout(resolve, 3000)); | |
// 模拟网络报错 | |
this.lsVehicleDetail.value = new LoadError(123, "error"); | |
} | |
} |
2、页面处理
@Component | |
export struct VehicleComponent { | |
private vm: VehicleViewModel = new VehicleViewModel(); | |
aboutToAppear() { | |
this.vm.lsVehicleDetail.addListener(() => { | |
this.vm.lsVehicleDetail.value?.loading(() => { | |
// 开始网络请求 | |
console.log(`hello1:start Loading`); | |
}).loaded((result) => { | |
let data = result?.data() as String | |
console.log(`hello2:${result} - ${data}`); | |
}).loadError((error) => { | |
console.log(`hello3:${error?.code} - ${error?.message}`); | |
}); | |
}); | |
} | |
} |
3、日志打印结果
hello1:start Loading | |
hello2:[object Object] - aa | |
hello3:123 - error |
最后,为了能让大家更好的去学习提升鸿蒙 (Harmony OS) 开发技术,小编连夜整理了一份30个G纯血版学习资料(含视频、电子书、学习文档等)以及一份在Github上持续爆火霸榜的《纯血版华为鸿蒙 (Harmony OS)开发手册》(共计890页),希望对大家有所帮助。
纯血版鸿蒙 HarmonyOS 4.0 视频学习资料
需要以上视频学习资料小伙伴
《纯血版华为鸿蒙 (Harmony OS)开发手册》
这份手册涵盖了当前鸿蒙 (Harmony OS) 开发技术必掌握的核心知识点
纯血版鸿蒙 (Harmony OS)开发手册部分精彩内容
HarmonyOS 概念:
- 系统定义
- 技术架构
- 技术特性
- 系统安全
如何快速入门?
- 基本概念
- 构建第一个ArkTS应用
- 构建第一个JS应用
- ……
开发基础知识:
- 应用基础知识
- 配置文件
- 应用数据管理
- 应用安全管理
- 应用隐私保护
- 三方应用调用管控机制
- 资源分类与访问
- 学习ArkTS语言
- ……
基于ArkTS 开发:
- Ability开发
- UI开发
- 公共事件与通知
- 窗口管理
- 媒体
- 安全
- 网络与链接
- 电话服务
- 数据管理
- 后台任务(Background Task)管理
- 设备管理
- 设备使用信息统计
- DFX
- 国际化开发
- 折叠屏系列
- .……
获取以上文中提到的这份纯血版鸿蒙 (Harmony OS) 开发资料的小伙伴
🚀写在最后
- 如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:
- 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。
- 关注小编,同时可以期待后续文章ing🚀,不定期分享原创知识。
- 想要获取更多完整鸿蒙最新VIP学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料