Ember Data Change Tracker 使用指南

Ember Data Change Tracker 使用指南

ember-data-change-trackerextending ember data to track and rollback changes including objects and associations项目地址:https://gitcode.com/gh_mirrors/em/ember-data-change-tracker

项目介绍

Ember Data Change Tracker 是一个 Ember.js 生态下的扩展，旨在增强 Ember Data 的能力，以跟踪并回滚模型及关联对象的变化。它通过添加自定义方法如 saveTrackerChanges() 和属性如 isDirty 到 DS.Model 中，使得开发者能够更加精细地控制数据状态。此插件特别适用于需要详细变化记录或在复杂交互中管理数据状态的应用场景。支持 Ember Data 版本2.7及以上（对于具有多态关系的情况）或2.5及以上（无多态关系）。提供了自动追踪与手动追踪两种模式。

项目快速启动

安装

要开始使用 Ember Data Change Tracker，首先确保你的项目已经配置了 Ember CLI 环境。然后，在你的项目根目录下执行以下命令来安装这个插件：

ember install ember-data-change-tracker

应用于模型

安装完成后，你可以立刻在你的模型上利用新增的方法和属性。例如，编辑一个模型文件，假设你想对模型的更改进行控制：

// models/user.js
import Model from '@ember-data/model';
import { attr, belongsTo } from '@ember-data/model';
import ChangeTracker from 'ember-data-change-tracker';

export default Model.extend(ChangeTracker, {
    name: attr('string'),
    info: attr('object'), // 默认不会被 Ember Data 自动跟踪
    company: belongsTo('company', { async: false }),
});

当需要手动初始化变更追踪时，比如在测试环境中，记得调用相应的初始化方法：

// 在测试设置中
import { moduleForModel, test } from 'ember-qunit';
import { manualSetup } from 'ember-data-factory-guy';
import { initializer as changeInitializer } from 'ember-data-change-tracker';

moduleForModel('project', 'Unit | Model | project', function (hooks) {
    hooks.beforeEach(function () {
        manualSetup(this.container);
        changeInitializer();
    });
});

实际使用示例

创建一个新的用户模型并保存变更：

let newUser = this.store.createRecord('user', { name: 'Alice' });
newUser.saveTrackerChanges(); // 手动保存更改，若开启自动模式则这步可省略

应用案例和最佳实践

• 脏数据检测：在提交表单之前，检查模型是否已更改，避免不必要的API请求。

if (this.model.isDirty) {
    // 提交数据到服务器
} else {
    // 数据未改变，无需提交
}

• 事务处理：结合 Ember Concurrency 或其他事务管理机制，实现复杂的业务逻辑中的数据状态管理。

典型生态项目集成

虽然特定于 Ember Data Change Tracker 的典型生态项目实例不常见，但其在与诸如Ember Concurrency、Factory Guy等工具集成时非常有用。例如，当你在进行端到端测试或者模拟数据以进行复杂交互的单元测试时，Factory Guy的集成让你可以更精细地控制模型的状态及其变化追踪。

确保在复杂的生态整合中，理解每一步的交互，并适时调用 startTrack()、modelChanges() 和 rollback() 方法，以维持数据的一致性和正确性。

---

以上就是 Ember Data Change Tracker 的简明指南，希望帮助你在 Ember 应用中更好地管理数据状态变化。

ember-data-change-trackerextending ember data to track and rollback changes including objects and associations项目地址:https://gitcode.com/gh_mirrors/em/ember-data-change-tracker