恢复快照的按钮点下去,页面栈就被替换了。这个动作越顺畅,越容易让人忽略一个问题:用户是否已经看清将要恢复的内容?第五篇解决了快照里允许存什么,本篇要处理的是恢复发生之前,页面应该怎样确认这次操作仍然有效。

我倾向于把恢复做成一次明确的业务提交。文本合法只是起点,预览对应的输入、当前业务状态和最终确认也应对得上。“阅读工作台”的最后一篇沿用既有导航、异步正文和段落锚点,补上恢复确认,并把六篇形成的模块边界收拢到可以逐项验收的程度。

阅读工作台技术封面

一、预览不能只是一句提示

如果预览之后允许继续修改文本,确认按钮就可能提交另一份内容;如果用户在预览之后打开新资料,确认操作又可能覆盖刚刚形成的阅读路径。单纯增加一个对话框,并没有消除这两种时间差。确认必须绑定具体输入和具体业务状态。

这里保留两个字符串:原始输入文本,以及预览时当前工作台的规范化业务快照。确认时重新读取二者并比较。原始文本发生任何变化,即使只是空格,也要求重新预览;当前快照发生变化,也要求重新预览。规则偏保守,却容易向读者解释:确认的是刚才看到的那一次操作。

当前快照包括有序阅读路径、每份资料的语义段落锚点和最近选择标识。布局宽度、请求序号、组件可见性、Scroller实例都不进入比较。窗口变宽本身不会使预览失效,阅读位置真正改变则会。这仍是第五篇的白名单,没有把组件内部状态混进恢复协议。

恢复操作的所有权与状态边界

这项比较是内容比较,不是全局修订号。如果状态改变之后又恢复到完全相同的规范化内容,确认仍可继续。当前场景接受这种语义;若未来要求“发生过任何操作就必须重新确认”,应增加单调修订号,由所有业务写入口统一递增,不能把字符串比较包装成事件历史证明。

二、一次性消费恢复计划

新增 RestoreDraft,与第五篇的 ReadingSnapshot 和 decodeSnapshot 放在同一文件作用域。准备阶段先取消旧计划,再调用已有白名单解码器。准备失败会使旧预览同时失效,避免用户以为新文本已经生效,实际却确认了上一份计划。

消费阶段先复制内部候选文本,再立即清空计划。随后检查原始输入和基线,最后重新解码候选文本。这样返回的是新的白名单对象,外部修改预览结果不会反向改写内部计划,重复确认也没有可再次消费的内容。

class RestoreDraft {
  private candidate: string = '';
  private source: string = '';
  private baseline: string = '';
  cancel(): void { this.candidate = ''; this.source = ''; this.baseline = ''; }
  prepare(text: string, baseline: string): ReadingSnapshot {
    this.cancel();
    const value: ReadingSnapshot = decodeSnapshot(text);
    this.candidate = JSON.stringify(value);
    this.source = text;
    this.baseline = baseline;
    return decodeSnapshot(this.candidate);
  }
  consume(text: string, baseline: string): ReadingSnapshot {
    const candidate = this.candidate;
    const matches = candidate !== '' && this.source === text && this.baseline === baseline;
    this.cancel();
    if (!matches) throw new Error('恢复预览已过期');
    return decodeSnapshot(candidate);
  }
}

候选快照保存在内存,不写文件。应用退出之后需要重新导入和预览,这与前篇的手动文本恢复流程一致。当前工程采用 Stage 模型、ArkUI V1 状态管理和 API 12 基线,目标为支持相应导航能力的手机、平板;这些本地导航和文本操作无需额外申请网络或存储权限。

三、把检查放在清栈之前

入口组件新增预览状态和计划对象,导出时抽出 captureSnapshot。它继续按索引读取导航栈,保留重复路径和先后顺序,经过解码器重建白名单之后才生成字符串。恢复时先完成消费检查,然后替换锚点、清栈、逐条入栈,最后更新最近选择。

  private captureSnapshot(): string {
    const names = this.paths.getAllPathName();
    const entries: SavedReadingPath[] = [];
    for (let index = 0; index < names.length; index++) {
      const param = this.paths.getParamByIndex(index);
      if (names[index] !== 'reading' || typeof param !== 'string' || !knownItem(param)) {
        throw new Error('当前栈包含不支持的路径');
      }
      entries.push({ name: 'reading', itemId: param });
    }
    const value: ReadingSnapshot = { version: 1, paths: entries,
      anchors: readingAnchors.exportValues(), lastSelectedId: this.lastSelectedId };
    return JSON.stringify(decodeSnapshot(JSON.stringify(value)));
  }
  private exportSnapshot(): void {
    try { this.snapshotText = this.captureSnapshot(); this.restoreMessage = '已导出业务快照'; }
    catch (_) { this.restoreMessage = '导出失败,请检查当前路径'; }
  }
  private previewSnapshot(): void {
    this.previewReady = false;
    try {
      const value = this.restoreDraft.prepare(this.snapshotText, this.captureSnapshot());
      this.previewReady = true;
      this.restoreMessage = '待恢复路径 ' + value.paths.length + ' 条,请确认';
    } catch (_) { this.restoreMessage = '预览失败,当前状态保持原样'; }
  }
  private importSnapshot(): void {
    let value: ReadingSnapshot;
    this.previewReady = false;
    try { value = this.restoreDraft.consume(this.snapshotText, this.captureSnapshot()); }
    catch (_) { this.restoreMessage = '预览已失效,请重新预览'; return; }
    try {
      readingAnchors.replaceValues(value.anchors);
      this.paths.clear();
      for (const entry of value.paths) this.paths.pushPath({ name: 'reading', param: entry.itemId }, false);
      this.lastSelectedId = value.lastSelectedId;
      this.restoreMessage = '业务路径已恢复,正文按当前请求重新读取';
    } catch (_) {
      this.paths.clear();
      readingAnchors.replaceValues([]);
      this.lastSelectedId = '';
      this.restoreMessage = '路径应用失败,已返回资料库';
    }
  }

在第五篇 Index 字段区增加以下成员;保留原有 paths、仓储和其他状态。将原来的导出及导入方法整体替换为上述实现,导航目的页构造、正文请求处理、锚点恢复和解码器继续沿用第五篇完整代码。

  @State private previewReady: boolean = false;
  private restoreDraft: RestoreDraft = new RestoreDraft();

输入区与按钮替换如下,放在既有入口页的 Column 中。文本变化立即取消预览;当前业务变化仍在确认时重新采集判断,不能只依赖按钮是否亮起。

        TextArea({ text: this.snapshotText, placeholder: '粘贴阅读快照JSON' })
          .height(110).onChange((value: string) => {
            this.snapshotText = value;
            this.previewReady = false;
            this.restoreDraft.cancel();
          })
        Button('预览阅读快照').onClick(() => { this.previewSnapshot(); })
        Button('确认恢复').enabled(this.previewReady)
          .onClick(() => { this.importSnapshot(); })

预览、变化与确认的时序

消费检查失败之前没有清栈,也没有替换锚点,因此可以直接保留当前工作台。真正开始应用之后若发生异常,当前实现回到资料库,清空锚点和最近选择,避免残留一半新状态。这是一个明确的失败终点;它没有承诺导航组件内部的数据库式事务,也没有在异常之后继续猜测用户想恢复到哪一层。

四、组合场景比按钮点击更有价值

验收应从读者能够观察的行为出发。依次打开布局资料和状态资料,导出快照,确认路径顺序;返回资料库导入,先预览再确认,检查返回动作是否沿原顺序逐层退出。随后把同一份快照里的资料标识改成未知值,预览应失败,当前路径应保留。

再检查预览与确认之间的变化:修改输入文本后不能直接确认;预览之后打开另一份资料,再回到入口确认,应要求重新预览。恢复确认完成后再次点击,不应重复应用。对于空路径快照,恢复到资料库是合法结果,不能误判成“没有恢复成功”。

窗口宽度、字号、快速切换资料也要放入组合检查。宽度变化继续只影响布局;字号变化仍以语义段落定位;异步正文只能由当前可见、当前请求接收。预览计划管理的是业务恢复资格,不能替代详情组件的请求隔离,也不应尝试保存旧定时器或组件对象。

本地逻辑检查直接提取上述计划类与既有解码器,覆盖合法消费、重复消费、修改文本、改变基线、无效预览取消旧计划五种情况,断言通过。导航动效、折叠态表现和实际段落定位,应在目标设备按前述步骤检查;逻辑用例的结果不扩张为设备运行结论。

恢复确认的组合检查步骤

出现异常时,先区分预览失败、计划过期和应用失败。预览失败回到结构、标识及版本约束;计划过期查看输入或业务快照是否变化;应用失败检查路由名称、参数类型及目的页构造。错误提示保留这些阶段差异,维护者才不必从一个笼统的“恢复失败”重新猜起。

五、工作台真正需要保留下来的东西

六篇下来,入口持有唯一导航栈,资料使用稳定标识,宽度来自容器观察,异步详情隔离过期结果,阅读位置使用语义锚点,跨会话数据通过白名单快照交换,最后由一次性预览约束恢复提交。各部分能够衔接,是因为它们没有争夺同一份状态的所有权。

后续扩展持久化时,可以把规范化快照交给独立存储模块;扩展远程资料时,要重新设计资料标识与内容版本;扩展多窗口时,应明确每个窗口的会话归属。这些工作都不要求把组件对象序列化。当前实现适合小规模固定资料与手动恢复流程,更大的目录和跨版本内容需要新的约束。

我更愿意用“每个状态都有明确寿命”作为这套工程的收尾判断。页面可以重建,布局可以改变,请求可以晚到,但入口、资料标识和用户确认的含义应保持清楚。代码里有了这些边界,之后增加功能才有可以依靠的落点。

参考资料:华为Navigation与NavDestination、华为Navigation路由介绍、华为模块内页面路由。

Logo

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

更多推荐