EFCore在DDD中的使用

在DDD中,我们对聚合根的操作都会通过仓储去获取聚合实例。

因为聚合根中可能会含有实体属性,值对象属性,并且,在DDD中,我们所设计的领域模型都是充血模型。所以,在对聚合根的持久化中,最方便的还是Mangodb这种KEY-VALUE存储的NOSQL。

不过,关系型数据库通过EF也能方便的解决复杂模型的数据库映射。

本文使用EFCore,部分API不适用于EF;本文不谈DDD。

以下引出几个知识点:

  • backing field
  • releation
  • lazy load
  • data binding
  • navigation property
  • converter

让我们开始吧

我们首先定义一个复杂关系的 对象模型;

大致上描述下这个BookEntity根实体类的几个定义:

  • 拥有只读的属性 Name
  • 拥有两个对象属性AuthorCatalog
  • 枚举EnumBookType类型属性Type
  • 拥有两个私有的列表字段 _chapters_keyWords

简单映射

class BookEntity{
private BookEntity(string name){
Name = name;
}
public string Name { get; }
public string BookCoverImage { get; private set; }
public EnumBookType Type { get; private set; }
//...
} class BookEntityTypeConfiguration : IEntityTypeConfiguration<BookEntity>{
public void Configure(EntityTypeBuilder<BookEntity> builder){
builder.Property<string>("Id").HasColumnName("_id_")
.HasValueGenerator<StringGuidValueGenerator>(); builder.Property(x => x.Name);
builder.Property(x => x.Type)
.HasConversion<string>(k => k.ToString(), v => Enum.Parse<EnumBookType>(v));
}
}

在上述代码中,我们定义了一个简单对象类及它的配置项。

  • BookEntity中未定义Id主键,我们通过 阴影属性 的方式指定了一个主键,并将它映射到db的_id_列;
  • EF中默认绑定 有 setter 方法的 public getter 属性,而我们的Name没有setter方法,我们必须通过在配置中显示调用 Property() 将其加入到绑定中。
  • EF中可以通过构造函数将字段绑定到实体上。
  • 可以能过调用 HasConversion() 方法显示指定使用的转换方法。比如将IDictionary<string,string> 保存为 string

那么我们如何根据 主键 查询呢?

EF 为我们提供了静态方法EF.Property()

var entity = ctx.Set<BookEntity>().FirstOrDefault(x=>EF.Property<string>(x,"Id") == "1");

关系与固有类型

在官方文档中,关系主要使用以下几种方法来配置的。

  • HasOne()
  • HasMany()
  • WithOne()
  • WithMany()

OwnsType (固有类型)是新近推出的API。

  • OwnsOne()
  • OwnsMany()

虽然都会创建导航属性,但是从定义和使用上来看

,还是有很大区别的。

经过测试,导航属性不能通过构造函数绑定,所以以下配置中,均使用 private setter

(如果有读者发现错误,欢迎指正。)

下面我们就对两种API进行配置。

OwnsType的配置

从使用上的角度上来看,OwnsType像其名字一样,强调的是A拥有B,这个属性是这个类固有的,没有懒加载的配置。

扩展我们之前写义的实体类。

class BookEntity{
//...略
public AuthorInfo Author { get; private set; } private List<KeyWordInfo> _keyWords = new List<KeyWordInfo>();
public IEnumerable<KeyWordInfo> KeyWords => _keyWords;
} class AuthorInfo
{
public AuthorInfo(string name){
Name = name;
}
public string Name { get; }
}
class KeyWordInfo
{
public KeyWordInfo(string word){
Word = word;
}
public string Word { get; }
}

扩展配置类

class BookEntityTypeConfiguration : IEntityTypeConfiguration<BookEntity>{
builder.OwnsOne(x => x.Author, b => {
b.Property(v => v.Name).HasColumnName("AuthorName");
});
builder.OwnsMany(x => x.KeyWords, b =>
{
b.ToTable("BookKeyWords");
b.Property<int>("Id").HasColumnName("_id_");
b.HasKey("Id");
b.Property(x => x.Word);
b.HasForeignKey("BookId");
}); builder.Metadata.FindNavigation(nameof(BookEntity.KeyWords))
.SetPropertyAccessMode(PropertyAccessMode.Field);
}

默认情况下,OwnsOne()会与实体映射在同一张表,OwnsMany()没有做具体测试。

这里我们对导航属性KeyWords进行了配置,因为它是只读的,所以我们将它配置为绑定为字段,这个私有字段叫做backing field(支持字段??),在EF中默认有以下4种格式,当然这是支持自定义的:

  • _< camel-cased property name >
  • _< property name >
  • m_< camel-cased property name >
  • m_< property name >

那什么是backing field ???

ReleationShip 配置

HasOne()这种关系API,更适合于A与B之前的关系,比如 1-* (一对多)的关系、1-1(一对一)的关系等等,所以这种配置必须在不同表中。

class BookEntity{
//...略
private IList<BookChapterEntity> _chapters = new List<BookChapterEntity>();
public IEnumerable<BookChapterEntity> Chapters => _chapters;
}
class BookEntityTypeConfiguration : IEntityTypeConfiguration<BookEntity>
{
public void Configure(EntityTypeBuilder<BookEntity> builder)
{
//...略
builder.HasMany(x => x.Chapters).WithOne().HasForeignKey("BookId"); builder.Metadata.FindNavigation(nameof(BookEntity.Chapters))
.SetPropertyAccessMode(PropertyAccessMode.Field);
}
}
class BookChapterEntityTypeConfiguration : IEntityTypeConfiguration<BookChapterEntity>
{
public void Configure(EntityTypeBuilder<BookChapterEntity> builder)
{
builder.Property(x => x.Title);
builder.Property(x => x.Index);
builder.Property<string>("Id");
}
}

从配置上来看,我们的两个实体都是分开配置的,而从实体类角度上看,这里是两个类体的关系,我们配置的是 1-的关系。

使用HasOne()
ReleationShip* Api配置的属性,默认是不加载的,我们可以通过配置进行立即加载或延迟加载。

我们可以查看官方文档查看懒加载的方式。

https://docs.microsoft.com/en-us/ef/core/querying/related-data

backing field (支持字段)

我们都知道C#中有这样子的写法。

class Foo{
public string Name{get;set;}
}

写完整了是这样的。

class Foo{
private string _name;
public string Name{
get{return _name;}
set{_name = value;}
}
}

而在其它语言中,可能是这样的。

class Foo{
private string _name;
public string GetName(){
return _name;
}
public void SetName(value){
_name = value;
}
}

我认为以上的_name就是一个backing field; 以字面意思解释就是属性底层的字段。

查询过滤器 Query Filter

我们公司的业务设计上,数据不能真删,通过一个 IsDeleted 字段进行控制。这样在有必要的情况下,我们可以将数据进行还原。

class BookEntityTypeConfiguration : IEntityTypeConfiguration<BookEntity>
{
public void Configure(EntityTypeBuilder<BookEntity> builder)
{
//...略
builder.Property<bool>("IsDeleted");
builder.HasQueryFilter(x=>!EF.Property<bool>(x,"IsDeleted"));
}
}

我们通过HasQueryFilter()配置一个全局过滤器。

什么?你说又要查询的时候要查询IsDeleted == true的数据??

var allBooks = ctx.Set<BookEntity>()
.IgnoreQueryFilters()
.ToList();
//通过 IgnoreQueryFilters 忽视掉全局过滤器;

更多的查看官方文档

https://docs.microsoft.com/en-us/ef/core/querying/filters

结尾总结

在我们项目切换到DDD模式下开发的时候,使用关系型数据库作为仓储的实现真是头疼。还好,我们有EF,但是如果对EF的API和映射不熟悉的话,会导致出现因技术原因修改领域模型的情况,而这种情况是我们应该避免的。

如发现文中有误,欢迎指正。

DDD中的EFCore的更多相关文章

  1. EFCore:关于DDD中值对象(Owns)无法更新数值

    最近使用DDD+EFCore时,使用EFCore提供的OwnsOne或者OwnsMany关联值对象保存数据,没想到遇到一个很奇怪的问题:值对象中的值竟然无法被EFCore保存!也没有抛出任何异常!我瞬 ...

  2. 初探领域驱动设计(2)Repository在DDD中的应用

    概述 上一篇我们算是粗略的介绍了一下DDD,我们提到了实体.值类型和领域服务,也稍微讲到了DDD中的分层结构.但这只能算是一个很简单的介绍,并且我们在上篇的末尾还留下了一些问题,其中大家讨论比较多的, ...

  3. DDD~Unity在DDD中的使用

    回到目录 上一讲介绍了DDD中的领域层,并提到下次要讲Unity,所以这篇文章当然就要介绍它了,呵呵,Unity是Microsoft.Practices中的一部分,主要实现了依赖注入的功能,或者叫它控 ...

  4. Repository在DDD中的应用

    Repository在DDD中的应用2014-10-09 08:55 by Jesse Liu, 98 阅读, 0 评论, 收藏, 编辑 概述 上一篇我们算是粗略的介绍了一下DDD,我们提到了实体.值 ...

  5. DDD中的分层架构

    DDD中的分层架构很好的应用了关注点分离原则Separation of Concerns(SOC),每一层做好自己的事情,减少交叉 表现层 表现层提供用来完成任务的用户界面,如webform wpf ...

  6. 对DDD中领域服务的理解

    CZ 能不能清晰具体区分service和实体的区别 网上有人用DCI来解决 不知道对不对 STST 我复习下DDD中的服务的概念了参与讨论啊CZ 这个我也看过 但是太过于笼统 STST STST 复习 ...

  7. DDD中的聚合和UML中的聚合以及组合的关系

    UML:聚合关系:成员对象是整体的一部分,但是成员对象可以脱离整体对象独立存在.如汽车(Car)与引擎(Engine).轮胎(Wheel).车灯(Light)之间的关系为聚合关系,引擎.轮胎.车灯可以 ...

  8. DDD中的值对象如何用NHibernate进行映射

    原文:DDD中的值对象如何用NHibernate进行映射 <component/>是NHibernate中一个有趣的特性,即是用来映射DDD(Data-Display-Debuger)概念 ...

  9. Java实现DDD中UnitOfWork

    Java实现DDD中UnitOfWork 背景 Maintains a list of objects affected by a business transaction and coordinat ...

随机推荐

  1. 自己动手设计并实现一个linux嵌入式UI框架

    一直以来都是使用现成的UI框架,如微软的window.QT等,因为它有各种控件(如button.window.edit等)都已经封装实现好了.我们只要拿来用就是了,也一直认为它很神圣,没有深入了解它背 ...

  2. 构建基于asp.net core 的docker应用并发布

    发布Docker镜像的方法有很多种,asp.net core的发布需要在windows系统中 开门见山,首先保证已经在Centos上安装好了Docker.创建一个asp.net core的webapi ...

  3. Webserver asp配置及伪静态设置

    Webserver  IIS asp配置及伪静态设置 一.概述: 在Windows Server 2003系统中,用户可以借助IIS 6.0配置基于ASP.PHP.asp.NET等语言的动态Web网站 ...

  4. asp.net mvc项目创建WebApi简单例子

    1.创建默认路由的映射. namespace RedisDemo.App_Start { public class WebApiConfig { public static void Register ...

  5. C++中引用的形参使用

    引用解释: (1)引用仅是变量的别名,而不是实实在在地定义了一个变量,因此引用本身并不占用内存,而是和目标变量共同指向目标变量的内存地址,即共用内存 (2)引用和目标变量的地址是一样的,对引用的操作与 ...

  6. 爬虫开发13.UA池和代理池在scrapy中的应用

      今日概要 scrapy下载中间件 UA池 代理池 今日详情 一.下载中间件 下载中间件(Downloader Middlewares) 位于scrapy引擎和下载器之间的一层组件. - 作用: ( ...

  7. [Swift实际操作]八、实用进阶-(8)使用performSegue在故事板页面之间进行数据传递

    本文将演示故事板页面之间的数据传递.首先在一个空白项目中,打开项目自带的故事板文件(Main.storyboard).故事板中已经拥有了一个视图控制器,点击选择该视图控制器.然后依此点击[Editor ...

  8. [译文]casperjs使用说明-使用命令行

    使用命令行 Casperjs使用内置的phantomjs命令行解析器,在cli模块里,它传递参数位置的命名选项 但是不要担心不能熟练操控CLI模块的API,一个casper实例已经包含了cli属性,允 ...

  9. [整理] Nginx Location 匹配规则

    目录 规则语法 location 分类 匹配顺序: 扩展 location / {}和 location =/ {}的区别 如何快速测试 规则语法 语法 匹配规则 空 普通匹配(遵循最大前缀匹配规则, ...

  10. Angular material mat-icon 资源参考_Hardware

    ul,li>ol { margin-bottom: 0 } dt { font-weight: 700 } dd { margin: 0 1.5em 1.5em } img { height: ...