C-数据操作系列-6-EF-Core-配置映射关系

在《C# 数据操作系列 – 5. EF Core 入门》篇中，我们简单的通过两个类演示了一下 EF 增删改查等功能。细心的小伙伴可能看了生成的 DDL SQL 语句，在里面发现了些端倪。没看的小伙伴也不急，这就贴出来。

public class ModelA
{public int Id { get; set;}
    public string Name {get; set;}
    public List<ModelB> ModelBs {get;} = new List<ModelB>();}
public class ModelB
{public int Id { get; set;}
    public string Name {get; set;}
    public int ModelAId {get; set;}
    public ModelA modelA {get; set;}
}

DDL SQL：

CREATE TABLE "ModelBs" (
    "Id" INTEGER NOT NULL CONSTRAINT "PK_ModelBs" PRIMARY KEY AUTOINCREMENT,
    "Name" TEXT NULL,
    "ModelAId" INTEGER NOT NULL,
    CONSTRAINT "FK_ModelBs_ModelAs_ModelAId" FOREIGN KEY ("ModelAId") REFERENCES "ModelAs" ("Id") ON DELETE CASCADE
);
-- auto-generated definition
create table ModelAs
(
    Id   INTEGER not null
        constraint PK_ModelAs
            primary key autoincrement,
    Name TEXT
);

通过简单的示例，我们可以看到 EF 的映射规则是什么。基于约定由于配置的原则，EF 把实体类当做是一个单数形式的类型描述，把表认为是实体类的集合，所以表名为类名的复数形式。

对于主键，默认情况下 EF 会检索实体类有没有名为 Id 或者类名 +Id 的属性，如果有 EF 则认为这个属性是主键，否则会认为该类没有设置主键。EF 检索到主键的类型是数字类型的话，会自动添加自增长的约束。

对于其他属性，EF 会自动按照同名的形式映射到数据表中。

对于外键，如果在类里添加了引用类型，而这个引用类型也在 EF 的上下文中，EF 会把这种属性称为导航属性。EF 一旦在类里检索到了导航属性，就会去寻找对应的外键。EF 会认为属性名 +Id 或者类名 +Id 可能是外键属性，如果找到名称一致且类型与导航属性目标类的主键类型一致，则认为是外键。如果类型不一致，EF 则认为该类设置有误。如果没找到符合名称要求的属性，EF 会自己添加一个外键属性。

对于一对一，EF 要求导航属性双方都应该具有外键配置。

一对多，EF 要求多的一方设置外键。同时如果在一方这边设置了集合类型的导航属性，那么 EF 会自动到目标类里寻找外键属性。

说完了一对一和一对多，那么多对多呢？

如果没有声明的话，EF 会生成一个中间表。

EF 允许开发人员指定自己的映射规则或者单个类的映射规则。EF 提供了几种方式来修改映射关系。

EF 允许开发人员通过使用 Attribute 标记，来约定映射关系。

先引入命名空间：

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

常见的注解如下：

[Table("ModelA")]

TableAttribute 表示实体映射的哪张表

[Key]

KeyAttribute 用来标记哪个属性是主键

[DatabaseGenerated(DatabaseGeneratedOption.Identity)]

用来表示这个字段在第一次插入数据库时，值由数据库提供

[ForeignKey("ModelAId")]

表示该导航属性具体值由名称为 ModelAId 的属性维护，如果没有该属性，EF 则记录添加但不对外显示。

[InverseProperty("Author")]

用在集合类型的属性上，表示该集合属性是与源类哪一个导航属性相关。

[Column]

表示列，用来设置一些列的基本参数，比如类型、名称

[Required]

表示该列在插入数据库时不能为空

使用注解进行相关配置相当简单，但是这样不可避免的需要修改模型类而且需要引入额外的命名空间，不太符合某些要求严格的项目，所以微软又提供了另外一套写法。

当我们使用这种方式的时候，会面临一个问题：是新建一个配置类呢，还是在 EF 上下文的 OnModelCreating 方法里统一配置呢？

我们先看一下 EF 上下文的 OnModelCreating 的声明是什么：

protected internal virtual void OnModelCreating(ModelBuilder modelBuilder);

这里有一个 ModelBuilder 类型，查看它的 API 发现两个方法：

public virtual Microsoft.EntityFrameworkCore.ModelBuilder ApplyConfiguration<TEntity> (Microsoft.EntityFrameworkCore.IEntityTypeConfiguration<TEntity> configuration) where TEntity : class;

public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder<TEntity> Entity<TEntity> () where TEntity : class;

继续寻找 IEntityTypeConfiguration，看到这个接口只有一个方法：

void Configure(EntityTypeBuilder<TEntity> builder);

两个都指向了 EntityTypeBuilder<TEntity> builder，而这个正是 Fluent API 配置类的关键。所以通过分析 API，我们可以得到这两种写法。

那么，这两种的取舍呢？

在项目比较小，数据类很少的时候，可以直接在 OnModelCreating 里写。否则，更建议继承一个 Configuration 接口。

那么，我们就来看看通过 builder 怎么配置映射关系吧：

public class ModelEntityConfig : IEntityTypeConfiguration<ModelA>// 基于 ModelA 新建一个配置类
{public void Configure(EntityTypeBuilder<ModelA> builder)
    {}}

builder.ToTable("TableName");

设置表名

builder.HasKey(t => t.Id);
//builder.HasKey(t => t.Id).HasName("KeyName");

设置主键，如果不写后面的 HasName，则主键名称默认是属性名；写了之后 EF 将使用声明的名称作为主键在数据库的名称。

var property = builder.Property(t => t.Name);

获取一个与属性 Name 相关联的 PropertyBuilder 实例，通过这个实例可以配置属性与数据库列的关系。

builder.Ignore(t => t.ModelBs);

表示这个属性不由数据库维护。

回过头来，我们看看 PropertyBuilder 里有哪些方法：

// 设置一个最大长度
public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasMaxLength (int maxLength);
// 设置一个数据生成规则
public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasValueGenerator (Func<Microsoft.EntityFrameworkCore.Metadata.IProperty,Microsoft.EntityFrameworkCore.Metadata.IEntityType,Microsoft.EntityFrameworkCore.ValueGeneration.ValueGenerator> factory);
public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasValueGenerator (Type valueGeneratorType);
public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasValueGenerator<TGenerator> () where TGenerator : Microsoft.EntityFrameworkCore.ValueGeneration.ValueGenerator;

// 设置在添加时，自动生成一个值
public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder ValueGeneratedOnAdd ();
// 设置列名
public static Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasColumnName (this Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder propertyBuilder, string name);
// 设置列的数据库参数类型
public static Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasColumnType (this Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder propertyBuilder, string typeName);

在这一篇领着大家看了一下 EF Core 对于映射关系这一部分的内容，我留下了外键相关的 FluentAPI 介绍，我打算在下一篇介绍。因为这部分的内容比较麻烦，而且使用率也相当高。

更多内容烦请关注我的博客《高先生小屋》

C-数据操作系列-6-EF-Core-配置映射关系

0. 前言

1. 映射规则

2. 修改映射关系

2.1 数据注解

2.2 Fluent 方式

3. 总结