Lawnchair适配器全攻略：从DOM Storage到IndexedDB的无缝切换方案

Lawnchair适配器全攻略：从DOM Storage到IndexedDB的无缝切换方案

【免费下载链接】lawnchairA lightweight clientside JSON document store,项目地址: https://gitcode.com/gh_mirrors/law/lawnchair

Lawnchair作为一款轻量级客户端JSON文档存储库，通过适配器机制提供了跨环境的持久化解决方案。本文将详细介绍Lawnchair的各类存储适配器，帮助开发者根据项目需求选择合适的存储方案，并实现不同存储方式之间的无缝切换。

什么是Lawnchair适配器？

适配器是Lawnchair的核心组件，它为不同的持久化存储实现提供了统一接口。一个Lawnchair构建会按顺序尝试加载适配器，并选择第一个适应当前环境的实现。这种模式在移动场景中尤为常见，例如，同时包含DOM和Gears适配器的Lawnchair可以在Android系统中优雅地降级使用所有可用的持久化方案。

所有适配器都遵循以下基本接口规范：

• adapter：适配器名称字符串
• 验证方法：返回布尔值，表示当前环境是否支持该适配器
• 核心方法：包括保存、获取、删除等数据操作方法

常用适配器类型及特性对比

DOM Storage适配器（默认适配器）

DOM Storage适配器是Lawnchair的默认选择，基于浏览器的localStorage实现。它具有以下特点：

• 使用简单，无需额外配置
• 存储容量通常为5MB
• 同步操作，可能阻塞主线程
• 适用于大多数现代浏览器

源代码位置：src/adapters/dom.js

IndexedDB适配器（高性能选择）

IndexedDB适配器提供了更强大的客户端存储能力：

• 支持大量数据存储（通常无硬性限制）
• 异步操作，不会阻塞UI线程
• 支持事务和复杂查询
• 适用于需要存储大量数据的Web应用

检测环境支持的代码片段：

return window.indexedDB || window.webkitIndexedDB || window.mozIndexedDB || window.oIndexedDB || window.msIndexedDB;

源代码位置：src/adapters/indexed-db.js

WebKit SQLite适配器（WebKit浏览器专用）

WebKit SQLite适配器利用WebKit内核浏览器的SQLite数据库：

• 关系型数据库结构
• 支持SQL查询
• 适用于iOS和旧版Android浏览器

源代码位置：src/adapters/webkit-sqlite.js

内存适配器（临时存储）

内存适配器将数据存储在内存中：

• 数据仅在页面会话期间保留
• 读写速度极快
• 适用于临时数据或测试环境

有趣的是，window-name适配器与内存适配器非常相似，唯一区别是它使用window.top.name来存储数据：

window.top.name = JSON.stringify(data) // TODO wow, this is the only diff from the memory adapter

源代码位置：src/adapters/memory.js、src/adapters/window-name.js

特定平台适配器

Lawnchair还提供了多个平台专用适配器：

1. BlackBerry持久化存储适配器

   • 专为BlackBerry设备设计
   • 依赖PhoneGap BlackBerry API
   • 源代码：src/adapters/blackberry-persistent-storage.js

2. IE UserData适配器

   • 支持Internet Explorer的UserData存储
   • 源代码：src/adapters/ie-userdata.js

3. Chrome存储适配器

   • 适用于Chrome扩展程序
   • 源代码：src/adapters/chrome-storage.js

4. TouchDB/CouchDB适配器

   • 支持与CouchDB同步
   • 需要Zepto或jQuery的$.ajax()支持
   • 源代码：src/adapters/touchdb-couchdb.js

适配器选择与优先级机制

Lawnchair采用优雅降级策略选择适配器：

• 默认使用DOM Storage（localStorage）
• 当DOM Storage不可用时，自动回退到window-name适配器
• 可以通过构建自定义版本添加更多适配器

如果你需要特定环境支持，可以下载单独的适配器文件：

• TouchDB / CouchDB同步存储
• BlackBerry持久化存储
• Google Gears SQLite
• IE UserData
• IndexedDB
• WebKit SQLite

如何实现适配器的无缝切换

1. 构建自定义适配器组合

根据目标环境，你可以选择包含多个适配器。Lawnchair会自动检测并使用第一个可用的适配器。

2. 显式指定适配器

在初始化Lawnchair时，可以通过配置参数显式指定要使用的适配器：

var lawnchair = new Lawnchair({adapter: 'indexed-db'}, function() { // 初始化完成后的回调 });

3. 测试不同适配器

Lawnchair提供了完善的测试工具，你可以通过以下方式测试特定适配器：

1. 启动代理服务器：node util/serve.js
2. 在浏览器中访问测试页面，指定适配器：http://localhost:3000/index.html?adapter=touchdb-couchdb

测试文件位置：test/lawnchair-spec.js

适配器开发指南

如果你需要实现自定义适配器，可遵循以下步骤：

1. 以内存适配器作为参考，它是最简单的实现
2. 实现必要的接口方法：save、get、remove等
3. 确保所有方法都接受回调函数作为最后一个参数
4. 使用fn和lambda方法简化回调处理

适配器接口规范详情可参考官方文档：doc/adapters.md

未来展望

Lawnchair的路线图中计划增强适配器功能，包括：

• 将适配器命名为缓存的能力（用于内存操作或回退到服务器存储）
• 添加Redis、Couch、Riak等服务器端存储适配器

通过灵活运用Lawnchair的适配器机制，开发者可以为不同环境和需求提供最佳的客户端存储解决方案，实现从简单的DOM Storage到强大的IndexedDB之间的无缝切换。无论你是开发移动应用还是桌面Web应用，Lawnchair都能提供一致且可靠的数据持久化体验。

【免费下载链接】lawnchairA lightweight clientside JSON document store,项目地址: https://gitcode.com/gh_mirrors/law/lawnchair