EF Core 映射复杂类型,核心就是用 Owned Entity Types(自有实体类型),它本质是官方对“值对象”的原生支持。不是新建表,也不是普通导航属性,而是把值对象的字段直接展平到拥有者的数据库表里。
怎么定义一个值对象类
值对象要体现“无标识、按值比较、不可变(推荐)”的特点:
用 record 最省事,自动实现Equals和
GetHashCode或者用普通 class,手动重写相等性逻辑,确保所有属性参与比较 属性设为
init或只读,避免外部随意修改
示例:
public record Address
{
public string Street { get; init; }
public string City { get; init; }
public string PostalCode { get; init; }
public string Country { get; init; }
}
怎么在实体中使用
直接作为属性声明,不需要主键、不单独映射表:
public class Order
{
public int Id { get; set; }
public string Number { get; set; }
public Address ShippingAddress { get; set; } // 这里就用了
public Address BillingAddress { get; set; }
}
注意:同一个实体里可以有多个同类型的复杂属性(比如收货地址 + 账单地址),EF Core 能区分列名。
怎么配置映射关系
必须显式告诉 EF Core 这是个自有类型,两种方式任选其一:
在OnModelCreating中调用
OwnsOne给值对象类加
[Owned]特性(EF Core 2.1+ 支持)
推荐用代码配置,更清晰可控:
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Order>()
.OwnsOne(o => o.ShippingAddress, sa =>
{
sa.Property(a => a.Street).HasColumnName("Ship_Street");
sa.Property(a => a.City).HasColumnName("Ship_City");
sa.Property(a => a.PostalCode).HasColumnName("Ship_PostalCode");
});
modelBuilder.Entity<Order>()
.OwnsOne(o => o.BillingAddress, ba =>
{
ba.Property(a => a.Street).HasColumnName("Bill_Street");
ba.Property(a => a.City).HasColumnName("Bill_City");
});
}
这样生成的表里,
Order表会包含
Ship_Street、
Bill_City等字段,没有额外表。
集合型复杂类型怎么处理
如果一个实体要拥有多个值对象(比如客户有多个联系地址),用
OwnsMany:
public class Customer
{
public int Id { get; set; }
public string Name { get; set; }
public List<Address> Addresses { get; set; } = new();
}
配置方式类似:
modelBuilder.Entity<Customer>()
.OwnsMany(c => c.Addresses, a =>
{
a.WithOwner().HasForeignKey("CustomerId");
a.Property(x => x.Street).HasColumnName("Addr_Street");
});
这时会生成一张关联子表
CustomerAddresses,带外键和自增序号,但依然没有独立主键或生命周期。
基本上就这些。关键记住:复杂类型不是实体,不查库、不跟踪ID、不单独存,只依附于拥有者存在。
