把鸿蒙 Preferences 当小型数据库用:串行队列防竞态,写失败要回滚缓存
鸿蒙的 preferences 是键值存储,官方定位是「轻量配置」。但需求稍一上头——比如一个可增删改的自定义任务列表——就会有人把整表 JSON 序列化后塞进一个 key。这么做完全可行,AdventureWheel 案例就是这么干的,但它的 LocalTaskStore.ets 值得逐段读:所有读改写都串行排队,写失败还要把内存缓存回滚到写之前。这两段代码是整份案例里含金量最高的部分。
一、为什么读改写会竞态
键值库里存列表,增删改的每一步都是「读全量 → 改 → 写回」。两个操作并发时,后写的一方会把自己读到的旧快照写回去,先写的修改直接蒸发。对配置项(写一次读多次)无所谓,对列表(每次界面操作都写)迟早出事。案例的解法是给整个 store 套一条 Promise 链,任何操作都排队执行:
export class LocalTaskStore {
private static store: preferences.Preferences | null = null;
private static operationQueue: Promise<void> = Promise.resolve();
private static restoreRaw: string | null = null;
private static enqueue<T>(operation: () => Promise<T>): Promise<T> {
const result = LocalTaskStore.operationQueue.then(operation);
// 队尾只负责继续调度;原始 result 的拒绝仍交给调用者处理。
LocalTaskStore.operationQueue = result.then((): void => {}, (): void => {});
return result;
}
}五行代码有两个容易写错的点。第一,operationQueue 接的是 result.then(no-op, no-op),把错误吞掉只续链——如果直接把 result 接上去,任何一个操作的失败会让链永久停在 rejected 状态,之后所有操作都不再执行。第二,返回给调用方的是原始 result,错误照常抛给界面层,排队和报错互不干扰。
二、写失败的回滚:put 成功不等于安全
Preferences 的 put 只改内存缓存,flush 才落盘。如果 flush 抛错(磁盘满、文件被锁),内存缓存里已经是新值了——下一次读改写读到的就是这份「没有真正落盘的脏状态」,在脏状态上继续改,数据就开始飘。案例在每次 save 前先记下旧值,flush 失败就把旧值暂存起来,等下一次读取时恢复:
private static async save(tasks: LocalTaskRecord[]): Promise<void> {
const store = LocalTaskStore.requireStore();
const previousRaw = await store.get(TASKS_KEY, '[]') as string;
try {
await store.put(TASKS_KEY, JSON.stringify(tasks));
await store.flush();
} catch (error) {
// put 可能已更新 Preferences 缓存;恢复原值后才允许下一次读改写。
LocalTaskStore.restoreRaw = previousRaw;
try {
await LocalTaskStore.restoreIfNeeded(store);
} catch (restoreError) {
console.error('LocalTaskStore: 原值待恢复,下次读取时重试');
}
throw new Error('本地任务写入失败,请重试');
}
}
private static async restoreIfNeeded(store: preferences.Preferences): Promise<void> {
const raw = LocalTaskStore.restoreRaw;
if (raw !== null) {
await store.put(TASKS_KEY, raw);
await store.flush();
LocalTaskStore.restoreRaw = null;
}
}恢复这一步也可能失败(磁盘还是满的),所以它不在失败路径里死磕,而是留一个待恢复标记,每次 read() 开头先 restoreIfNeeded——等磁盘恢复可用,第一笔读操作顺手把状态修回来。这个「延迟重试」的结构比在 catch 里递归重试干净得多。
三、查重靠 normalize,别信原文比对
任务列表要挡重复录入,但用户眼里的「一样」和字符串相等不一样:多敲一个空格、大小写不同,语义上还是同一条。案例的做法是把文本归一化后比对:
private static normalize(text: string): string {
return text.trim().toLowerCase().replace(/\s+/g, '');
}
private static ensureUnique(tasks: LocalTaskRecord[], type: TaskType, text: string, excludeId: string = ''): void {
const normalized = LocalTaskStore.normalize(text);
if (tasks.some((item: LocalTaskRecord) => item.id !== excludeId && item.type === type &&
LocalTaskStore.normalize(item.text) === normalized)) {
throw new Error('同类型中已经有相同任务');
}
}编辑场景记得传 excludeId——不改文本只改别的字段时,记录会跟自己「重复」。导入合并(mergeImported)走同一套 normalize,重复的跳过并统计新增条数返回,界面才能提示「导入 12 条,新增 8 条」。
四、配置类存储:每次写完立刻 flush
同一个案例里的 PreferenceStore 管「上局模式、任务数、风险档、音效开关、免责声明」这类配置,走的是另一个极端:每次 put 完立刻 flush,读失败就回默认值:
private static async put(key: string, value: preferences.ValueType): Promise<void> {
try {
await PreferenceStore.store?.put(key, value);
await PreferenceStore.store?.flush();
} catch (error) {
console.error('PreferenceStore: 写入失败');
throw new Error('偏好设置写入失败');
}
}配置的量小、丢一条不心疼,立刻 flush 换的是「下次启动一定读到」;列表的量大、一次全量写回,才值得上队列和回滚。两套并存正好说明:存储方案没有高低,看数据形态选纪律。
五、什么时候该换关系型数据库
Preferences 当列表数据库的上限,大概在几十条、单 key 全量读写、无查询条件的场景。再往上——要按字段查询、要分页、要做数据迁移——就该换关系型数据库(RDB)或者官方的对象关系映射库。判断信号也简单:当你开始在 JSON 字符串里手写版本号(案例里就埋了 custom_tasks_v1)准备将来自己写迁移代码时,说明这份数据已经配得上一个真正的库了。
- 点赞
- 收藏
- 关注作者
评论(0)