localStorage之后:把待办应用数据层抽象成Repository

举报
yd_212407902 发表于 2026/11/16 02:06:20 2026/11/16
【摘要】 从一个真实的坑说起之前写过一篇 localStorage 可靠保存任务状态的文章,思路是直接在组件里读写 localStorage。用了一段时间后发现两个问题:一是组件里到处都是 localStorage.getItem / setItem 的散落调用,改一个存储 key 要全局搜索;二是想加一个"数据变更后同步到云端"的需求时,发现根本没有统一的切入点。这就是典型的"存储细节渗透进了业务代...

从一个真实的坑说起

之前写过一篇 localStorage 可靠保存任务状态的文章,思路是直接在组件里读写 localStorage。用了一段时间后发现两个问题:一是组件里到处都是 localStorage.getItem / setItem 的散落调用,改一个存储 key 要全局搜索;二是想加一个"数据变更后同步到云端"的需求时,发现根本没有统一的切入点。这就是典型的"存储细节渗透进了业务代码"。

Repository 模式:给数据层立一堵墙

Repository 模式的核心只有一句话:业务代码只依赖接口,不依赖存储实现。对待办应用来说,业务层关心的不是"数据存在 localStorage 还是 IndexedDB",而是:

  • 拿到全部任务:todoRepo.getAll()
  • 保存一个任务:todoRepo.save(todo)
  • 删除一个任务:todoRepo.remove(id)
  • 监听变更:todoRepo.onChange(cb)

存储细节被封装在实现类里。切后端、加缓存、换序列化格式,业务代码一行不动。

一个 60 行的最小实现

下面是这个项目里实际的 localStorage 实现(简化版):

const STORAGE_KEY = 'todos.v1';

const todoRepo = {
  getAll() {
    try {
      return JSON.parse(localStorage.getItem(STORAGE_KEY)) || [];
    } catch {
      return []; // 数据损坏时返回空列表而不是崩溃
    }
  },
  save(todo) {
    const all = this.getAll();
    const idx = all.findIndex(t => t.id === todo.id);
    if (idx >= 0) all[idx] = todo; else all.push(todo);
    this._persist(all);
    return todo;
  },
  remove(id) {
    this._persist(this.getAll().filter(t => t.id !== id));
  },
  onChange(cb) {
    window.addEventListener('storage', e => {
      if (e.key === STORAGE_KEY) cb(this.getAll());
    });
  },
  _persist(all) {
    localStorage.setItem(STORAGE_KEY, JSON.stringify(all));
  }
};

注意三个细节:

  • 版本化的 key(todos.v1):将来数据结构变了,迁移逻辑可以按版本走;
  • getAll 的 try/catch:JSON 解析失败返回空数组,损坏的数据不应该让整个应用白屏;
  • onChange 用 storage 事件:跨标签页同步是免费送的能力。

接入业务层

组件里原来的 localStorage.getItem('todos') 全部换成 todoRepo.getAll()。真正的好处体现在第二个需求上:后来想把存储换到云端的 API,只需要再写一个 cloudTodoRepo,导出时按环境选择实现,组件代码零改动——这就是那堵墙的价值。

什么时候值得抽象

不建议所有项目一上来就分层。判断标准很简单:如果你能预见存储方式会变(本地→云端、单机→多端同步),或者存储逻辑已经写散了,就值得抽;如果就是个一次性的静态页面,直接读写反而最诚实。抽象的收益来自变化,没有变化就没有收益。

小结

Repository 模式不是企业级 Java 的专利,60 行就能在前端项目里落地。它解决的不是"代码好不好看",而是"下一个需求来的时候,你要改多少个文件"。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。