在行囊协同的清单里,一次出行前可能需要勾选四十件装备。逐个点击当然可以,但真正容易出问题的不是操作次数,而是用户点了“当前分类全部装箱”后,忽然发现选错了类别。界面如果只弹出一句“已完成”,没有可靠的撤销入口,就等于把误操作推给用户。更麻烦的是连续按两次批量按钮,或者批量装箱之后立刻撤销:如果两次保存同时落盘,重启后究竟恢复哪一版?

这个场景承接《行囊协同》前三篇的工程骨架:PackFlow、GearItem{id,name,category,packed}、主页面唯一的 gears 数组、selectedCategory 分类过滤,以及 GearStore 对 gear_snapshot_v1 的 Preferences 持久化。我们不引入新的网络同步、更换数据库或额外的业务数组,而是给一组用户动作加上明确的边界:批量操作产生一个新快照;撤销必须验证快照未被后续修改;存盘仍按序完成。

批量操作和撤销语义的技术封面

一、批量不是循环点击:一个动作只生成一次新状态

最直观的写法是遍历页面可见行,对每一行调用之前的 toggleGear(id)。这看起来复用了函数,实际会产生很多次状态赋值和很多次 persist():十件装备就可能排入十个快照,其中任何一步失败都容易让“整批完成”的语义变得含糊。批量功能应当把目标 ID 集合先确定下来,再通过一次 map 形成新的完整数组,最后只发出一次持久化请求。这样即便 UI 需要重新计算已装箱数量、分类组和空态,它们依然只读同一个 gears,不会出现多个业务副本。

还有一个产品定义要明确:“全部装箱”到底作用于所有装备,还是当前筛选结果?这里采用所见即所得:selectedCategory 为“照明装备”时,只操作照明装备;打开“只看未装箱”时,仅对当前符合过滤条件的装备进行批量操作。批量之前就冻结本次目标 ID,避免在 map 中边改变 packed 边重新计算可见列表,让后半段操作意外丢失目标。按钮旁显示“作用于当前视图”,比只写“全选”更容易让用户预料结果。

本篇用以下增量成员添加到 entry/src/main/ets/pages/Index.ets。GearItem 与 GearStore 延续上一篇,不要重复声明同名结构;persist() 继续使用第二篇的串行 saveChain,不会自行改变快照格式。

// common/model/GearItem.ets 沿用:id:number、name:string、category:string、packed:boolean
interface UndoFrame {
  before: GearItem[];
  afterKey: string;
  action: string;
}

// 以下成员放在 @Entry @Component struct Index 内
@State private batchNotice: string = '批量操作作用于当前筛选';
private undoStack: UndoFrame[] = [];

private copyItems(source: GearItem[]): GearItem[] {
  return source.map((g: GearItem): GearItem => ({
    id: g.id, name: g.name, category: g.category, packed: g.packed
  }));
}
private signature(items: GearItem[]): string {
  return JSON.stringify(items.map((g: GearItem) =>
    [g.id, g.name, g.category, g.packed]));
}
private visibleIds(): Set<number> {
  const ids: Set<number> = new Set<number>();
  this.visibleGroups.forEach((group: GearGroup) => {
    group.items.forEach((g: GearItem) => { ids.add(g.id); });
  });
  return ids;
}

visibleGroups 是第三篇定义的派生 getter,已经叠加分类与未装箱条件,因此无需再储存 visibleGears。这里显式复制对象,是为了让撤销快照不再共享当前数组中对象的可变引用。签名仅用于本页面当前进程的撤销一致性检查,不是加密散列,也不能证明跨进程并发修改或磁盘写入完成;它表示“当前内容是否仍是当时批量执行后的状态”。

DevEco Studio 中批量处理函数与装备清单预览

二、给撤销加版本门槛,而不是盲目把旧数组塞回去

设想一次实际操作:帐篷已装箱,头灯未装箱。用户把当前分类全部装箱,立刻进入头灯详情,把名称改成“备用头灯”。如果这时点击撤销,并且我们毫无检查地把批量之前的数组放回去,名称编辑就会被一起抹掉。用户以为自己撤销的是“勾选”,实际撤销的是后续所有修改。正确的本地简化策略是:撤销前比较当前状态与当初批量后的完整快照;只要存在后续独立编辑,就拒绝该撤销并要求用户重新确认。

因此,每个撤销记录存一份 before 和一个 afterKey。只有内容完全匹配时,才允许恢复 before。多次连续批量可以形成有限深度的撤销栈;本篇保留最近五次,避免小工具无限保存历史数组。更严格的产品可采用“变更命令 + 逆操作”模型,只撤销受影响 ID,但那需要额外解决删除、重命名和顺序变化带来的冲突,本次不在未定义规则的情况下贸然宣称通用撤销。

// 放在 Index 中;普通新增、重命名、单行勾选成功后调用 clearUndo()
private clearUndo(): void { this.undoStack = []; }

private batchSetPacked(target: boolean): void {
  const ids: Set<number> = this.visibleIds();
  const before: GearItem[] = this.copyItems(this.gears);
  const next: GearItem[] = this.gears.map((g: GearItem): GearItem => {
    if (!ids.has(g.id) || g.packed === target) { return { ...g }; }
    return { ...g, packed: target };
  });
  const changed: number = next.filter((g: GearItem, i: number) =>
    g.packed !== before[i].packed).length;
  if (changed === 0) {
    this.batchNotice = '没有需要修改的装备';
    return;
  }
  this.undoStack.push({ before: before,
    afterKey: this.signature(next),
    action: target ? '批量装箱' : '批量取出' });
  if (this.undoStack.length > 5) { this.undoStack.shift(); }
  this.gears = next;
  this.batchNotice = `${target ? '已装箱' : '已取出'} ${changed} 件,可撤销`;
  this.persist();
}

private undoBatch(): void {
  const frame: UndoFrame | undefined = this.undoStack.pop();
  if (frame === undefined) { this.batchNotice = '没有可撤销操作'; return; }
  if (this.signature(this.gears) !== frame.afterKey) {
    this.clearUndo();
    this.batchNotice = '清单已变化,请重新确认';
    return;
  }
  this.gears = this.copyItems(frame.before);
  this.batchNotice = `已撤销${frame.action}`;
  this.persist();
}

这个实现把一次批量的统计与持久化都集中起来。next.filter 在这里只比较同一次生成前后的相同数组位置;我们没有排序或删除,所以比较位置安全,和列表渲染必须使用稳定 ID 是两回事。实际接入上一版时,把 toggleGear、addGear、saveRename、setCategory 中成功改变业务数据的分支都加入 clearUndo();不要在 selectedCategory 或 showOpenOnly 切换时清栈,因为那只是视图变化。保存异常属于另一个维度,不通过撤销签名偷偷掩盖。

批量写入与撤销的状态流转图

三、串行持久化要保证最后意图,而不是保证每次都成功

第二篇 GearStore.write(items) 采用 putSync('gear_snapshot_v1', JSON.stringify({version:1,items})) 后再 flush();页面 persist() 把快照放进 Promise 链。第六轮之外的新代码经常在按钮中直接 await store.write(this.gears),如果用户迅速完成“批量装箱 → 撤销”,两份写入就可能缺乏明确的应用层顺序。此处继续保留写入链,但建议把 persist 写成下面这种形式:每次点击先复制当时的快照,不能等到 Promise 执行时才读取不断变化的 this.gears。

// Index 的持久化增量;与第02篇 saveChain 语义保持一致
private persist(): void {
  const snapshot: GearItem[] = this.copyItems(this.gears);
  const store: GearStore | null = this.store;
  if (store === null) { this.saveHint = '存储尚未就绪'; return; }
  this.saveChain = this.saveChain.catch(() => {}).then(async () => {
    await store.write(snapshot);
    this.saveHint = '最近更改已保存';
  }).catch((e: Error) => {
    this.saveHint = `保存失败:${e.message}`;
    throw e;
  });
}

关键界限在于“链的顺序”与“存储成功”不同。连续两个快照进入同一条链,能保证该页面发出的保存操作不会主动并发;但如果磁盘空间不足、应用异常关闭、文件损坏,单靠 Promise 无法承诺所有操作必然完成。示例还存在一个重要的提示语问题:旧快照成功时可能在新的保存请求排队期间把 UI 文案暂时改成“已保存”。正式产品应加一枚写入序号,只在当前最新序号完成后显示成功;或者显式显示“保存中”。本篇示例最核心的顺序控制,并把这种短暂提示不一致列入验收项。

另外,页面退出时不要只靠 aboutToDisappear 临时调用一次 flush() 就宣称持久化无忧。页面销毁不是磁盘完成回调,也不能阻止进程被系统终止。更稳妥的实践是用户操作当下即安排串行保存,向用户反馈最新状态;对关键业务数据则考虑事务存储、更明确的异常恢复策略和持久化校验。Preferences 适合这里的少量装备记录,不适合借这个例子冒充具备多进程强一致性或远端冲突协调的数据库。

四、让操作台清楚告诉用户改了什么

页面仍使用“出行装备清单”作为标题,保留原来的四件装备:帐篷、头灯、保温毯、水袋,初始装箱状态为帐篷和水袋已装箱;左侧分类筛选由第三篇维护。这次在列表上方增加“当前视图批量装箱”“当前视图批量取出”和“撤销上一步”按钮,按钮下方显示操作反馈。页面上出现的“已装箱 4 / 4”是从当前 gears 计算的总体数量,不把它保存成第二份数据。这样用户从“未装箱”切回“全部”时,总计也不会被筛选误导。

// 放入 Index.build() 的 Column 内,紧邻分类标签和列表上方
Text(`已装箱 ${this.gears.filter((g: GearItem) => g.packed).length} / ${this.gears.length}`)
  .fontSize(20).fontWeight(FontWeight.Bold)
Row({ space: 8 }) {
  Button('当前视图全部装箱')
    .onClick(() => { this.batchSetPacked(true); })
  Button('当前视图全部取出')
    .onClick(() => { this.batchSetPacked(false); })
}
Button('撤销上一步')
  .onClick(() => { this.undoBatch(); })
Text(this.batchNotice).fontSize(13).fontColor('#4B6472')
Text(this.saveHint).fontSize(12).fontColor('#718096')

行囊协同的批量装箱与撤销页面示意

这段片段与前文的 ForEach(this.visibleGroups,...) 并存,不能另外构造一个“批量列表”顶替真实清单。特别需要考虑空筛选结果:比如用户打开“只看未装箱”,执行批量装箱后列表变空,这是正确的过滤结果,不是数据丢失。提示文案应同时包含“已修改 2 件”和“当前筛选下没有装备”,并允许用户随时点“全部分类”查看总表。也不要把“撤销”操作绑定到屏幕上还显示着的某个旧行索引,筛选改变后那个索引可能已经属于另一件装备。

五、按可复现动作验收,给下一阶段留好接口

验收时,准备四条样例并记录基准:帐篷和水袋装箱,头灯、保温毯未装箱。切到“全部分类”,点“当前视图全部装箱”,预期四条均装箱,已装箱总数从 2/4 变为 4/4,只产生一个新的完整快照;点撤销后应回到 2/4。再切到“照明装备”,点“全部装箱”,应只影响头灯,不能连带改变保温毯。将未装箱筛选打开后重复操作,预期列表会缩小,而不是出现错乱行。

冲突验证更重要:先批量装箱,再通过非批量编辑修改头灯名称。此时点击撤销应提示“清单已变化,请重新确认”,不能把新名字覆盖回去。接下来连续批量装箱、取出、撤销两次,观察撤销栈是否按相反顺序退回;持久化写入则应按点击顺序排队。最后关闭应用重新打开,检查恢复值是否等于最后一次已确认落盘的快照。故意让存储写入失败时,界面必须报告失败,不要把“已保存”当作无条件的结果。

这套方案适合前台、小规模、本地单页面清单的批量编辑。它不能解决远端协作冲突,也不等同于可逆数据库事务;对于跨设备、跨进程数据同步,应进一步引入版本、事务和错误重试策略。本系列下一篇可以沿着这个基础做“导出与恢复”,让可撤销的操作快照与能够长期恢复的数据文件分开。涉及的基础接口可参阅华为官方 ForEach 渲染规则 与 Preferences API,并核对所选 Stage 工程和 API 12 SDK 的实际类型提示。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐