构建可扩展的状态系统:基于 ArkTS 的模块化状态管理设计与实现

在这里插入图片描述

摘要

在 HarmonyOS 的日常开发中,很多人都会遇到一个问题:多个页面之间的数据状态如何共享?尤其是在组件结构越来越复杂的场景下,如果还用传统方式来传值,不仅代码混乱,维护也很吃力。

为了解决这个问题,本文将介绍一种用 ArkTS 实现的“模块化状态管理”方式。它的思路有点类似于 React 中的 Redux,通过创建一个单独的状态模块,把所有共享状态集中管理,再在各个页面中引用它,从而实现状态同步更新。

引言

随着应用体量越来越大,一个页面一个状态的写法已经越来越难以满足业务需求了。例如:首页有一个计数器,设置页也需要读取和修改这个值;再比如,有些全局配置比如暗黑模式、用户登录信息等,全 app 都要用。

这种时候,模块化状态管理就非常有用了。它的好处是:

  • 状态集中管理
  • 页面之间不需要一层层传参
  • 状态变化可控、可追踪
  • 更易测试与维护

而 ArkTS 原生就支持单例和模块导入的机制,所以在 HarmonyOS 中实现模块化状态管理其实并不复杂。

用 ArkTS 实现模块化状态管理

创建一个状态模块(StateManager)

我们先来看一个最简单的状态管理模块,只包含一个全局的计数器:

// StateManager.ts
export class StateManager {private static instance: StateManager;public count: number = 0;private constructor() {}static getInstance() {if (!StateManager.instance) {StateManager.instance = new StateManager();}return StateManager.instance;}
}

这个模块用了经典的“单例模式”,也就是只创建一个实例,在整个 app 中共享。任何页面只要调用 StateManager.getInstance(),就能拿到这个共享状态。

在页面中引用这个状态模块

下面我们写一个页面,展示这个 count 值,并且点击按钮让它 +1。

// MainPage.ets
import { StateManager } from './StateManager';@Entry
@Component
struct MainPage {private stateManager = StateManager.getInstance();build() {Column() {Text(`Count: ${this.stateManager.count}`).fontSize(20);Button('Increment').onClick(() => {this.stateManager.count++;});}.padding(20);}
}

现在我们打开这个页面,点击按钮,每点一次,count 就加一。

模块化状态在实际场景中的使用案例

案例 1:多页面共享的购物车数量

假设我们在商城 app 里有多个页面(比如首页、购物车页、商品详情页),都需要显示购物车里的商品数量。

状态模块
// CartState.ts
export class CartState {private static instance: CartState;public itemCount: number = 0;private constructor() {}static getInstance() {if (!CartState.instance) {CartState.instance = new CartState();}return CartState.instance;}addItem() {this.itemCount++;}clearCart() {this.itemCount = 0;}
}
首页展示购物车数量
// HomePage.ets
import { CartState } from './CartState';@Component
struct HomePage {private cartState = CartState.getInstance();build() {Row() {Text(`购物车商品数量: ${this.cartState.itemCount}`)Button('添加商品').onClick(() => {this.cartState.addItem();});}.padding(20);}
}
购物车页面清空功能
// CartPage.ets
import { CartState } from './CartState';@Component
struct CartPage {private cartState = CartState.getInstance();build() {Column() {Text(`当前数量: ${this.cartState.itemCount}`)Button('清空购物车').onClick(() => {this.cartState.clearCart();});}}
}

这样,两个页面共享同一个 CartState 实例,更新状态时,页面数据也会同步。

案例 2:全局用户信息管理

比如你有个用户模块,登录成功后需要把用户信息存下来,后续其他页面都能用。

// UserState.ts
export class UserState {private static instance: UserState;public username: string = '';public isLoggedIn: boolean = false;private constructor() {}static getInstance() {if (!UserState.instance) {UserState.instance = new UserState();}return UserState.instance;}login(name: string) {this.username = name;this.isLoggedIn = true;}logout() {this.username = '';this.isLoggedIn = false;}
}

你可以在登录页使用 login(name) 方法,在设置页调用 logout() 来退出登录,并在其他页面通过 isLoggedIn 来判断用户状态。

QA 环节:开发中常遇到的问题

Q1:这个状态会在页面切换后丢失吗?

不会。 因为用了单例模式,所以状态是保存在内存里的,除非应用被杀掉或者你主动清空。

Q2:多个组件同时引用这个状态,会冲突吗?

不会冲突,但不会自动刷新。 如果你在页面 A 修改了状态,页面 B 想实时感知,需要结合 @Observed 或自定义通知机制(比如事件总线)来实现响应式更新。

Q3:这个方式适合大型项目吗?

适合做轻量的状态管理。 如果项目非常复杂、状态特别多、需要响应式更新的场景比较多,建议结合 ArkTS 的 @Observed, @State, @Provide 等装饰器,或者结合事件总线、信号机制使用。

总结

模块化状态管理在 ArkTS 中是非常实用的一种方案,尤其适合开发多人协作或页面组件繁多的中大型项目。通过单例模式封装状态模块,我们可以实现:

  • 页面之间的状态共享
  • 状态统一管理,易于维护
  • 代码结构清晰,易扩展

当然,如果你的应用场景对状态变化的实时性要求更高,推荐结合 ArkTS 的响应式装饰器或事件总线来做更进一步的扩展。

未来你也可以在这个基础上加上本地缓存(比如存入 Preferences),或者结合 @Observed 属性做组件刷新。希望这篇文章能为你在 ArkTS 的开发旅程中提供一些思路和帮助!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如若转载,请注明出处:http://www.pswp.cn/bicheng/90896.shtml
繁体地址,请注明出处:http://hk.pswp.cn/bicheng/90896.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

重生之我在暑假学习微服务第二天《MybatisPlus-下篇》

本系列参考黑马程序员微服务课程,有兴趣的可以去查看相关视频,本系列内容采用渐进式方式讲解微服务核心概念与实践方法,每日更新确保知识点的连贯性。通过系统化学习路径帮助开发者掌握分布式系统构建的关键技术。读者可通过平台订阅功能获取…

系统整理Python的条件语句和常用方法

Python 的条件语句(if 语句)是控制程序流程的基础之一,结构清晰、语法简洁,非常适合初学者掌握。一、基本语法结构if 条件:执行代码块1 elif 条件2:执行代码块2 else:执行代码块3示例:score 85if score > 90:print…

记录个IAR程序下载后硬件复位不运行,必须断电复位才运行的问题

【问题测试】有个F407的跑马灯的例子,是MDK和IAR两个版本,MDK版本的例子下载并复位后可以正常看到LED闪烁,而IAR的例子下进去后,不会闪烁。使用TOOL的上位机内核寄存器监测工具测试发现,硬件复位后竟然还在调试状态&am…

观察者模式(Observer Pattern)和 发布-订阅模式(Publisher-Subscriber Pattern)

你对 观察者模式(Observer Pattern)和 发布-订阅模式(Publisher-Subscriber Pattern)的描述是非常准确的,并且阐明了它们的核心区别。为了帮助你更好地理解这两者的细微差异,下面是一个更详细的对比分析&am…

2025年接口技术的十字路口:当MCP遇见REST、GraphQL与gRPC

在当今这个由数据驱动、万物互联的时代,应用程序接口(API)已成为现代软件架构的基石。它们是不同服务之间沟通的桥梁,支撑着从网页应用到复杂的微服务生态系统的一切。长久以来,开发者们在REST、GraphQL和gRPC这几种主…

【CTF-WEB-反序列化】利用__toString魔术方法读取flag.php

题目 页面提示输入?code,那我们在网址里get一下出现了新页面的提示,进入看看下面有个help.php页面的提示,进入看看有一段php代码,仔细分析,应该是要用反序列法代码如下 class FileClass{ public $filename error.log…

在 github.com 与 sourceforge.net 上创建免费个人静态网站、博客的区别

github.com github 属于 git 版本管理专业网站,有免费和收费两种套餐。git 的数据是存放在数据库中的,要将数据库中的数据显示为网站的网页,这需要服务器端提供专门的中间件支持才能实现。 特点: 官方支持:提供长期…

jenkins 入门指南:从安装到启动的完整教程

jenkins 入门指南:从安装到启动的完整教程 持续集成(CI)是现代开发流程中的核心环节,而 Jenkins 作为一款开源的 CI 工具,凭借简单安装、开箱即用、插件丰富、易于扩展等优势,成为开发者的首选工具。它能自…

机器学习(重学版)基础篇(概念与评估)

本篇参考周志华老师的西瓜书,但是本人学识有限仅能理解皮毛,如有错误诚请读友评论区指正,万分感谢。一、基础概念与评估方法本节目标:建立理论基础框架​1、机器学习定义机器学习是一门通过计算手段利用经验(以数据形式…

spring/springboot SPI(二)配合使用的接口

spring.factories 里,Spring 会根据接口来加载实现类,常见的几个接口包括:一、org.springframework.context.ApplicationListener1、作用监听 Spring 容器事件,如 ApplicationReadyEvent。2、使用方法项目结构Spring Boot 2.xSpri…

基于Zig语言,opencv相关的c++程序静态交叉编译

一、写在前面 1.什么是zig? Zig 是一种通用编程语言; Zig 最初的定位就是代替C语言的系统级语言,它提供了与 C 语言几乎 100% 兼容(可直接调用 C 头文件、链接 C 库),同时不需要任何依赖构建系统。 Zig 同时附带一…

基于 LSTM 与 SVM 融合的时间序列预测模型:理论框架与协同机制—实践算法(1)

目录 1、单一模型的局限性:混合架构的设计动机 2、LSTM 的时序特征提取:从原始序列到高阶表征 2.1、门控机制的时序过滤能力 2.2、隐藏状态的特征压缩作用 2.3、预训练的特征优化逻辑 3、SVM 的非线性映射:从高阶特征到预测输出 3.1、…

如何查看docker实例是否挂载目录,以及挂载了哪些目录

一条命令即可一次性列出当前容器里所有挂载点&#xff1a; docker inspect <容器ID或名称> --format{{range .Mounts}}{{printf "%-8s %-35s -> %s\n" .Type .Source .Destination}}{{end}}示例输出&#xff1a; bind /host/owrt/src …

Opentrons 模块化平台与AI技术助力智能移液创新,赋能AAW™自动化工作站

在生命科学领域加速拥抱自动化的关键节点&#xff0c;全球开源实验室自动化领导者 Opentrons 携手全球领先生命科学公司默克生命科学&#xff0c;重磅推出 AAW™智能自动化液体处理平台。这一战略合作的核心技术引擎 ——Opentrons Flex 第三代全自动移液工作站&#xff0c;正以…

C++学习笔记(八:函数与变量)

往篇内容&#xff1a; C学习笔记&#xff08;一&#xff09; 一、C编译阶段※ 二、入门案例解析 三、命名空间详解 四、C程序结构 C学习笔记&#xff08;二&#xff09; 五、函数基础 六、标识符 七、数据类型 补充&#xff1a;二进制相关的概念 sizeof 运算符简介 补…

智慧施工:施工流程可视化管理系统

图扑智慧施工全流程可视化管理系统&#xff0c;通过可视化界面&#xff0c;可直观掌握各工序衔接进度、资源调配情况&#xff0c;快速识别违规作业、设备故障等风险点 —— 如塔吊运行半径重叠、深基坑支护位移预警等。同时&#xff0c;系统支持施工方案模拟推演&#xff0c;对…

单链表的冒泡排序实现:从原理到代码详解

单链表的冒泡排序实现&#xff1a;从原理到代码详解 引言 单链表作为一种常见的数据结构&#xff0c;其排序操作因节点无法随机访问&#xff08;需通过指针遍历&#xff09;而与数组排序存在差异。冒泡排序因其实现简单、无需额外空间&#xff08;仅需指针操作&#xff09;&…

如何在 Ubuntu 24.04 或 22.04 上安装和使用 GDebi

APT 是 Ubuntu 上安装需要外部依赖项的 Debian 包的一种方式,但还有另一种选择,即 GDebi。本文将介绍如何在 Ubuntu 24.04 上安装 GDebi,以及如何使用它来安装 .deb 包所需的依赖项。 什么是 GDebi? GDebi 是默认的 .deb 包安装器 DPKG 的轻量级替代品。与 DPKG 不同,GD…

俄罗斯方块游戏开发(面向对象编程)

摘要本设计基于MATLAB面向对象编程技术&#xff0c;开发了一款具备完整游戏逻辑的俄罗斯方块游戏。通过类封装实现游戏核心模块&#xff08;方块管理、游戏板状态、碰撞检测等&#xff09;&#xff0c;采用旋转矩阵实现方块变形&#xff0c;结合MATLAB图形用户界面&#xff08;…

背包DP之多重背包

背包DP之多重背包一、多重背包基础认知1.1 问题定义1.2 核心特征二、基础解法&#xff1a;暴力拆分2.1 核心思路2.2 代码实现2.3 局限性分析三、优化解法&#xff1a;二进制拆分3.1 优化原理3.2 拆分步骤3.3 代码实现3.4 复杂度分析四、二进制拆分过程五、多重背包的变种与应用…