Backbone.dualStorage 项目使用教程

1. 项目的目录结构及介绍

Backbone.dualStorage 是一个为 Backbone.js 提供的同步适配器，它可以将数据保存在本地存储（localStorage）和远程服务器上。以下是项目的目录结构及其简要介绍：

Backbone.dualStorage/
├── lib/                       # 存放编译后的 JavaScript 文件
│   ├── backbone.dualstorage.amd.js
│   ├── backbone.dualstorage.coffee
│   └── backbone.dualstorage.js  # Backbone.dualStorage 的主要实现文件
├── spec/                      # 测试用例目录
├── bower.json                 # Bower 包配置文件
├── package.json               # npm 包配置文件
├── README.md                  # 项目说明文件
├── CHANGES.md                 # 更改日志文件
├── CONTRIBUTING.md            # 贡献指南
├── LICENSE.md                 # 许可证文件
└── CODE_OF_CONDUCT.md         # 行为准则

2. 项目的启动文件介绍

Backbone.dualStorage 项目没有特定的启动文件，因为它是作为一个库被其他项目引用的。要开始使用 Backbone.dualStorage，你需要将它包含在你的项目中，通常是通过在 HTML 文件中引入编译后的 JavaScript 文件：

<script type="text/javascript" src="path/to/backbone.js"></script>
<script type="text/javascript" src="path/to/backbone.dualstorage.js"></script>

在引入 Backbone.js 之后，你可以通过上述方式引入 Backbone.dualStorage。

3. 项目的配置文件介绍

Backbone.dualStorage 的配置主要通过在模型或集合上设置属性来完成。以下是一些常用的配置选项：

• remote: 当设置为 true 时，表示该模型或集合的数据将同步到远程服务器；设置为 false 则表示数据只保存在本地存储。
• local: 当设置为 true 时，表示该模型或集合的数据将只保存在本地存储；设置为 false 则表示数据将同步到远程服务器。
• storeName: 用于覆盖默认的存储命名空间，这个命名空间通常基于模型的 url 属性。

例如，你可以创建一个集合并配置它只使用本地存储：

SomeCollection = Backbone.Collection.extend({
  local: true  // 始终只在本地存储数据，不保存到远程
});

或者，你可以动态地决定是否使用本地存储：

SomeCollection = Backbone.Collection.extend({
  local: function() {
    // 根据某些条件返回 true 或 false
    return trueOrFalse;
  }
});

此外，Backbone.dualStorage 还允许你自定义处理离线状态和远程数据解析的逻辑。你可以通过设置 Backbone.DualStorage.offlineStatusCodes 来自定义哪些 HTTP 状态码表示离线状态，以及通过在模型上定义 parseBeforeLocalSave 方法来自定义远程数据的解析逻辑。

以上是 Backbone.dualStorage 的基本配置和使用方法。在实际项目中，你需要根据自己的需求进行调整和扩展。