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

一、把撤销限定为当前会话中的费用变更
这是 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 的页面会话已经完成从修改、确认到有限恢复的闭环,后续扩展可以继续沿着同一组边界推进。
官方参考
更多推荐

所有评论(0)