indexeddb 是浏览器内置的异步持久化数据库,支持事务、索引和大量结构化数据存储,适用于电子书阅读进度与书签管理;需通过 open() 初始化数据库并创建 progress 和 bookmarks 两个对象仓库,为常用字段添加索引,配合事务操作实现增删查及异常降级至 localstorage。

IndexedDB 是浏览器内置的持久化数据库,适合存储结构化数据,比如电子书阅读进度和书签。它比 localStorage 更强大,支持事务、索引、大量数据和二进制内容(如章节 HTML 或图片),且是异步操作,不会阻塞主线程。
创建数据库并定义对象仓库
首次打开电子书时,需要初始化数据库,声明用于存阅读进度和书签的对象仓库(object store):
- 用 indexedDB.open() 打开或新建数据库,版本号递增会触发 upgradeevent
- 在 upgrade 事件中,用 db.createObjectStore() 创建两个仓库:比如
"progress"存阅读位置(按 bookId 主键),"bookmarks"存书签(可设复合主键或用自增 key + index 查询) - 为常用查询字段添加索引,例如在 bookmarks 仓库中对
bookId和chapterId建索引,方便按书快速查所有书签
保存和读取阅读进度
每次翻页或离开页面前,把当前页码、滚动偏移、章节 ID 等写入 progress 仓库:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 用 transaction().objectStore("progress").put() 写入,主键建议设为
bookId(字符串),值包含时间戳、position、lastChapter 等字段 - 读取时用 get(bookId) 直接获取,返回 Promise,解析后还原到阅读器 UI
- 注意处理未初始化的情况——get 返回 undefined 时,按默认位置(如第一章开头)加载
管理书签:增删查与去重
用户点击“添加书签”时,生成唯一标识(如 bookId + chapterId + offset),避免重复记录:
- 插入前先用 index.get() 检查是否已存在相同组合;也可用
add()并捕获重复主键错误 - 删除书签用 delete(key);批量查某本书的所有书签,用 index.openCursor(IDBKeyRange.only(bookId))
- 书签数据建议含:textSnippet(高亮文字前10字)、timestamp、pageYOffset,便于后续定位和展示
异常处理与降级兼容
IndexedDB 不是所有环境都可用(如 Safari 私密模式会拒绝打开),需有 fallback:
- 封装操作时用 try/catch 包裹 open 调用,失败则退回到 localStorage(仅存简单 JSON 字符串)
- 监听 error 和 abort 事件,提示用户“缓存暂不可用,进度将临时保存在内存中”
- 定期清理旧数据——比如只保留最近 100 条书签,用 cursor 遍历 + delete 实现,避免数据库膨胀
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










