C# 數據操作系列 – 6 EF Core 配置映射關係
0. 前言
在《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
);
1. 映射規則
通過簡單的示例，我們可以看到EF的映射規則是什麼。基於約定由於配置的原則，EF把實體類當做是一個單數形式的類型描述，把表認為是實體類的集合，所以表名為類名的複數形式。
對於主鍵，默認情況下EF會檢索實體類有沒有名為Id或者類名+Id的屬性，如果有EF則認為這個屬性是主鍵，否則會認為該類沒有設置主鍵。EF檢索到主鍵的類型是數字類型的話，會自動添加自增長的約束。
對於其他屬性，EF會自動按照同名的形式映射到數據表中。
對於外鍵，如果在類里添加了引用類型，而這個引用類型也在EF的上下文中，EF會把這種屬性稱為導航屬性。EF一旦在類里檢索到了導航屬性，就會去尋找對應的外鍵。EF會認為 屬性名+Id或者類名+Id 可能是外鍵屬性，如果找到名稱一致且類型與導航屬性目標類的主鍵類型一致，則認為是外鍵。如果類型不一致，EF則認為該類設置有誤。如果沒找到符合名稱要求的屬性，EF會自己添加一個外鍵屬性。
對於一對一，EF要求導航屬性雙方都應該具有外鍵配置。
一對多，EF要求多的一方設置外鍵。同時如果在一方這邊設置了集合類型的導航屬性，那麼EF會自動到目標類里尋找外鍵屬性。
說完了一對一和一對多，那麼多對多呢？
如果沒有聲明的話， EF會生成一個中間表。
2. 修改映射關係
EF允許開發人員指定自己的映射規則或者單個類的映射規則。EF 提供了幾種方式來修改映射關係。
2.1 數據註解
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]
表示該列在插入資料庫時不能為空
使用註解進行相關配置相當簡單，但是這樣不可避免的需要修改模型類而且需要引入額外的命名空間，不太符合某些要求嚴格的項目，所以微軟又提供了另外一套寫法。
2.2 Fluent 方式
當我們使用這種方式的時候，會面臨一個問題：是新建一個配置類呢，還是在 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);
3. 總結
在這一篇領著大家看了一下EF Core對於映射關係這一部分的內容，我留下了外鍵相關的FluentAPI介紹，我打算在下一篇介紹。因為這部分的內容比較麻煩，而且使用率也相當高。
更多內容煩請關注我的部落格《高先生小屋》
