localStorage之后:把待办应用数据层抽象成Repository
从一个真实的坑说起
之前写过一篇 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 行就能在前端项目里落地。它解决的不是"代码好不好看",而是"下一个需求来的时候,你要改多少个文件"。
- 点赞
- 收藏
- 关注作者
评论(0)