Trackable Entities 项目教程-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00024/article/details/139914707

Trackable Entities 项目教程

trackable-entities N-Tier Support for Entity Framework with WCF or ASP.NET Web API 项目地址: https://gitcode.com/gh_mirrors/tr/trackable-entities

1、项目介绍

Trackable Entities 是一个为 Entity Framework 提供 N-Tier 支持的开源项目，适用于 WCF 或 ASP.NET Web API。该项目的主要功能是跟踪对象图中的实体变化，以便在单次往返中将这些变化发送到 Web 服务并持久化，同时确保在一个事务中完成。

Trackable Entities 提供了以下主要功能：

变化跟踪：能够跟踪对象图中实体的变化状态（新增、修改、删除）。
变化应用：在服务器端，通过 ApplyChanges 扩展方法将变化应用到 Entity Framework 的 DbContext 类中。
变化获取：在客户端，通过 GetChanges 方法获取仅包含变化的实体，减少带宽消耗并提高性能。
变化合并：在客户端，通过 MergeChanges 方法将更新后的实体合并回原始对象图。

2、项目快速启动

安装

首先，通过 NuGet 安装 Trackable Entities 的客户端和服务器端包：

Install-Package TrackableEntities.Client
Install-Package TrackableEntities.EF.6

创建实体类

创建一个简单的实体类，并实现 ITrackable 接口：

public class Product : ITrackable
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }

    public TrackingState TrackingState { get; set; }
    public ICollection<string> ModifiedProperties { get; set; }
    public Guid EntityIdentifier { get; set; }
}

创建 DbContext

创建一个继承自 DbContext 的类，并添加 DbSet<Product>：

public class MyDbContext : DbContext
{
    public DbSet<Product> Products { get; set; }
}

跟踪变化

在客户端，创建一个 ChangeTrackingCollection 并启用跟踪：

var product = new Product { Id = 1, Name = "New Product", Price = 99.99m };
var changeTracker = new ChangeTrackingCollection<Product>(product) { Tracking = true };

// 修改实体
product.Price = 109.99m;

// 获取变化
var changes = changeTracker.GetChanges();

应用变化

在服务器端，使用 ApplyChanges 方法将变化应用到 DbContext：

using (var context = new MyDbContext())
{
    context.ApplyChanges(changes);
    context.SaveChanges();
}

3、应用案例和最佳实践

应用案例

Trackable Entities 适用于需要高效处理实体变化的 N-Tier 应用程序。例如，在一个电子商务系统中，用户在前端修改商品价格后，系统需要将这些变化快速同步到数据库中。使用 Trackable Entities 可以确保这些变化在单次往返中被持久化，同时保持数据的一致性。

最佳实践

使用 ChangeTrackingCollection：在客户端使用 ChangeTrackingCollection 来管理实体的变化，确保只有变化的实体被发送到服务器。
批量处理变化：在服务器端，使用 ApplyChanges 方法批量处理变化，减少数据库操作次数，提高性能。
合并变化：在客户端，使用 MergeChanges 方法将服务器返回的更新实体合并回原始对象图，确保客户端数据的一致性。