领域驱动设计案例:Tiny Library:领域模型

本讲主要介绍基于Entity Framework的领域驱动设计建模。首先回顾一下Tiny Library的业务逻辑: 任何用户可以添加Library中的图书

本讲主要介绍基于Entity Framework的领域驱动设计建模。首先回顾一下Tiny Library的业务逻辑:

  1. 任何用户可以添加Library中的图书(简化起见,图书不能修改也不能删除),也可以查看图书的详细信息
  2. 注册用户,也就是读者,可以借书还书、查看自己借过的图书列表借书信息

请注意上面描述的黑体部分,这些概念出现在Tiny Library的领域知识(Domain Knowledge)中,换言之,是Tiny Library领域的通用语言的组成元素。

 

一、实体与聚合根

首先分析出实体,不难看出,读者图书是实体;由于每个读者都将有自己的借书信息(比如,什么时候借的哪本书,是否已经归还,或者是否已经过期),而与之对应地,每本书也可以有被借历史(比如,这本书是什么时候借给哪个读者),于是,借书信息也是实体。

再来看看聚合。借书信息是与读者和图书关联的,也就是说,没有读者,借书信息没有存在的意义,同样,没有图书,借书信息也同样不存在。每个读者可以没有任何借书信息(或者说借书记录),也可以有多条借书信息;而每本书也同样可以没有任何被借信息(或者说被借记录),也可以有多条被借记录。因此存在两个聚合:读者-借书信息聚合(1..0.*)以及图书-借书信息聚合(1..0.*)。读者和图书分别为聚合根,借书信息为实体。与Tiny Library对应起来,总结如下:

  • 读者:Reader,聚合根
  • 图书:Book,聚合根
  • 借书信息:Registration,实体

根据上述描述,我们可以确定,我们将来需要针对读者(Reader)和图书(Book)实现仓储以及相应的规约。

 

二、基于Entity Framework建立领域模型

目前Entity Framework支持三种建模方式:Model First、Database First以及Code First。Code First是在今年刚发布的Feature Pack中才支持的。为了迎合领域驱动设计思想,我们采用Model First。

根据上面的分析,现建模如下:

image

注意:如何在Visual Studio中使用Entity Framework进行Model First建模不是本文讨论的重点,读者朋友请自己参阅相关文档。

此时,我们需要使用C#部分类的特性,将Reader和Book定义为聚合根,将Registration定义为实体。我开发的一个DDD框架(Apworks)中为聚合根和实体的接口作了定义,现在,只需要引用Apworks的程序集,然后使用部分类的特性,让Reader和Book实现IAggregateRoot接口,让Registration实现IEntity接口即可。从技术上看,这样就将Apworks框架整合到了领域模型中。代码如下:

隐藏行号 复制代码 Reader聚合根
  1. public partial class Reader : IAggregateRoot
    
  2. {
    
  3. }
    

 

隐藏行号 复制代码 Book聚合根
  1. public partial class Book : IAggregateRoot
    
  2. {
    
  3. }
    

 

隐藏行号 复制代码 Registration实体
  1. public partial class Registration : IEntity
    
  2. {
    
  3. }
    

三、添加业务逻辑

根据DDD,实体是能够处理业务逻辑的,应该尽量将业务体现在实体上;如果某些业务牵涉到多个实体,无法将其归结到某个实体的话,就需要引入领域服务(Domain Service)。Tiny Library案例业务简单,目前不会涉及到领域服务,因此,在本案例中,业务逻辑都是在实体上处理的。

以读者(Reader)为例,它有借书和还书的行为,我们将这两种行为实现如下:

隐藏行号 复制代码 Reader中的业务逻辑
  1. public partial class Reader : IAggregateRoot
    
  2. {
    
  3.     public void Borrow(Book book)
    
  4.     {
    
  5.         if (book.Lent)
    
  6.             throw new InvalidOperationException("The book has been lent.");
    
  7.         Registration reg = new Registration();
    
  8.         reg.RegistrationStatus = RegistrationStatus.Normal;
    
  9.         reg.Book = book;
    
  10.         reg.Date = DateTime.Now;
    
  11.         reg.DueDate = reg.Date.AddDays(90);
    
  12.         reg.ReturnDate = DateTime.MaxValue;
    
  13.         book.Registrations.Add(reg);
    
  14.         book.Lent = true;
    
  15.         this.Registrations.Add(reg);
    
  16.     }
    
  17.     public void Return(Book book)
    
  18.     {
    
  19.         if (!book.Lent)
    
  20.             throw new InvalidOperationException("The book has not been lent.");
    
  21.         var q = from r in this.Registrations
    
  22.                 where r.Book.Id.Equals(book.Id) &&
    
  23.                 r.RegistrationStatus == RegistrationStatus.Normal
    
  24.                 select r;
    
  25.         if (q.Count() > 0)
    
  26.         {
    
  27.             var reg = q.First();
    
  28.             if (reg.Expired)
    
  29.             {
    
  30.                 // TODO: Reader should pay for the expiration.
    
  31.             }
    
  32.             reg.ReturnDate = DateTime.Now;
    
  33.             reg.RegistrationStatus = RegistrationStatus.Returned;
    
  34.             book.Lent = false;
    
  35.         }
    
  36.         else
    
  37.             throw new InvalidOperationException(string.Format("Reader {0} didn't borrow this book.",
    
  38.                 this.Name));
    
  39.     }
    
  40. }
    

 

业务逻辑的添加仍然是在我们新建的partial class中,这样做的目的就是为了不让Entity Framework的代码自动生成器覆盖我们手动添加的代码。相应地,我们在Book和Registration中实现各自的业务逻辑(具体请参见案例源代码)。从TinyLibrary.Domain这个Project上看,TinyLibrary.edmx定义了基于Entity Framework的领域模型,而其它的几个C#代码文件则使用部分类的特性,分别针对每个实体/聚合根实现了一些业务逻辑。

image

 

下一讲将详细介绍基于TinyLibrary领域模型与Entity Framework的仓储的实现方式。

标签: 借书 是在 本书