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介绍,我打算在下一篇介绍。因为这部分的内容比较麻烦,而且使用率也相当高。
更多内容烦请关注我的博客《高先生小屋》
C# 数据操作系列 - 6 EF Core 配置映射关系的更多相关文章
- C# 数据操作系列 - 8. EF Core的增删改查
0.前言 到目前为止,我们看了一下如何声明EF Core的初步使用,也整体的看了下EF Core的映射关系配置以及导航属性的配置. 这一篇,我带大家分享一下,我在工作中需要的EF Core的用法. 1 ...
- C# 数据操作系列 - 7. EF Core 导航属性配置
在上一篇,大概介绍了Entity Framework Core关于关系映射的逻辑.在上一篇中留下了EF的外键映射没有说,也就是一对一,一对多,多对一,多对多的关系等.这一篇将为大家细细分析一下,如何设 ...
- C# 数据操作系列 - 9. EF Core 完结篇
0.前言 <EF Core>实际上已经可以告一段落了,但是感觉还有一点点意犹未尽.所以决定分享一下,个人在实际开发中使用EF Core的一些经验和使用的扩展包. 1. EF Core的异步 ...
- C# 数据操作系列 - 5. EF Core 入门
0.前言 上一章简单介绍了一下ORM框架,并手写了一个类似ORM的工具类.这一章将介绍一个在C#世界里大名鼎鼎的ORM框架--Entity Framework的Core版. Entity Framew ...
- asp.net core系列 26 EF模型配置(实体关系)
一.概述 EF实体关系定义了两个实体互相关联起来(主体实体和依赖实体的关系,对应数据库中主表和子表关系). 在关系型数据库中,这种表示是通过外键约束来体现.本篇主要讲一对多的关系.先了解下描述关系的术 ...
- C# 数据操作系列 - 12 NHibernate的增删改查
0. 前言 上一篇<C# 数据操作系列 - 11 NHibernate 配置和结构介绍> 介绍了Nhibernate里的配置内容.这一篇将带领大家了解一下如何使用NHIbernate.之前 ...
- C# 数据操作系列 - 15 SqlSugar 增删改查详解
0. 前言 继上一篇,以及上上篇,我们对SqlSugar有了一个大概的认识,但是这并不完美,因为那些都是理论知识,无法描述我们工程开发中实际情况.而这一篇,将带领小伙伴们一起试着写一个能在工程中使用的 ...
- C# 数据操作系列 - 16 SqlSugar 完结篇
0. 前言 前一篇我们详细的介绍了SqlSugar的增删改查,那些已经满足我们在日常工程开发中的使用了.但是还有一点点在开发中并不常用,但是却非常有用的方法.接下来让我们一起来看看还有哪些有意思的内容 ...
- C# 数据操作系列 - 19 FreeSql 入坑介绍
0. 前言 前几天FreeSql的作者向我推荐了FreeSql框架,想让我帮忙写个文章介绍一下.嗯,想不到我也能带个货了.哈哈,开个玩笑-看了下觉得设计的挺有意思的,所以就谢了这篇文章. 简单介绍一下 ...
随机推荐
- 刷题记录:[V&N2020 公开赛]TimeTravel
题目复现链接:https://buuoj.cn/challenges 参考链接:2020 年 V&N 内部考核赛 WriteUp V&N公开赛2020 writeup httpoxy ...
- jmeter事务控制器
jmeter事务控制器常用于压力测试时如果一个功能包括多个请求时,需要测试这个功能的压力情况,则需要把多个请求放到一个事务控制器里面
- [PHP]听说随机数mt_rand()比rand()速度快,闲的无聊测试了一下!
废话不说上码 //microtime() 函数返回当前 Unix 时间戳的微秒数.//当设置为 TRUE 时,规定函数应该返回一个浮点数,否则返回一个字符串.默认为 FALSE. <?php h ...
- redis: 乐观锁(十)
监视:watch 正常业务(单线程): 127.0.0.1:6379> set money 100 #模拟存款100元 OK 127.0.0.1:6379> set moneyout 0 ...
- 【已解决】error setting certificate verify locations报错
目录 1.问题描述 2.问题分析 3.解决方法 1.问题描述 在公司的电脑上从Github上clone项目的时候git黑窗口报错"error setting certificate veri ...
- 以命令行界面启动 Ubuntu
1. /etc/default/grub 将GRUB_CMDLINE_LINUX_DEFAULT一行中改为"quiet splash 3" 2. update-grub 3. 重启
- javascript SDK开发之webpack中eslint的配置
eslint的好处就不多说了.代码检查,代码报错, 智能提示,让开发人员更规范的撸代码等等. 1.安装依赖 npm install --save-dev eslint eslint-friendly- ...
- windows右键没有新建选项的解决办法
1 以管理员身份运行cmd 2 cmd /k reg add "HKEY_CLASSES_ROOT\Directory\Background\shellex\ContextMenuHandl ...
- MongoDB学习(四):通过Java使用MongoDB
环境配置 在Java项目中使用MongoDB,需要在项目中引入mongo.jar这个包.下载地址:下载 请尽量下载较新的版本,本文用的是2.10.1. 连接MongoDB public synchro ...
- uboot on qemu
1, download uboot ftp://ftp.denx.de/pub/u-boot/ 2, compile uboot make vexpress_ca9x4_config export A ...