EF Core配置映射关系


0. 前言

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

  1. public class ModelA
  2. {
  3. public int Id { get; set; }
  4. public string Name { get; set; }
  5. public List<ModelB> ModelBs { get; } = new List<ModelB>();
  6. }
  7. public class ModelB
  8. {
  9. public int Id { get; set; }
  10. public string Name { get; set; }
  11. public int ModelAId { get; set; }
  12. public ModelA modelA { get; set; }
  13. }

DDL SQL:

  1. CREATE TABLE "ModelBs" (
  2. "Id" INTEGER NOT NULL CONSTRAINT "PK_ModelBs" PRIMARY KEY AUTOINCREMENT,
  3. "Name" TEXT NULL,
  4. "ModelAId" INTEGER NOT NULL,
  5. CONSTRAINT "FK_ModelBs_ModelAs_ModelAId" FOREIGN KEY ("ModelAId") REFERENCES "ModelAs" ("Id") ON DELETE CASCADE
  6. );
  7. -- auto-generated definition
  8. create table ModelAs
  9. (
  10. Id INTEGER not null
  11. constraint PK_ModelAs
  12. primary key autoincrement,
  13. Name TEXT
  14. );

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标记,来约定映射关系。
先引入命名空间:

  1. using System.ComponentModel.DataAnnotations;
  2. using System.ComponentModel.DataAnnotations.Schema;

常见的注解如下:

  1. [Table("ModelA")]

TableAttribute 表示实体映射的哪张表

  1. [Key]

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

  1. [DatabaseGenerated(DatabaseGeneratedOption.Identity)]

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

  1. [ForeignKey("ModelAId")]

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

  1. [InverseProperty("Author")]

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

  1. [Column]

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

  1. [Required]

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

2.2 Fluent 方式

当我们使用这种方式的时候,会面临一个问题:是新建一个配置类呢,还是在 EF上下文的OnModelCreating方法里统一配置呢?
我们先看一下EF上下文的OnModelCreating的声明是什么:

  1. protected internal virtual void OnModelCreating(ModelBuilder modelBuilder);

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

  1. public virtual Microsoft.EntityFrameworkCore.ModelBuilder ApplyConfiguration<TEntity> (Microsoft.EntityFrameworkCore.IEntityTypeConfiguration<TEntity> configuration) where TEntity : class;
  2. public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder<TEntity> Entity<TEntity> () where TEntity : class;

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

  1. void Configure(EntityTypeBuilder<TEntity> builder);

两个都指向了 EntityTypeBuilder<TEntity> builder,而这个正是Fluent API配置类的关键。所以通过分析API,我们可以得到这两种写法。
那么,这两种的取舍呢?
在项目比较小,数据类很少的时候,可以直接在OnModelCreating里写。否则,更建议继承一个Configuration接口。
那么,我们就来看看 通过builder怎么配置映射关系吧:

  1. public class ModelEntityConfig : IEntityTypeConfiguration<ModelA>// 基于 ModelA新建一个配置类
  2. {
  3. public void Configure(EntityTypeBuilder<ModelA> builder)
  4. {
  5. }
  6. }
  1. builder.ToTable("TableName");

设置表名

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

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

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

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

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

表示这个属性不由数据库维护。
回过头来,我们看看 PropertyBuilder里有哪些方法:

  1. // 设置一个最大长度
  2. public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasMaxLength (int maxLength);
  3. // 设置一个数据生成规则
  4. public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasValueGenerator (Func<Microsoft.EntityFrameworkCore.Metadata.IProperty,Microsoft.EntityFrameworkCore.Metadata.IEntityType,Microsoft.EntityFrameworkCore.ValueGeneration.ValueGenerator> factory);
  5. public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasValueGenerator (Type valueGeneratorType);
  6. public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasValueGenerator<TGenerator> () where TGenerator : Microsoft.EntityFrameworkCore.ValueGeneration.ValueGenerator;
  7. // 设置在添加时,自动生成一个值
  8. public virtual Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder ValueGeneratedOnAdd ();
  9. //设置列名
  10. public static Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasColumnName (this Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder propertyBuilder, string name);
  11. // 设置列的数据库参数类型
  12. public static Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder HasColumnType (this Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder propertyBuilder, string typeName);

3. 总结

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


  • 本文作者:GeekPower - Felix Sun
  • 版权声明: 本博客所有文章除特别声明外,均采用 MIT 许可协议。转载请注明出处!