EF Core 中抽象属性映射不同数据库列的实现方案

在 EF Core 实体框架开发中，我们经常会遇到需要将基类中的抽象属性映射到不同派生类中不同数据库列的需求。这种场景通常出现在业务系统中，多个实体类型拥有相同业务含义但数据库列名不同的情况。

业务场景分析

假设我们有一个抽象基类 EntityBase，其中定义了一个抽象属性 Name。然后有两个派生类 EntityA 和 EntityB，它们分别使用不同的数据库列来存储名称信息：

• EntityA 使用 NormalName 列
• EntityB 使用 DefaultName 列

我们的目标是能够在通用代码中通过基类的 Name 属性来统一访问这些不同列的数据，无论是查询还是更新操作。

解决方案

EF Core 7.0 引入了一项重要功能：支持在 TPC（Table-Per-Concrete-Type）和 TPT（Table-Per-Type）继承映射策略下，将同一个 CLR 属性映射到不同表的不同列名。

实现方式

1. 使用 TPC 或 TPT 继承策略

   首先需要配置使用 TPC 或 TPT 继承映射策略，而不是默认的 TPH（Table-Per-Hierarchy）策略。

2. 配置属性到不同列的映射

   在派生类中，我们可以将基类的 Name 属性映射到各自的实际列名：

   protected override void OnModelCreating(ModelBuilder modelBuilder)
   {
       modelBuilder.Entity<EntityA>()
           .Property(e => e.Name)
           .HasColumnName("NormalName");
       
       modelBuilder.Entity<EntityB>()
           .Property(e => e.Name)
           .HasColumnName("DefaultName");
   }
   

3. 实体类定义

   实体类可以保持原有的抽象属性设计，但不需要在派生类中定义额外的属性：

   public abstract class EntityBase
   {
       public Guid Id { get; set; }
       public abstract string? Name { get; set; }
   }
   
   public class EntityA : EntityBase
   {
       public override string? Name { get; set; }
   }
   
   public class EntityB : EntityBase
   {
       public override string? Name { get; set; }
   }
   

注意事项

1. TPH 策略不支持

   这种解决方案不适用于 TPH 继承策略，因为 TPH 将所有类型存储在同一个表中，无法为不同子类型映射同一个属性到不同列。

2. 派生类属性映射

   如果需要同时在派生类中保留 NormalName 和 DefaultName 属性，这种方案无法直接满足需求。此时可以考虑使用计算属性或私有字段来实现。

3. 性能考虑

   TPC 和 TPT 策略在某些查询场景下可能比 TPH 有性能差异，需要根据实际业务场景进行评估。

替代方案

如果必须使用 TPH 策略，可以考虑以下替代方案：

1. 反向映射

   将 Name 属性作为映射属性，而将 NormalName/DefaultName 标记为 [NotMapped]，通过计算属性实现访问：

   public class EntityA : EntityBase
   {
       [NotMapped]
       public string? NormalName
       {
           get => Name;
           set => Name = value;
       }
   }
   

2. 使用接口

   定义一个包含 Name 属性的接口，让派生类显式实现该接口。

总结

EF Core 7.0 及更高版本通过 TPC/TPT 策略支持了将基类属性映射到不同派生类的不同数据库列的功能，这为处理异构数据库设计提供了更多灵活性。开发者在选择方案时需要综合考虑继承策略、性能需求以及代码可维护性等因素。