保存按钮做完以后,账本通常还差一个让人放心的动作:刚才改错了,能不能退回去?如果撤销记录只是保存费用对象的引用,下一次修改会连“历史”一起改变;如果只保存旧金额,又可能把后来修改过的名称覆盖掉。撤销需要记录一次明确变更的前后值,并说明自己允许恢复到什么范围。

费用变更快照与有限撤销的技术封面

一、把撤销限定为当前会话中的费用变更

这是 PocketLedger 状态设计系列的收尾。费用模型沿用第一篇,预算步进器沿用第二篇,金额解析沿用第四篇,汇总继续采用第五篇的只读计算。第三篇建立的排查方法用于检查更新路径,不把临时额度诊断页面带进最终界面。

最终页面支持调整预算、编辑午餐费用和撤销最近的费用修改。撤销范围明确限定为当前页面会话中最近十次有效费用变更,不包含预算调整,也不提供重做。按钮因此命名为“撤销费用变更”,避免用户把它理解为撤销任意操作。进程或页面重建后的恢复不在这套内存历史的范围内。

一条历史记录包含费用标识、修改前名称与金额、修改后名称与金额。记录的都是基本值,不保存可变费用对象作为历史内容。撤销前核对当前费用是否仍与记录的后值一致,一旦不一致就拒绝恢复,避免把无法解释的状态覆盖掉。这个检查适用于本例单一修改入口,不宣称解决分布式并发。

先定义范围,可以避免界面承诺超过实现。如果用户调整预算后看到一个没有限定对象的“撤销”,自然可能认为它会撤销预算。明确的按钮名称和结果提示能够把产品含义与历史模型对齐。实现不支持的操作无需偷偷塞进同一个栈,应该在需求发生时重新设计记录类型与恢复规则。

工程仍以 Stage 模型和 API 12 的状态管理第二版为基线,没有新增系统权限。按前文的路径保留 common/Expense.ets、common/AmountInput.ets 与 components/BudgetStepper.ets,再增加下面的历史模型并替换首页。依赖位置明确后,收尾实现无需复制整个系列已经给出的基础代码。

二、历史保存值,提交集中写事实

新建 common/ExpenseChange.ets。构造函数在费用被改写之前读取前值,同时接收已经通过校验的新值。历史对象本身不参与编辑,页面只会增加或移除整条历史记录,因此不需要给每个历史字段添加观测装饰器。

// entry/src/main/ets/common/ExpenseChange.ets
import { Expense } from './Expense';

export class ExpenseChange {
  id: string;
  beforeTitle: string;
  beforeCents: number;
  afterTitle: string;
  afterCents: number;

  constructor(item: Expense, title: string, cents: number) {
    this.id = item.id;
    this.beforeTitle = item.title;
    this.beforeCents = item.cents;
    this.afterTitle = title;
    this.afterCents = cents;
  }
}

首页只开放午餐编辑,是为了让代码集中展示完整提交与恢复路径;通勤继续作为另一条记录参与汇总。扩展成任意行编辑时,将选中标识变成明确状态,再沿同一查找和提交过程处理即可,不要为每一行复制一套保存逻辑。

快照类保存的是一次变更所需的最少字段,而不是整份页面。预算、提示文字和编辑框都没有进入费用快照,因为恢复费用不应把这些无关状态带回过去。记录越宽,越容易在撤销时覆盖用户后来完成的其他操作;快照范围应与按钮承诺的业务动作一致。

// entry/src/main/ets/pages/Index.ets
import { Expense, money, validCents } from '../common/Expense';
import { parseAmount } from '../common/AmountInput';
import { ExpenseChange } from '../common/ExpenseChange';
import { BudgetStepper } from '../components/BudgetStepper';

@Entry
@ComponentV2
struct Index {
  @Local expenses: Expense[] = [
    new Expense('meal1', '午餐', 3800),
    new Expense('fare1', '通勤', 2400)
  ];
  @Local budgetCents: number = 20000;
  @Local history: ExpenseChange[] = [];
  @Local editing: boolean = false;
  @Local draftTitle: string = '';
  @Local draftAmount: string = '';
  @Local message: string = '可编辑午餐或调整预算';

  @Computed
  get totalCents(): number {
    let result: number = 0;
    for (let item of this.expenses) {
      result += item.cents;
    }
    return result;
  }

  changeBudget(delta: number): void {
    const next: number = this.budgetCents + delta;
    if ((delta === 1000 || delta === -1000) && validCents(next)) {
      this.budgetCents = next;
      this.message = '预算已更新,不计入费用撤销';
    } else {
      this.message = '预算调整不符合规则';
    }
  }

  beginEdit(): void {
    const item: Expense | undefined = this.expenses.find(
      (row: Expense) => row.id === 'meal1'
    );
    if (item === undefined) {
      this.message = '待编辑费用不存在';
      return;
    }
    this.draftTitle = item.title;
    this.draftAmount = money(item.cents);
    this.editing = true;
    this.message = '保存前不改变费用';
  }

  save(): void {
    if (!this.editing) {
      return;
    }
    const item: Expense | undefined = this.expenses.find(
      (row: Expense) => row.id === 'meal1'
    );
    const title: string = this.draftTitle.trim();
    const cents: number | undefined = parseAmount(this.draftAmount);
    if (item === undefined || title.length === 0 || title.length > 20 || cents === undefined) {
      this.message = '请检查费用名称与金额';
      return;
    }
    if (item.title === title && item.cents === cents) {
      this.editing = false;
      this.message = '内容没有变化';
      return;
    }
    const change: ExpenseChange = new ExpenseChange(item, title, cents);
    this.history = this.history.slice(-9).concat([change]);
    item.title = title;
    item.cents = cents;
    this.editing = false;
    this.message = '费用已保存,可撤销';
  }

  undo(): void {
    if (this.editing || this.history.length === 0) {
      return;
    }
    const last: ExpenseChange = this.history[this.history.length - 1];
    const item: Expense | undefined = this.expenses.find(
      (row: Expense) => row.id === last.id
    );
    if (item === undefined || item.title !== last.afterTitle || item.cents !== last.afterCents) {
      this.message = '当前费用已变化,撤销被拒绝';
      return;
    }
    item.title = last.beforeTitle;
    item.cents = last.beforeCents;
    this.history = this.history.slice(0, -1);
    this.message = '已撤销最近一次费用变更';
  }

  cancel(): void {
    this.editing = false;
    this.message = '已取消编辑';
  }

  build() {
    Scroll() {
      Column({ space: 14 }) {
        Text('口袋账本').fontSize(28).fontWeight(FontWeight.Bold)
        Text('编辑与撤销').fontSize(16).fontColor('#64748B')
        BudgetStepper({
          budgetCents: this.budgetCents,
          onStep: (delta: number) => this.changeBudget(delta)
        })
        Text(`总支出 ¥${money(this.totalCents)}`).fontSize(20)
        Text(`剩余 ¥${money(this.budgetCents - this.totalCents)}`).fontSize(20)
        ForEach(this.expenses, (item: Expense) => {
          Row() {
            Text(item.title).fontSize(18)
            Blank()
            Text(`¥${money(item.cents)}`).fontSize(18)
          }.padding(14).width('100%').backgroundColor('#FFFFFF').borderRadius(14)
        }, (item: Expense) => item.id)
        if (this.editing) {
          TextInput({ text: this.draftTitle, placeholder: '费用名称' })
            .onChange((value: string) => this.draftTitle = value)
          TextInput({ text: this.draftAmount, placeholder: '金额,单位元' })
            .onChange((value: string) => this.draftAmount = value)
          Row({ space: 12 }) {
            Button('保存').onClick(() => this.save())
            Button('取消').onClick(() => this.cancel())
          }
        } else {
          Button('编辑午餐').onClick(() => this.beginEdit())
        }
        Button('撤销费用变更')
          .enabled(!this.editing && this.history.length > 0)
          .onClick(() => this.undo())
        Text(this.message).fontColor('#64748B')
      }.padding(24).width('100%')
    }.width('100%').height('100%').backgroundColor('#F4F7FC')
  }
}

保存前建立值快照的开发示例

无变化提交不进入历史。这能避免用户进入编辑又原样保存,撤销按钮却消耗一条没有任何效果的记录。校验失败也不进入历史,因为事实并未改变。历史记录与真实生效的费用变更对应,按钮点击本身不是产生记录的充分条件。

历史数量在写入时限制为十条,超过后丢弃最旧记录。这个上限只是本地示例的产品约定,不是框架规定。它让内存占用和用户可预期范围保持有限,同时明确说明超过窗口的旧修改不能继续撤销。若需要长期审计,应建立独立存储与事件语义,不能把这个数组直接当审计日志。

提交顺序也值得检查:先确认目标存在,完成全部校验,再判断是否真的有变化,最后创建快照并修改事实。若在校验前推入历史,失败操作就会占用撤销名额;若先修改事实再读取前值,历史又会把新值误认为旧值。顺序本身就是实现的一部分,不能仅检查最终字段名称是否齐全。

三、撤销先验证前提,再恢复旧值

撤销从历史末尾读取最近变更,再按费用标识查找当前对象。它不使用数组位置,因此费用展示顺序改变不会让撤销落到另一条记录上。恢复名称与金额后,移除这条记录,下一次撤销自然面对更早的变更,形成后进先出的顺序。

恢复之前核对后值,是为了防止明显不匹配。例如未来新增了另一个直接修改费用的入口,却没有同时写入历史,那么当前对象与栈顶记录可能不再对应。此时应拒绝覆盖并提示冲突,而不是为了让按钮“总能成功”强行写回旧数据。

不过,值比较无法识别所有并发情况。如果其他入口把数据改走又改回同样的值,仅比较当前字段无法判断期间发生过什么。真正允许多入口或远端并发后,应增加单调版本、事务边界或服务器校验。本例只在统一页面修改入口下提供有限撤销,范围内的确定性比过度承诺更重要。

编辑期间禁用撤销,同时方法内再次检查编辑标记,避免草稿基准在输入过程中被突然改掉。界面禁用提供可见反馈,方法检查保护调用边界。预算调整仍可使用,因为它不改变费用草稿的目标对象;其结果也不会进入费用历史。

撤销成功后不把反向恢复再写入同一个历史栈,否则一次撤销可能立即生成另一条可撤销记录,用户连续点击时反而来回切换。若需要重做,应建立独立的重做集合,并定义新提交后如何清空重做分支。本篇刻意不加入这项功能,保持有限撤销的行为简单可核对。

费用保存后可撤销的竖屏示例界面

四、用完整操作链验证收尾结果

从初始数据开始,把午餐保存为四十八元。总支出应为七十二元,剩余一百二十八元,撤销按钮可用。点击撤销后,午餐恢复为三十八元,总支出恢复六十二元,历史为空,按钮重新禁用。这个链路同时检查快照、事实写入、派生汇总和按钮状态。

再连续保存两次不同金额,然后连续撤销两次。每一次应退回上一条确认状态,而不是直接回到应用最初值。把名称和金额一起修改,也应同时恢复。若只测试金额,容易漏掉快照模型中其他字段没有保存或者恢复的问题。

取消编辑、校验失败和无变化保存都不能产生历史。可以分别完成这三种操作,再检查撤销按钮是否仍与之前状态一致。预算增加之后再撤销费用,预算应保留调整后的值,只有费用及依赖它的汇总变化,符合按钮明确声明的撤销范围。

对于十条上限,可以连续提交十一种不同金额,再依次撤销。最终只能回到保留窗口的最早前值,不能回到已经丢弃记录之前。检查时记录每次确认值,避免把自己记错操作顺序误判为算法问题。这个过程不需要伪造耗时数据,验证的是状态恢复规则。

还可以在调试版本中构造目标费用被删除或者被绕过入口修改,再执行撤销。预期是保留现状并显示拒绝提示,历史也不应在失败时悄悄弹出。这样能够确认防护分支确实有意义。正式代码恢复统一修改入口后,仍然保留检查,便于以后扩展时较早暴露不一致。

界面使用滚动容器容纳编辑区域,因为输入框出现后页面高度会变化。检查小屏和键盘弹出场景时,应确认保存、取消与结果提示可到达。布局问题不会直接改变历史算法,但会影响用户能否完成一次明确提交,因此也属于这个交互闭环需要覆盖的部分。

提交、快照、撤销与汇总更新的检查步骤

五、六篇最后留下的是一组可守住的约定

页面拥有费用与预算,子组件通过输入和事件表达边界,编辑草稿隔离尚未确认的文字,派生汇总保持只读,历史保存已生效变更的基本值。每一项都对应一个具体问题,而不是为了展示装饰器数量。新增功能时,可以沿着这些归属判断数据应该放在哪里。

后续接入持久化,需要决定先写内存还是先写存储,以及保存失败时历史是否回滚;接入网络,需要决定撤销是本地恢复还是提交一个新的反向业务操作。这些都超出了内存数组能够自动解决的范围。保留当前清楚的提交入口,才能在增加能力时把新规则放到明确位置。

回看系列中的临时排查页和排序页,它们用于把特定问题单独讲清,最终收尾页只保留必要的产品操作。工程整理时应保留共用模型与组件,替换入口页面,避免同时留着多个入口注解造成配置混乱。文章给出的文件路径就是组合依据,不需要从零散片段猜测哪个版本才是最终页面。

一个可维护的状态方案,不要求每个地方都使用最复杂的机制。它要求用户看到的变化、工程里的事实和代码里的修改路径能够互相解释。到这里,PocketLedger 的页面会话已经完成从修改、确认到有限恢复的闭环,后续扩展可以继续沿着同一组边界推进。

官方参考

Logo

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

更多推荐