FormStateManager 封装表单状态管理与本地缓存,通过 StorageAdapter 抽象存储层,支持防抖自动保存、脏检查、时间戳过期清理及离线恢复,职责清晰可扩展。

用面向对象方式设计一个支持离线暂存的表单数据管理器,核心是把“表单状态”“本地存储逻辑”“同步策略”封装成可复用、可扩展的对象。关键不是堆砌 class,而是明确职责边界:谁负责收集数据、谁负责持久化、谁决定何时写入或读取、谁处理冲突。
定义 FormStateManager 类,封装表单生命周期和本地缓存行为
这个类是主入口,持有表单唯一标识(如 formId)、当前数据快照、以及 localStorage 的键名规则。它不直接操作 DOM,而是通过回调或事件与具体表单解耦:
- 构造时传入 formId 和可选配置(如是否自动保存、防抖延迟、过期时间)
- 提供 setData(key, value) 和 getData(key) 方法,统一管理字段级状态
- 提供 save() 主动落盘,内部调用序列化 + localStorage.setItem;load() 从 localStorage 读取并返回解析后的对象
- 内部维护一个内存缓存(plain object),避免频繁读写 localStorage
用 StorageAdapter 抽象本地存储层,便于替换和测试
不硬编码 localStorage,而是注入一个存储适配器,让未来切换 IndexedDB 或加密存储更简单:
- 定义接口:{ getItem(key), setItem(key, value), removeItem(key), clear() }
- 默认实现 LocalStorageAdapter,对 value 自动 JSON.stringify / JSON.parse,并捕获 QuotaExceededError 等异常
- 测试时可传入 MemoryStorageAdapter,完全内存运行,无副作用
加入自动保存与节流机制,兼顾体验与性能
用户输入频繁时不能每次 onChange 都写 localStorage(影响性能且耗磨损)。应引入防抖或变更检测:
- 监听 input/blur/change 事件,但只在 form 元素上委托,不为每个字段单独绑定
- 使用 setTimeout + clearTimeout 实现防抖(例如 800ms 无新变化再 save)
- 或更轻量:仅在 blur 或 submit 前触发一次 save,配合 dirty 标记判断是否有修改
- save 前比对内存数据与上次已存数据,无差异则跳过写入
处理离线恢复与数据一致性
真正“离线可用”不只是存下来,还要考虑页面刷新后如何安全还原,以及网络恢复后如何避免覆盖服务端最新数据:
- load() 时检查存储项的时间戳(如 _savedAt 字段),若超过 7 天自动丢弃,防陈旧数据干扰
- save() 时同时存入 { data: {...}, savedAt: Date.now(), version: 1 },便于后续做版本比对
- 提供 clearStale() 方法,在表单初始化时清理过期/无效缓存
- 如需和服务端同步,可扩展 syncWithServer(onSuccess, onError),由业务层决定冲突策略(如“本地优先”或“服务端优先”)
不复杂但容易忽略:localStorage 容量有限(通常 5MB)、只能存字符串、跨域隔离、且没有事务。面向对象的意义,正是把这些约束封装进类内部,对外暴露 clean 的接口,让使用者专注业务逻辑而非存储细节。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











