[ABP教程]第六章 作者：领域层

合集 - 测试1(73)

1.windwos terminal 主题美化 包括WSL和其他终端命令行2023-03-122.win11+cuda11.2+cudnn+Tensorflow-GPU 环境配置2022-10-223.win11+wls2+ubuntu2004配置cuda+cudnn+pytorch2022-10-144.xshell7 无法打开 提示"要继续使用此程序,您必须应用最新的更新或使用新版本" 解决方案2022-10-085.wls2 ubuntu22 kind k8s 配置记录2022-09-126.wsl2安装与配置2022-09-117.PVE UPS NUT配置 自动关机2022-07-318.centos-stream-9 centos9 配置国内源 阿里云源2022-04-209.群晖gitlab备份迁移2022-01-2810.国内网站recaptcha无法使用的解决办法2022-01-0611.[每日小技巧] vscode配置vue项目基础2021-11-0912.Windows11 AirPods /AirPods Pro 声音小解决方案2021-10-2413.windows端口占用快速查询解决方法2021-05-1414.解决github无法连接错误 OpenSSL SSL_connect: Connection was reset in connection to github.com:4432021-03-1715.[ABP教程]第七章 作者:数据库集成2020-12-24

16.[ABP教程]第六章 作者：领域层2020-12-24

17.[ABP教程]第五章 授权2020-12-2418.[ABP教程]第四章 集成测试2020-12-2419.[ABP教程]第三章 创建、更新和删除图书2020-12-2420.[ABP教程]第二章 图书列表页面2020-12-2421.[ABP教程]第一章 创建服务端2020-12-2422.[Skill] git下载助手2020-12-2323.[Abp]Abp 新手入门随记2020-12-2024.[Skill] 记一次vue项目热更新失败案例2020-12-1525.[Skill]加速npm与yarn还原2020-11-2226.解决黑群晖"抱歉，您所指定的页面不存在"-记一次黑群晖修复案例2020-09-1527.如何下载youtube的视频？2020-09-1328.[新手教程]申请https泛域名解析2020-09-0729.docker frps 内网穿透容器化服务2020-09-0230.docker nginx 自定义配置容器2020-09-0231.asp.net core 学习笔记2020-07-0932.gitlab git仓库地址修改后更新方法2020-05-3133.树莓派(4B)新手入门教程2020-05-3034.Docker-MsSqlServer和安装版本异同2020-04-1135.Win Task 任务管理器 批量杀进程方法2020-04-0936.Win Docker 安装C盘清理方法之一2020-04-0337.中移动ipv6-老毛子固件获取ipv6设置2020-03-2038.win7-win10 禁用IPV6临时地址2020-03-2039.辅助调用函数【call,apply,bind】2020-02-2740.Unraid修改docker镜像地址&默认启动2020-02-2641.docker基本入门知识-小白向2020-02-2642.[不止于代码]Unraid基本使用速记2020-02-2643.Dockerfile文件说明2020-01-1944.Git之pull,fetch差别2019-08-2645.ES6+Webpack+Babel基本环境搭建2019-08-2646.抽象类和接口的异同及实例解析2018-11-2247.KVM与OpenVZ架构的区别2018-08-0248.关闭win10 defender的方法集锦2018-07-1949.ChromeDriver与Chrome版本对应表2018-05-2850.Hexo-Next-多地同步丢失解决(WARN No layout: index.html)2018-04-2651.修改vs模板添加版权注释信息2018-03-2752.Easyui中form表单验证事件不通过处理方法2018-03-2753.最简化版本-Centos7 配置.Net Core 及Jexus服务器2018-03-1254.常用开发中使用到的作图工具(开发向)2018-02-2555.Git 常用指令备注2018-01-3156.记一次 未能加载文件或程序集“”或它的某一个依赖项。试图加载格式不正确的程序 错误解决方案2018-01-3157.截图工具小结2018-01-2958.更优雅的处理数据-linqjs2018-01-2959.解决未安装Sql Server 配置数据库别名2018-01-2860.windows添加右键菜单-此处运行CMD2018-01-2461.记一次微信开发安卓访问阿里云服务器慢处理方案2018-01-1362.Hexo发布到Github丢失readme和CNAME解决方案2018-01-1163.Git之别名配置2018-01-0864.Github博客多地同步文章2018-01-0765.Github博客 自定义域名2018-01-0766.Github 搭建个人博客2018-01-0467.(转载)开源许可证教程2018-01-0268.小米路由mini刷 改华硕[N14U N54U]5G 2G的7620老毛子Padavan固件(私人云储存 aria2 QOS)2017-12-3169.小米路由mini刷不死breed2017-12-3170.小米路由mini开启ssh2017-12-3171.比特币是什么？2017-12-2172.IIS发布网站出现拒绝访问的错误分析2017-11-0773.公众平台服务号、订阅号、企业微信、小程序的相关说明2017-11-07

收起

Web开发教程6 作者：领域层

关于此教程#

在这个教程系列中，你将要构建一个基于ABP框架的应用程序 Acme.BookStore。这个应用程序被用于甘丽图书页面机器作者。它将用以下开发技术：

• Entity Framework Core 作为数据提供器
• MVC / Razor Pages 作为UI框架

这个教程全部由下面几个部分构成：

• 第一章：创建服务端
• 第二章：构建书籍列表页面
• 第三章：增删改图书
• 第四章：集成测试
• 第五章：授权
• 第六章：领域层（本教程）
• 第七章：数据库集成
• 第八章：应用层
• 第九章：用户接口
• 第十章：预定作者关系

下载源码#

教程根据您的UI和数据库首选项有多个版本。我们准备了一些可供下载的源码组合：

• MVC(Razor Pages)界面和EFCore版本
• Blazor和EF Core版本
• Angular和MongoDB版本

导论#

上一教程中，我们使用ABP框架很容易的构建了一些服务：

• 使用CrudAppService 基类替代基础的方法实现，而不是按部就班的创建、读取、更新和删除操作。
• 使用通用的仓储自动化实现数据访问层

对于”作者“部分：

• 我们将手动执行某些操作，以显示需要的时候是如何执行的操作
• 我们将实现一些DDD的最佳实践

作者实体#

在*.BookStore.Domain 项目中创建一个 Authors 文件夹 ，并添加添加类Author：

Copy
using System;
using JetBrains.Annotations;
using Volo.Abp;
using Volo.Abp.Domain.Entities.Auditing;

namespace Acme.BookStore.Authors
{
    public class Author : FullAuditedAggregateRoot<Guid>
    {
        public string Name { get; private set; }
        public DateTime BirthDate { get; set; }
        public string ShortBio { get; set; }

        private Author()
        {
            /* This constructor is for deserialization / ORM purpose */
        }

        internal Author(
            Guid id,
            [NotNull] string name,
            DateTime birthDate,
            [CanBeNull] string shortBio = null)
            : base(id)
        {
            SetName(name);
            BirthDate = birthDate;
            ShortBio = shortBio;
        }

        internal Author ChangeName([NotNull] string name)
        {
            SetName(name);
            return this;
        }

        private void SetName([NotNull] string name)
        {
            Name = Check.NotNullOrWhiteSpace(
                name, 
                nameof(name), 
                maxLength: AuthorConsts.MaxNameLength
            );
        }
    }
}

• 继承自 FullAuditedAggregateaRoot,能够实现实体软删除（标记删除）等审计属性
• Name属性私有设置保证了无法从外部类修改。这有两个方法设置name名称
  • 在构造函数中
  • 使用方法ChangeName
• 构造方法和ChangeName方法标记为 internal 内部的，用于强制限制在此域AuthorManager中使用。
• Check类是ABP框架中的工具类，用于检查方法参数(若检查不过将抛错 ArgumentException)

AuthorConsts是一个简单类，位于项目.BookStore.Domain.Shared命名空间Authors 下 ：

Copy
namespace Acme.BookStore.Authors
{
    public static class AuthorConsts
    {
        public const int MaxNameLength = 64;
    }
}

创建此类将被DTOs（Data Transfer Object） 复用

AuthorManager : 领域服务#

Author类构造函数和ChangeName 方法是 internal 类型，所以只能被此域中使用。

在Author文件夹中创建类AuthorManager ，并参考下方实现：

Copy
using System;
using System.Threading.Tasks;
using JetBrains.Annotations;
using Volo.Abp;
using Volo.Abp.Domain.Services;

namespace Acme.BookStore.Authors
{
    public class AuthorManager : DomainService
    {
        private readonly IAuthorRepository _authorRepository;

        public AuthorManager(IAuthorRepository authorRepository)
        {
            _authorRepository = authorRepository;
        }

        public async Task<Author> CreateAsync(
            [NotNull] string name,
            DateTime birthDate,
            [CanBeNull] string shortBio = null)
        {
            Check.NotNullOrWhiteSpace(name, nameof(name));

            var existingAuthor = await _authorRepository.FindByNameAsync(name);
            if (existingAuthor != null)
            {
                throw new AuthorAlreadyExistsException(name);
            }

            return new Author(
                GuidGenerator.Create(),
                name,
                birthDate,
                shortBio
            );
        }

        public async Task ChangeNameAsync(
            [NotNull] Author author,
            [NotNull] string newName)
        {
            Check.NotNull(author, nameof(author));
            Check.NotNullOrWhiteSpace(newName, nameof(newName));

            var existingAuthor = await _authorRepository.FindByNameAsync(newName);
            if (existingAuthor != null && existingAuthor.Id != author.Id)
            {
                throw new AuthorAlreadyExistsException(newName);
            }

            author.ChangeName(newName);
        }
    }
}

AuthorManger 强制创建作者并以受控方式更改作者的名称，应用程序层后续将使用这些方法。

DDD小贴士： 不要引入域服务方法，除非确实要它们并执行一些核心业务规则。对于这种情况，我们需要此服务能后强制唯一名称的约束。

两种方法都是检查是否存在具有给定名称的作者，并引发一个特俗的业务异常**AuthorAlreadyExistsException ** ，该错误位于项目*.BookStore.Domain中，如下所示：

Copy
using Volo.Abp;

namespace Acme.BookStore.Authors
{
    public class AuthorAlreadyExistsException : BusinessException
    {
        public AuthorAlreadyExistsException(string name)
            : base(BookStoreDomainErrorCodes.AuthorAlreadyExists)
        {
            WithData("name", name);
        }
    }
}

BussinessException 是一个特殊的错误类型。在需要时抛出与域相关的异常是一个好习惯。它将由ABP框架自动处理，并且可以轻松地进行本地化。WithData(...) 方法用于向异常对象提供其他数据，这些数据以后将在本地化消息上使用或用于其他目的。

在项目*.BookStore.Domain.Shared中打开 BookStoreDomainErrorCodes,并作如下的更改：

Copy
namespace Acme.BookStore
{
    public static class BookStoreDomainErrorCodes
    {
        public const string AuthorAlreadyExists = "BookStore:00001";
    }
}

这有个唯一的字符串，用于表示您的应用程序引发的错误代码，并且可由客户端应用程序处理。对于用户，您可能想对其进行本地化。打开*.BookStore.Domain.Shared项目内的 Localization/BootStore/en.json 并添加以下条目：(译者：中文 zh.json中也需要添加)

Copy
"BookStore:00001": "There is already an author with the same name: {name}"

每当您抛出AuthorAlreadyExistsException 时，最终用户将在UI看到此消息。

IAuthorRepository#

AuthorManager 注入了IAuthorRepository ,所以我们需要对其定义。在Authors文件夹下创建这个新的接口：

Copy
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Volo.Abp.Domain.Repositories;

namespace Acme.BookStore.Authors
{
    public interface IAuthorRepository : IRepository<Author, Guid>
    {
        Task<Author> FindByNameAsync(string name);

        Task<List<Author>> GetListAsync(
            int skipCount,
            int maxResultCount,
            string sorting,
            string filter = null
        );
    }
}

• IAuthorRepository扩展自标准的IRepository<Author,Guid> 接口，因此所有标准的仓储方法也可以用于 IAuthorRepository。
• AuthorManager中使用FindByNameAsync 通过名称查询作者。
• GetListAsync将在应用层中使用，以获取排序、筛选后的作者列表，以显示在UI中。

我们将在下一部分中现实此仓储

由于标准仓储中已经是IQueryable,因此这两种方法似乎都是必要的，您可以直接使用他们，而不必定义此类自定义的方法。您说对了，就像在实际应用中一样。但是，对于学习本教程，很有必要解释如何在真正需要的时候创建自定义的仓储方法。

总结#

这部分涵盖了书店应用程序作者功能的领域层。主要文件如下：