总支出同时出现在汇总卡和摘要里,剩余预算又间接依赖总支出。继续使用普通函数可以保持结果正确,但读取位置增加后,同一套遍历逻辑也会被反复调用。另一种做法是手工保存总额,随后在每个修改入口同步更新。两者之间,计算属性提供了一条值得比较的路径:保存依赖关系与计算结果,而不是新增一个可任意改写的总额事实。

派生汇总与排序副本的技术封面

一、先比较正确性负担,再比较计算成本

PocketLedger 的费用模型仍然来自第一篇,预算仍为二百元,初始午餐三十八元、通勤二十四元。这一篇恢复双记录列表,增加按金额排序和方向切换。目标有两个:总支出在多个位置复用时保持一致,展示排序不改变费用原本的录入顺序。

普通函数的优点是直接,调用时根据当前事实计算,不需要管理缓存失效。对于两条记录,遍历成本很小,完全可以继续使用。它的局限主要在于复杂计算被多个位置重复读取时,需要重新评估调用频率与实际开销;不能只看到用了循环,就断言界面会卡顿。

手工缓存将总支出保存为另一项可写状态,读取很方便,但新增、编辑、删除、恢复等入口都要负责维护它。漏掉一个入口,汇总就可能与明细分离。这个成本属于正确性维护,而不仅是运行时间。对于能够完全由费用推导的总额,没有必要让它拥有第二套修改规则。

评审时可以列出所有费用修改入口,再询问每个方案是否需要在这些位置增加额外代码。若新增一个删除操作就必须同时维护多个汇总字段,说明缓存已经成为业务约束的一部分。它并非绝对不可用,但必须有足够理由承担这份复杂度,不能仅因为读取语句更短就引入。

本篇采用 API 12 起支持的 @Computed,让只读访问器表达派生结果。官方说明该装饰器会根据计算使用的状态变化重新求值,也明确不建议为了简单运算无差别使用,因为计算属性自身存在开销。这里将费用汇总和排序作为复用示例,不给出未经目标设备测量的速度提升比例。

方案修改入口的负担适用判断
普通纯函数只修改事实计算简单、复用较少时直接使用
只读计算属性只修改事实,表达依赖派生逻辑复杂或多处复用时评估
可写总额缓存每个入口都要同步需要独立业务语义时再考虑

表格比较的是维护方式,不能被当成性能测量结果。计算属性减少重复求值的机制与具体页面能节省多少耗时是两回事,后者还与数据规模、修改频率、渲染开销和设备有关。

还要区分计算成本与分配成本。排序会创建一个新的数组容器,随后进行比较;缓存排序结果能够减少某些重复工作,却也需要保存结果与依赖。对极小集合,这些管理开销未必值得单独优化。是否使用某种机制,应该针对实际调用模式回答,不能从装饰器名称推导收益。

二、把总额写成只读依赖链

替换 pages/Index.ets,继续导入第一篇的共用模型。本例的总额访问器只遍历费用,剩余访问器只读取预算与总额;二者均不改写任何状态。页面上没有给总额赋值的入口,也不需要在增加通勤费用之后手工刷新汇总。

// entry/src/main/ets/pages/Index.ets
import { Expense, money, validCents } from '../common/Expense';

@Entry
@ComponentV2
struct Index {
  @Local expenses: Expense[] = [
    new Expense('meal1', '午餐', 3800),
    new Expense('fare1', '通勤', 2400)
  ];
  @Local budgetCents: number = 20000;
  @Local descending: boolean = true;
  @Local message: string = '仅改变展示顺序';

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

  @Computed
  get remainingCents(): number {
    return this.budgetCents - this.totalCents;
  }

  @Computed
  get rankedExpenses(): Expense[] {
    const copied: Expense[] = this.expenses.slice();
    return copied.sort((left: Expense, right: Expense) => {
      return this.descending ? right.cents - left.cents : left.cents - right.cents;
    });
  }

  addFare(): void {
    const item: Expense | undefined = this.expenses.find(
      (row: Expense) => row.id === 'fare1'
    );
    if (item === undefined || !validCents(item.cents + 2000)) {
      this.message = '费用不存在或金额超出范围';
      return;
    }
    item.cents += 2000;
    this.message = '费用已更新';
  }

  build() {
    Column({ space: 16 }) {
      Text('口袋账本').fontSize(28).fontWeight(FontWeight.Bold)
      Text('汇总与排序').fontSize(16).fontColor('#64748B')
      Column({ space: 8 }) {
        Text(`总支出 ¥${money(this.totalCents)}`).fontSize(26)
        Text(`剩余 ¥${money(this.remainingCents)}`).fontSize(20)
        Text(`收支摘要:已支出 ¥${money(this.totalCents)}`)
      }.padding(20).width('100%').backgroundColor('#EAF2FF').borderRadius(20)
      Text(this.descending ? '按金额降序' : '按金额升序').fontSize(18)
      ForEach(this.rankedExpenses, (item: Expense) => {
        Row() {
          Text(item.title).fontSize(18)
          Blank()
          Text(`¥${money(item.cents)}`).fontSize(18)
        }.padding(16).width('100%').backgroundColor('#FFFFFF').borderRadius(14)
      }, (item: Expense) => item.id)
      Text(`录入顺序:${this.expenses.map((row: Expense) => row.title).join(' → ')}`)
      Button('通勤增加 ¥20').onClick(() => this.addFare())
      Button('切换排序方向').onClick(() => this.descending = !this.descending)
      Text(this.message).fontColor('#64748B')
    }.padding(24).width('100%').height('100%').backgroundColor('#F4F7FC')
  }
}

计算属性与费用展示的白色开发界面

总额和剩余之间的依赖是单向的:费用进入总额,预算与总额进入剩余。不要在总额访问器内修正费用,也不要在剩余访问器内调整预算。那样会让计算本身再次改变它的输入,形成循环或难以解释的更新链。需要修改事实的操作,应仍然放在明确的事件入口。

也不要为了观察求值次数,直接在计算属性里增加另一个可观测计数器。计数器变化可能引入新的状态传播,改变原本要研究的行为。评估计算过程可以使用调试器或合适的性能工具,并将观察代码与正式实现区分;产品代码中的访问器应保持取值职责。

当前总额读取的是每个费用对象的金额属性,因此字段仍需具备正确的观测能力。如果从接口接收到普通数据后没有恢复模型实例,不能期待计算属性自动补上全部深层观测。派生计算依赖于前面已经建立的事实模型,它不会修复来源对象的结构问题。这也是连载一直保留统一费用类的原因。

剩余预算的计算很简单,保留普通表达式同样合理。本例将它写成访问器,是为了展示只读依赖链,而不是推荐每一次减法都添加缓存。团队可以根据可读性与复用情况决定保留哪一层访问器,但无论采用哪种写法,都不应另设一个需要手工同步的剩余金额字段。

三、排序副本只复制容器,不复制业务身份

排序之前调用 slice,得到一个新的数组容器。sort 修改的是这个容器的顺序,原始费用集合仍保持午餐、通勤的录入顺序。这样,界面可以自由切换金额升序与降序,而其他依赖原始顺序的逻辑不受影响。

副本中的元素仍然引用同一批费用对象。对于展示排序,这正是需要的行为:通勤金额修改后,排序读取同一条费用的最新字段,不必维护另一套费用副本。但这也意味着,若通过排序结果修改某个元素的金额,仍然会修改原业务对象,不能把数组副本误当成数据隔离层。

这与第四篇的编辑草稿形成明确区别。排序副本希望保留身份,只改变排列;编辑草稿希望隔离未提交的字段值。两种场景都出现“复制”,但复制目的完全不同。选择浅复制还是逐字段建立草稿,应先回答哪些内容需要共享、哪些内容必须隔离。

比较器只依据金额与方向决定顺序,不修改被比较对象。对于相同金额,本例没有额外的业务优先级要求;实际产品若需要确定的次序,可以添加创建顺序或标识作为第二排序条件,并把这条规则纳入验证。不要把偶然观察到的排列当成尚未定义的产品承诺。

排序后的列表继续使用费用标识作为键,金额变化只改变位置,不改变记录身份。若用排序后的数组下标作为键,输入焦点、展开状态和其他局部状态就可能跟着位置而不是费用移动。当前页面还没有这些复杂交互,也应提前保持正确身份语义,让后续扩展不必再重建基础约定。

四、用可解释的操作检验派生结果

初始总支出为六十二元,剩余一百三十八元,降序列表先午餐后通勤。点击一次增加通勤费用,通勤变为四十四元,总支出八十二元,剩余一百一十八元,降序列表应把通勤排在前面。摘要中的已支出金额应与汇总卡一致。

接着切换为升序。列表恢复为午餐在前、通勤在后,但总支出和剩余不应变化,录入顺序说明也应始终是午餐到通勤。这个操作把展示顺序与业务事实分离开来,比单纯检查总额数字更能发现原地排序导致的副作用。

普通计算、计算属性与手工缓存的机制比较

还应测试同额和空集合两种边界。将两笔费用临时设为相同金额,确认总额仍按两笔相加;将集合暂时设为空,总额应为零,剩余等于预算,列表不应访问不存在的首项。测试后恢复文章初始数据,保持代码、图像与操作步骤一致。

再单独改变预算而不改变费用,预期只有剩余金额跟随变化,总支出与排序规则保持原意。这一检查用于确认业务依赖没有被混入额外条件。若某个排序访问器意外读取了提示文字或无关开关,功能未必立即出错,却会扩大重新计算的触发范围,后续分析也会更难。

比较性能时,先固定数据规模、操作频率与展示位置,再分别观察普通函数和计算属性版本。应关注具体问题,例如同一次业务更新是否导致重复的昂贵派生计算,而不是只记录整个页面的耗时就把差异归因于某个装饰器。没有这些条件,数字之间没有可比性。

对照版本还要保持相同数据与界面。如果一个版本少显示一张卡,另一个版本增加动画,即使测得差异,也不能用来证明汇总策略优劣。较可靠的做法是只替换派生计算的实现,保留其他条件,再重复相同操作。发现差异后继续检查调用与分配来源,而不是立即把一次结果写成普遍规律。

五、让计算策略服从数据语义

对这个两条费用的示例,正确性与边界清晰比节省一次短循环更重要。计算属性的教学价值,在于让总额保持只读、让依赖链可见,并展示排序容器与费用身份的区别。真正的数据量增长之后,再依据测量决定是否进一步分组、分页或者迁移计算位置。

如果未来总额包含服务端结算结果、汇率快照或已经封账的历史金额,它可能不再是当前明细的简单求和。此时需要重新定义业务模型,不能机械地坚持所有总额都是派生值。是否可独立保存,应由事实含义决定,而不是由界面上它看起来像一个数字决定。

本篇留下的选择标准是:简单逻辑优先直接表达,多处复用的派生计算可以评估计算属性,展示排序复制容器,未确认编辑隔离字段。最后一篇将在这些边界上增加有限撤销,把一次已确认修改的前值与后值收拢成可以检查的历史记录。

官方参考

Logo

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

更多推荐