Abp vNext 基础篇丨领域构建

我们将通过例⼦介绍和解释⼀些显式规则。在实现领域驱动设计时,应该遵循这些规则并将其应⽤到解决⽅案中。

领域划分

首先我们先对比下Blog.Core和本次重构设计上的偏差,可以看到多了一个博客管理和类别管理。

业务脑图

根据上面得到的业务脑图我们可以看到包含Blog(博客),Post(文章),Comment(评论),Tag(标签),User(用户),根据脑图画出领域图来指明关系。

领域图

领域图连接地址:https://www.processon.com/view/link/611365c00e3e7407d39727ee

聚合根最佳实践 只通过ID引⽤其他聚合

⼀个聚合应该只通过其他聚合的ID引⽤聚合,这意味着你不能添加导航属性到其他聚合。

这条规则使得实现可序列化原则得以实现。

可以防⽌不同聚合相互操作,以及将聚合的业务逻辑泄露给另⼀个聚合。

来看下面的2个聚合根 Blog 和 Post.

Blog 没有包含 Post集合,因为他们是不同聚合

Post 使用 BlogId 关联 Blog

当你有一个 Post 需要关联 Blog的时候 你可以从数据库通过 BlogId 进行获取

public class Blog:FullAuditedAggregateRoot<Guid> { [NotNull] public virtual string Name { get; set; } [NotNull] public virtual string ShortName { get; set; } [CanBeNull] public virtual string Description { get; set; } } public class Post : FullAuditedAggregateRoot<Guid> { public virtual Guid BlogId { get; protected set; } [NotNull] public virtual string Url { get; protected set; } [NotNull] public virtual string CoverImage { get; set; } [NotNull] public virtual string Title { get; protected set; } [CanBeNull] public virtual string Content { get; set; } [CanBeNull] public virtual string Description { get; set; } public virtual int ReadCount { get; protected set; } public virtual Collection<PostTag> Tags { get; protected set; } } 聚合根/实体中的主键

⼀个聚合根通常有⼀个ID属性作为其标识符(主键,Primark Key: PK)。推荐使⽤ Guid 作为聚合,聚合中的实体(不是聚合根)可以使⽤复合主键(后面讲),主键ABP已经帮我们做好了参阅文档:https://docs.abp.io/en/abp/latest/Entities。

public class Blog:FullAuditedAggregateRoot<Guid> { [NotNull] public virtual string Name { get; set; } [NotNull] public virtual string ShortName { get; set; } [CanBeNull] public virtual string Description { get; set; } } 聚合根/实体构造函数

构造函数是实体的⽣命周期开始的地⽅。⼀个设计良好的构造函数,担负以下职责:

获取所需的实体属性参数,来创建⼀个有效的实体。应该强制只传递必要的参数,并可以将⾮必要 的属性作为可选参数。

检查参数的有效性。

初始化⼦集合。

public Blog(Guid id, [NotNull] string name, [NotNull] string shortName) { //属性赋值 Id = id; //有效性检测 Name = Check.NotNullOrWhiteSpace(name, nameof(name)); //有效性检测 ShortName = Check.NotNullOrWhiteSpace(shortName, nameof(shortName)); }

Blog 类通过构造函数参数、获得属性所需的值,以此创建一个正确有效的实体

在构造函数中验证输⼊参数的有效性,⽐如: Check.NotNullOrWhiteSpace(...) 当传递的值为空 时,抛出异常 ArgumentException

构造函数将参数 id 传递给 base 类,不在构造函数中⽣成 Guid,可以将其委托给另⼀个 Guid⽣成 服务,作为参数传递进来

⽆参构造函数对于ORM是必要的。我们将其设置为私有,以防⽌在代码中意外地使⽤它

实体属性访问器和⽅法

上⾯的示例代码,看起来可能很奇怪。⽐如:在构造函数中,我们强制传递⼀个不为 null 的 Name 。 但是,我们可以将 Name 属性设置为 null ,⽽对其没有进⾏任何有效性控制。

如果我们⽤ public 设置器声明所有的属性,就像上⾯的 Blog 类中的属性例⼦,我们就不能在实体的⽣命周期中强制保持其有效性和完整性。所以:

当需要在设置属性时,执⾏任何逻辑,请将属性设置为私有 private 。

定义公共⽅法来操作这些属性。

public class Blog:FullAuditedAggregateRoot<Guid> { [NotNull] public virtual string Name { get; protected set; } [NotNull] public virtual string ShortName { get; protected set; } [CanBeNull] public virtual string Description { get; set; } protected Blog() { /*反序列化或ORM 需要*/ } public Blog(Guid id, [NotNull] string name, [NotNull] string shortName) { //属性赋值 Id = id; //有效性检测 Name = Check.NotNullOrWhiteSpace(name, nameof(name)); //有效性检测 ShortName = Check.NotNullOrWhiteSpace(shortName, nameof(shortName)); } public virtual Blog SetName([NotNull] string name) { Name = Check.NotNullOrWhiteSpace(name, nameof(name)); return this; } public virtual Blog SetShortName(string shortName) { ShortName = Check.NotNullOrWhiteSpace(shortName, nameof(shortName)); return this; } } 业务逻辑和实体中的异常处理

当你在实体中进⾏验证和实现业务逻辑,经常需要管理异常:

创建特定领域异常。

必要时在实体⽅法中抛出这些异常

ABP框架 Exception Handing 系统处理了这些问题。

完成聚合的实体创建

根据 最佳实践的讲解完成,把其他实体创建出来,代码粘在这里了。

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/zwzzxy.html