HarmonyOS 应用开发《掌上英语》第26篇:生词本管理——NewWordManager 的增删改查设计

发布时间：2026/7/23 13:06:40

HarmonyOS 应用开发《掌上英语》第26篇:生词本管理——NewWordManager 的增删改查设计
生词本管理——NewWordManager 的增删改查设计引言在英语学习应用中生词本是一个核心功能模块。用户在学习过程中遇到的生词需要能够方便地收藏、归类、复习并追踪掌握程度。如果设计不当生词本很容易变成收藏即遗忘的死角。本文将以NewWordManager的实现为例展示如何构建一个结构清晰、功能完备的生词本管理模块。一、数据模型设计生词本的核心是NewWordItem数据结构它需要记录生词本身的信息、学习状态和元数据exportinterfaceNewWordItem{keyID:string// 唯一标识用于去重和检索title:string// 单词/词组type:string// 题型类型1:单词拼写 2:听力 等phonetic:string// 音标partOfSpeech:string// 词性example:string// 例句exampleTranslation:string// 例句翻译audioUrl:string// 读音 URLaddTime:number// 添加时间戳masteryLevel:number// 掌握程度0-未掌握 1-熟悉 2-掌握wordPackage:string// 所属词汇包}关键设计决策keyID为主键与题目系统中的TopicItemType.keyID对应确保唯一性。masteryLevel三级制简化掌握程度模型避免过于复杂的记忆曲线计算。wordPackage分类维度支持按词汇包筛选方便用户分类管理。二、单例模式 CRUD 架构NewWordManager采用经典的单例模式通过PreferenceUtil进行数据持久化exportclassNewWordManager{privatestaticinstance?:NewWordManager;privateNEW_WORD_KEYNEW_WORDS;privateconstructor(){}publicstaticgetInstance():NewWordManager{if(!NewWordManager.instance){NewWordManager.instancenewNewWordManager();}returnNewWordManager.instance;}privatesaveNewWords(words:NewWordItem[]):void{PreferenceUtil.getInstance().put(this.NEW_WORD_KEY,words);}}所有数据通过NEW_WORD_KEY存储在PreferenceUtil的默认文件中。saveNewWords作为私有方法封装了写入细节对外只暴露语义化的 CRUD 方法。三、增Create去重添加添加生词时最关键的是去重检查——避免同一单词被重复收藏publicaddNewWord(topicItem:TopicItemType,wordPackage:string默认词汇包):boolean{try{letwords:NewWordItem[]this.getAllNewWords();// 去重检查letexistIndexwords.findIndex(itemitem.keyIDtopicItem.keyID);if(existIndex0){// 已存在则更新添加时间words[existIndex].addTimeDate.now();this.saveNewWords(words);Logger.info(NewWordManager,生词已存在更新时间:${topicItem.keyID});returnfalse;// 返回 false 表示已存在非新增}// 构建新词条letnewWord:NewWordItem{keyID:topicItem.keyID,title:topicItem.title,type:topicItem.type,phonetic:topicItem.ques?.[0]?.phonetic||,partOfSpeech:topicItem.ques?.[0]?.partOfSpeech||,example:topicItem.ques?.[0]?.example||,exampleTranslation:topicItem.ques?.[0]?.exampleTranslation||,audioUrl:topicItem.audioUrl||,addTime:Date.now(),masteryLevel:0,// 默认未掌握wordPackage:wordPackage};words.push(newWord);this.saveNewWords(words);Logger.info(NewWordManager,添加生词成功:${topicItem.title});returntrue;}catch(e){Logger.error(NewWordManager,添加生词失败:${JSON.stringify(e)});returnfalse;}}设计亮点幂等性如果生词已存在不会重复添加而是更新addTime以置顶该词条。默认值兜底topicItem.ques?.[0]?.phonetic || 链式可选访问确保数据不缺失。返回值语义true表示新增成功false表示已存在。四、查Retrieve多维查询// 获取所有生词publicgetAllNewWords():NewWordItem[]{try{letwordsPreferenceUtil.getInstance().get(this.NEW_WORD_KEY,[])asNewWordItem[];returnwords||[];}catch(e){Logger.error(NewWordManager,获取生词列表失败:${JSON.stringify(e)});return[];}}// 按词汇包筛选publicgetNewWordsByPackage(wordPackage:string):NewWordItem[]{try{letwordsthis.getAllNewWords();if(!wordPackage||wordPackage全部){returnwords;}returnwords.filter(itemitem.wordPackagewordPackage);}catch(e){Logger.error(NewWordManager,筛选生词失败:${JSON.stringify(e)});return[];}}// 获取生词数量publicgetNewWordCount():number{returnthis.getAllNewWords().length;}// 检查是否为生词publicisNewWord(keyID:string):boolean{letwordsthis.getAllNewWords();returnwords.some(itemitem.keyIDkeyID);}// 获取所有词汇包名称列表publicgetAllWordPackages():string[]{try{letwordsthis.getAllNewWords();letpackagesnewSetstring();packages.add(全部);words.forEach(item{packages.add(item.wordPackage);});returnArray.from(packages);}catch(e){Logger.error(NewWordManager,获取词汇包列表失败:${JSON.stringify(e)});return[全部];}}查询方法丰富多样getAllNewWords全量查询支持 UI 列表展示排序逻辑。getNewWordsByPackage按词汇包筛选使用filter实现支持全部快捷查询。isNewWord快速判断使用some提前终止遍历。getAllWordPackages使用Set自动去重动态生成分类过滤列表。五、改Update掌握度更新publicupdateMasteryLevel(keyID:string,masteryLevel:number):boolean{try{letwords:NewWordItem[]this.getAllNewWords();letindexwords.findIndex(itemitem.keyIDkeyID);if(index0){words[index].masteryLevelmasteryLevel;this.saveNewWords(words);Logger.info(NewWordManager,更新掌握程度:${keyID}-${masteryLevel});returntrue;}returnfalse;// 词不存在}catch(e){Logger.error(NewWordManager,更新掌握程度失败:${JSON.stringify(e)});returnfalse;}}更新操作采用读取 → 修改 → 全量写回的模式。这是因为 Preferences 是键值存储不支持部分字段更新——我们需要将整个数组读出修改目标项再整体写回。六、删Delete单条删除与清空// 单条删除publicremoveNewWord(keyID:string):boolean{try{letwords:NewWordItem[]this.getAllNewWords();letnewWordswords.filter(itemitem.keyID!keyID);this.saveNewWords(newWords);Logger.info(NewWordManager,移除生词成功:${keyID});returntrue;}catch(e){Logger.error(NewWordManager,移除生词失败:${JSON.stringify(e)});returnfalse;}}// 清空所有publicclearAllNewWords():boolean{try{PreferenceUtil.getInstance().put(this.NEW_WORD_KEY,[]);Logger.info(NewWordManager,清空生词本成功);returntrue;}catch(e){Logger.error(NewWordManager,清空生词本失败:${JSON.stringify(e)});returnfalse;}}删除操作的两种粒度removeNewWord使用filter生成新数组不可变操作不修改原数组。clearAllNewWords直接写入空数组效率最高。七、最佳实践7.1 全量读写的权衡在 Preferences 这样的键值存储中生词列表是以数组形式整体存储的。当生词数量增大时如超过 1000 条全量读写的性能会下降。对于大规模数据建议考虑迁移到关系型数据库如kit.ArkData的 relationalStore。7.2 返回值设计原则所有操作方法统一返回boolean调用方可以据此判断操作结果并给出用户反馈letaddedNewWordManager.getInstance().addNewWord(topicItem);if(added){showToast(已添加到生词本);}else{showToast(该词已在生词本中);}7.3 日志埋点每个关键操作都包含Logger.info/error日志方便调试和用户行为分析。生产环境中可以通过日志平台聚合分析用户添加/删除生词的行为模式。八、总结NewWordManager展示了如何在 HarmonyOS 应用中构建一个具备完整 CRUD 能力的业务 Manager。它通过单例模式管理状态通过PreferenceUtil完成持久化通过清晰的接口设计提供生词的增删改查功能。这种Manager Preferences的轻量级存储模式非常适合小规模业务数据的持久化场景是 HarmonyOS 应用开发中的经典实践。

相关新闻

C++推荐算法工程化：9大核心挑战与高性能推理服务架构实战

C++推荐算法工程化：9大核心挑战与高性能推理服务架构实战

1. 项目概述：当推荐算法遇上C工程化做推荐算法的朋友，尤其是从算法研究转向工程落地的同学，大概都有过这样的经历：在Jupyter Notebook里跑出来的模型AUC高得惊人，各种离线指标一片飘红，感觉马上就要改变世界…

2026/7/22 4:51:37 阅读更多 →
C++组合模式：从核心思想到实战应用，构建灵活可维护的代码结构

C++组合模式：从核心思想到实战应用，构建灵活可维护的代码结构

1. 项目概述：从“组合”说起，为什么它如此重要？最近在社区里看到不少朋友在讨论“C 实现 组合”这个话题，也看到很多相关的搜索热词，从“C map”到“组合服务”，再到“小木棒组合图形”。这让我想起自己刚学…

2026/7/23 5:19:14 阅读更多 →
锁的进阶：自旋锁，死锁与条件变量

锁的进阶：自旋锁，死锁与条件变量

实验环境：VMware VM（4核，Ubuntu 24.04），g 13.2，C17，glibc 2.39 本文分三部分：自旋锁原理与手写实现、死锁复现与 gdb 定位、条件变量与生产者消费者模型。每部分都有完整代码和实验数…

2026/7/22 4:51:37 阅读更多 →

最新新闻

Tiva TM4C123休眠模块配置指南：低功耗设计核心与寄存器详解

Tiva TM4C123休眠模块配置指南：低功耗设计核心与寄存器详解

1. 休眠模块的核心价值与设计思路 在嵌入式系统，尤其是那些依赖电池供电的物联网节点、便携式医疗设备或远程传感器中，功耗管理从来都不是一个“锦上添花”的功能，而是决定产品成败的关键。我见过太多项目，硬件设计精良&#xff0…

2026/7/23 14:47:05 阅读更多 →
端侧AI算力瓶颈怎么破？深度解析晶存LPDDR5X高带宽架构与自研主控

端侧AI算力瓶颈怎么破？深度解析晶存LPDDR5X高带宽架构与自研主控

【前言】 做AI PC、边缘计算和智能终端的兄弟肯定深有体会：现在的NPU和GPU算力越来越强，但在跑大模型推理、多任务并发时，系统依然会卡顿。很多时候，瓶颈根本不在算力，而是内存带宽不够，或者存储I/O被写满了…

2026/7/23 14:47:05 阅读更多 →
谷歌自然排名提升秘诀：人工优化决胜外贸市场

谷歌自然排名提升秘诀：人工优化决胜外贸市场

伴随外贸市场竞争加剧，谷歌自然排名成为众多外贸品牌追求的重要目标。能够获得靠前的谷歌自然排名，意味着更多的流量和潜在客户。凰启出海（BoxMedia）作为一家外贸整合营销资深服务商，在这方面有着丰富的经验&#xff0…

2026/7/23 14:47:05 阅读更多 →
监督学习算法 之 决策树

监督学习算法 之 决策树

我们已经介绍过线性回归和逻辑回归。本文介绍机器学习算法里最贴合人类日常决策思维的模型 - 决策树。 1、大白话说 决策树 你去超市 买西瓜 挑一个好西瓜，遵循以下“五步法”： （1）看瓜皮纹路：瓜皮纹路清晰规整、舒展自…

2026/7/23 14:47:05 阅读更多 →
一键下载B站视频！支持8K分辨率，下载速度快到飞起！

一键下载B站视频！支持8K分辨率，下载速度快到飞起！

大家好，这里是科技乐小天，当你在B站刷到一部含金量极高的视频，打算把它下载下来用于日后学习时，你会发现B站并没有提供视频的任何下载方式，如果某天该UP主把视频隐藏或者删除了，想要再次观看更是难以找到&a…

2026/7/23 14:47:05 阅读更多 →
深入解析TI bq24765充电管理芯片：DPM、PCB布局与热设计实战

深入解析TI bq24765充电管理芯片：DPM、PCB布局与热设计实战

1. 项目概述：为什么我们需要关注充电管理芯片的“软实力”？在笔记本电脑、便携式工作站乃至各类高性能移动设备的研发中，电源系统设计往往是决定产品成败的“隐形战场”。一块优秀的电池充电管理芯片，其价值远不止于“把电充进去”…

2026/7/23 14:46:05 阅读更多 →

日新闻

从单点好评到指数级传播：AI副业主理人必须掌握的4层口碑渗透模型（含ROI测算表）

从单点好评到指数级传播：AI副业主理人必须掌握的4层口碑渗透模型（含ROI测算表）

更多请点击： https://intelliparadigm.com 第一章：从单点好评到指数级传播：AI副业主理人必须掌握的4层口碑渗透模型（含ROI测算表） 当AI副业主理人不再仅满足于单次服务交付，而是主动构建可复用、可裂变、可…

2026/7/23 0:00:25 阅读更多 →
AI写作开头钩子设计：为什么你的AI文案完读率不足18%？——基于2,346篇A/B测试报告的归因分析

AI写作开头钩子设计：为什么你的AI文案完读率不足18%？——基于2,346篇A/B测试报告的归因分析

更多请点击： https://codechina.net 第一章：AI写作开头钩子设计：为什么你的AI文案完读率不足18%？——基于2,346篇A/B测试报告的归因分析 在对2,346篇跨行业AI生成文案的A/B测试数据进行聚类分析后，我们发现&#xff1…

2026/7/23 0:01:26 阅读更多 →
Chitchatter完整指南：免费开源的终极点对点安全聊天工具

Chitchatter完整指南：免费开源的终极点对点安全聊天工具

Chitchatter完整指南：免费开源的终极点对点安全聊天工具 【免费下载链接】chitchatter Secure peer-to-peer chat that is serverless, decentralized, and ephemeral 项目地址: https://gitcode.com/gh_mirrors/ch/chitchatter Chitchatter是一款革命性的安…

2026/7/23 0:01:26 阅读更多 →

周新闻

Go语言静态资源打包方案对比与实践指南

Go语言静态资源打包方案对比与实践指南

1. 项目背景与核心需求在Go语言开发中，我们经常需要处理静态资源文件的打包问题。无论是Web应用的模板文件、前端资源，还是配置文件、证书等，都需要随程序一起分发。传统做法是将这些文件与编译后的二进制文件放在同一目录下，但这…

2026/7/22 8:58:19 阅读更多 →
Go语言实现高性能LDAP认证服务的架构与实践

Go语言实现高性能LDAP认证服务的架构与实践

1. 项目背景与核心价值LDAP（轻量级目录访问协议）作为企业级身份认证的黄金标准，已经服务了超过80%的财富500强公司。我在金融科技领域实施统一认证体系时，发现传统Java方案存在启动慢、内存占用高等痛点。而Go语言凭借其协程并发模…

2026/7/22 19:43:43 阅读更多 →
【AI面试官实战指南】：用ChatGPT模拟10类高频技术岗面试，3天提升应答精准度92%

【AI面试官实战指南】：用ChatGPT模拟10类高频技术岗面试，3天提升应答精准度92%

更多请点击： https://intelliparadigm.com 第一章：AI面试官实战指南的核心价值与适用场景 AI面试官并非替代人类HR的“黑箱工具”，而是以可解释、可审计、可迭代的方式，赋能招聘全链路的关键基础设施。其核心价值在于将主观经验沉…

2026/7/22 12:54:44 阅读更多 →

月新闻