EF Core 新特性——Owned Entity Types

Posted 2021-01-29 indexlang

Owned Entity Types

首先owned entity type是EF Core 2.0的新特性。

至于什么是owned entity types，可以先把他理解为EF Core官方支持的值对象。

值对象

举一个简单的例子，你可能在开发中经常遇到，订单，地址，地址簿的关系：

    public class Order
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public double Price { get; set; }
        public Address Address { get; set; }
    }

    public class AddressBook
    {
        public string FriendName { get; set; }
        public int Id { get; set; }
        public Address Address { get; set; }
    }

    public class Address
    {
        public string City { get; set; }
        public string Street { get; set; }
    }

这个示例里面的Address对象就是典型的值对象，他在订单中意义是订单地址，他在电话本里的意义是朋友的住址，就像订单里的Name和AddressBook中FriendName一样，你改了就改了，和其他的没关系，不会因为你改了订单地址就修改了电话本那个人的地址。

https://www.cnblogs.com/xishuai/p/ddd_valueobject_entityframework.html  这篇大神的文章详细介绍了值对象在以前版本EF中的设计，现在有了Owned Entity Types，就有了官方实现。

定义

官方文档上的定义，翻译过来就是：EF  Core 定义在model中仅用于显示的其他实体类型Navigation properties被称为Owned Entity types，就叫做自有实体吧，拥有自有实体的实体叫做拥有者。

下面看看怎么在EF Core中实现。

显式配置

自有实体  在EF Core不能使用惯例方式，可以在OnModelCreating方法中使用OwnsOne方法，或者使用声明属性（OwnedAttribute，EF Core 2.1以上版本支持）。

[Owned]
public class Address
{
    public string Street { get; set; }
    public string City { get; set; }
}

modelBuilder.Entity<Order>().OwnsOne(p => p.Address);
//或者使用这种方式
modelBuilder.Entity<Order>().OwnsOne(typeof(Address), "Address");

这在EF Core中时通过影子属性（ shadow property）实现的，

自有实体集合是在EF Core 2.2中实现，可以使用OnModelCreating的OwnsMany方法实现：

modelBuilder.Entity<Distributor>().OwnsMany(p => p.ShippingCenters, a =>
{
    a.HasForeignKey("DistributorId");
    a.Property<int>("Id");
    a.HasKey("DistributorId", "Id");
});

数据库

惯例情况是：Address属性在Order表中的名字是：Address_City和Address_Street，你也可以在OwnsOne方法中使用HasColumnName自定义列名，也可以存储到单独的表中，下面代码将地址存到单独表(orderAddress）中：

modelBuilder.Entity<Order>().OwnsOne(
    o => o.Address,
    sa =>
    {
　　　　 sa.ToTable("orderAddress");
        sa.Property(p => p.Street).HasColumnName("ToStreet");
        sa.Property(p => p.City).HasColumnName("ToCity");
    });

查询

 跟普通的属性一样：

var order = context.Orders.FirstOrDefault();
Console.WriteLine($"TO: {order.ShippingAddress.City}");

限制

• 不能生成自有对象的DbSet<T> 。
• 不能在ModelBuilder中使用自有对象的Entity<T>()。

即将实现：

• 自有对象不支持继承。
• 除非在单独的表中使用，否则自有对象不能为空。
• 多个拥有者不能使用同一个自有对象（废话）。

 以前版本存在问题：

• EF Core 2.0中除非存在独立的表中，否则自有对象不能在派生实体类型中声明。
• EF Core 2.0和2.1只支持指向自有对象的reference navigations ，在2.2中移除这一限制。

 

以上是关于EF Core 新特性——Owned Entity Types的主要内容，如果未能解决你的问题，请参考以下文章

关于 EF Core 中的“拥有”类型

EF CORE中复杂类型的映射

EF CORE中复杂类型的映射

张高兴的 Entity Framework Core 即学即用：创建第一个 EF Core 应用

EF6 vs Entity Framework Core：插入实体而不将主键（身份）重置为零

EF6 System.Data.Entity.Core.EntityKey 在 Entity Framework Core 中的等价物是啥？