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

发布时间：2024-03-26 08:40:12 来源：网络

.

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

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

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

请注意上面描述的黑体部分，这些概念出现在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。

根据上面的分析，现建模如下：

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

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

Reader聚合根

public partial class Reader : IAggregateRoot

```
{
```
```
}
```

Book聚合根

public partial class Book : IAggregateRoot

```
{
```
```
}
```

Registration实体

public partial class Registration : IEntity

```
{
```
```
}
```

三、添加业务逻辑

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

以读者（Reader）为例，它有借书和还书的行为，我们将这两种行为实现如下：

Reader中的业务逻辑

public partial class Reader : IAggregateRoot

```
{
```
```
    public void Borrow(Book book)
```
```
    {
```
```
        if (book.Lent)
```

            throw new InvalidOperationException("The book has been lent.");

        Registration reg = new Registration();

        reg.RegistrationStatus = RegistrationStatus.Normal;

```
        reg.Book = book;
```
```
        reg.Date = DateTime.Now;
```

        reg.DueDate = reg.Date.AddDays(90);

        reg.ReturnDate = DateTime.MaxValue;

```
        book.Registrations.Add(reg);
```
```
        book.Lent = true;
```
```
        this.Registrations.Add(reg);
```
```
    }
```
```
    public void Return(Book book)
```
```
    {
```
```
        if (!book.Lent)
```

            throw new InvalidOperationException("The book has not been lent.");

        var q = from r in this.Registrations

                where r.Book.Id.Equals(book.Id) &&

                r.RegistrationStatus == RegistrationStatus.Normal

```
                select r;
```
```
        if (q.Count() > 0)
```
```
        {
```
```
            var reg = q.First();
```
```
            if (reg.Expired)
```
```
            {
```

                // TODO: Reader should pay for the expiration.

```
            }
```

            reg.ReturnDate = DateTime.Now;

            reg.RegistrationStatus = RegistrationStatus.Returned;

```
            book.Lent = false;
```
```
        }
```
```
        else
```

            throw new InvalidOperationException(string.Format("Reader {0} didn't borrow this book.",

```
                this.Name));
```
```
    }
```
```
}
```

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