• 基于ABP实现DDD--领域服务、应用服务和DTO实践


    什么是领域服务呢?领域服务就是领域对象本身的服务,通常是通过多个聚合以实现单个聚合无法处理的逻辑。

    一.领域服务实践

    接下来将聚合根Issue中的AssignToAsync()方法[将问题分配给用户],剥离到领域服务当中。如下:

    1. // ABP当中的领域服务类通常都是以Manager结尾的
    2. public class IssueManager : DomainService
    3. {
    4. private readonly IRepository _issueRepository;
    5. // 在构造函数中注入需要的仓储
    6. public IssueManager(IRepository issueRepository)
    7. {
    8. _issueRepository = issueRepository;
    9. }
    10. public async Task AssignToAsync(Issue issue, AppUser user)
    11. {
    12. // 通过仓储获取分配给该用户的,并且没有关闭的Issue的数量
    13. var openIssueCount = await _issueRepository.CountAsync(i => i.AssignedUserId == user.id && !i.IsClosed);
    14. // 如果超过3个,那么抛出异常
    15. if (openIssueCount > 3)
    16. {
    17. throw new BusinessException("IssueTracking:ConcurrentOpenIssueLimit");
    18. }
    19. issue.AssignedUserId = user.Id;
    20. }
    21. }

    需要说明的是通常不需要为领域服务IssueManager在创建一个接口IIssueManager。

    二.应用服务实践

    应用服务的输入和输出通常都是DTO,其中的难点是区分领域逻辑和应用逻辑,即哪些服务放在领域层实现,哪些服务放在应用层来实现。

    1. namespace IssueTracking.Issues
    2. {
    3. public class IssueAppService :ApplicationService.IIssueAppService
    4. {
    5. private readonly IssueManager _issueManager;
    6. private readonly IRepository _issueRepository;
    7. private readonly IRepository _userRepository;
    8. public IssueAppService(
    9. IssueManager issueManager,
    10. IRepository issueRepository,
    11. IRepository userRepository
    12. )
    13. {
    14. _issueManager=issueManager;
    15. _issueRepository=issueRepository;
    16. _userRepository=userRepository;
    17. }
    18. [Authorize]
    19. public async Task AssignAsync(IssueAssignDto input)
    20. {
    21. var issue=await _issueRepository.GetAsync(input.IssueId);
    22. var user=await _userRepository.GetAsync(inpu.UserId);
    23. await _issueManager.AssignToAsync(issue,user);
    24. await _issueRepository.UpdateAsync(issue);
    25. }
    26. }
    27. }

    在上述代码中,为什么最后执行_issueRepository.UpdateAsync(issue)呢?其中有2层含义,第1层是Issue通过_issueManager.AssignToAsync(issue,user)发生了变化,需要进行更新操作(从下图可知Issue聚合根中包含AssignedUserId字段);第2层是EF Core中有状态变更跟踪,Update并不是必须的,但是还是建议显式调用Update,用来适配其它的数据库提供程序。

    三.数据传输对象DTO实践

    DTO的本质是在应用层和展示层传递状态数据,通常应用层的输入和输出都是DTO,这样做的最大好处就是不暴露实体的结构设计。

    1.输入DTO实践

    (1)不要重用输入DTO
    不使用的属性不要定义在输入DTO中;不要重用输入DTO有2种方式:一种方式是为每个应用服务方法定义特定的输入DTO,另一种方式是不要使用DTO继承。下面是错误的输入DTO实践,理由详见注释:

    1. public interface IUserAppService : IApplicationService
    2. {
    3. Task CreateAsync(UserDto input); //Id在该方法中没有用到
    4. Task UpdateAsync(UserDto input); // Password在该方法中没有用到
    5. Task ChangePasswordAsync(UserDto input); // CreationTime在该方法中没有用到
    6. }
    7. public class UserDto
    8. {
    9. public Guid Id { get; set; }
    10. public string UserName { get; set; }
    11. public string Email { get; set; }
    12. public string Password { get; set; }
    13. public DateTime CreateTime { get; set; }
    14. }

    下面是正确的输入DTO实践:

    1. public interface IUserAppService : IApplicationService
    2. {
    3. Task CreateAsync(UserCreationDto input);
    4. Task UpdateAsync(UserUpdateDto input);
    5. Task ChangePasswordAsync(UserChangePasswordDto input);
    6. }
    7. public class UserCreationDto
    8. {
    9. public string UserName { get; set; }
    10. public string Email { get; set; }
    11. public string Password { get; set; }
    12. }
    13. public class UserUpdateDto
    14. {
    15. public Guid Id { get; set; }
    16. public string UserName { get; set; }
    17. public string Email { get; set; }
    18. }
    19. public class UserChangePasswordDto
    20. {
    21. public Guid Id { get; set; }
    22. public string Password { get; set; }
    23. }

    (2)输入DTO中的验证逻辑
    主要是在DTO内部通过数据注解特性、FluentValidation,或者实现IValidatableObject接口等方式来执行简单的验证。需要注意的是不要在DTO中执行领域验证,比如检测用户名是否唯一的验证等。下面在输入DTO中使用数据注解特性:

    1. namespace IssueTracking.Users
    2. {
    3. public class UserCreationDto
    4. {
    5. [Required]
    6. [StringLength(UserConsts.MaxUserNameLength)]
    7. public string UserName {get;set;}
    8. [Required]
    9. [EmailAddress]
    10. [StringLength(UserConsts.MaxEmailLength)]
    11. public string Email{get;set;}
    12. [Required]
    13. [StringLength(UserConsts.MaxEmailLength,MinimumLength=UserConsts.MinPasswordLength)]
    14. public string Password{get;set;}
    15. }
    16. }

    ABP会自动验证输入DTO中的注解,如果验证失败,那么抛出AbpValidationException异常,并且返回400状态码。个人建议使用FluentValidation方式进行验证,而不是声明式的数据注解,这样做的优点是将验证规则和DTO类彻底分离开

    2.输出DTO实践

    输出DTO最佳实践:主要是尽可能的复用输出DTO,但是切记不能把输入DTO作为输出DTO;输出DTO可以包含更多的属性;Create和Update方法返回DTO。下面是错误的输出DTO实践:

    1. public interface IUserAppService:IApplicationService
    2. {
    3. UserDto Get(Guid id);
    4. List GetUserNameAndEmail(Guid id);
    5. List<string> GetRoles(Guid id);
    6. List GetList();
    7. UserCreateResultDto Create(UserCreationDto input);
    8. UserUpdateResultDto Update(UserUpdateDto input);
    9. }

    下面是正确的输出DTO实践:

    1. public interface IUserAppService:IApplicationService
    2. {
    3. UserDto Get(Guid id);
    4. List GetList();
    5. UserDto Create(UserCreationDto input);
    6. UserDto Update(UserUpdateDto input);
    7. }
    8. public class UserDto
    9. {
    10. public Guid Id{get;set;}
    11. public string UserName{get;set;}
    12. public string Email{get;set;}
    13. public DateTiem CreationTime{get;set;}
    14. public List<string> Roles{get;set;}
    15. }

    说明:删除GetUserNameAndEmail()和GetRoles()方法,因为它们与Get()方法重复了,即它们的功能都可以通过Get()方法来实现。

    3.对象映射工具

      为什么需要对象映射工具呢?由于实体和DTO具有相同或者相似的属性,如果手工处理实体和DTO间的转换,那么效率是非常低的,因此需要对象映射工具高效的完成实体和DTO间的转换。
      在ABP中使用的对象映射框架是AutoMapper,官方的建议是:仅对实体到输出DTO做自动对象映射,不建议输入DTO到实体做自动对象映射。因为DTO是实体的部分或者全部字段,自己推测前者是比较确定的,而由于复杂的业务规则让后者的映射充满了不确定性。具体为什么不使用输入DTO到实体做自动对象映射的原因参考[1]。
    自动对象映射在应用服务层中实现,该类需要继承自Profile类:


    虽然官方不建议输入DTO到实体做自动对象映射,但是在通常的实践中还是较多使用CreateOrUpdateXXXDto到实体XXX的自动对象映射:

  • 相关阅读:
    2022年最新阿里巴巴70道高级面试题,四面斩获阿里offer,直接定级为P7
    全部常用邮件端口25、109、110、143、465、995、993、994
    【Matlab笔记_15】正则表达式之特殊字符文本位置提取
    Real closed field
    二叉搜索树
    2022年上半年中国数字藏品(NFT)市场分析总结
    mysql用户管理和用户授权
    8.Haproxy 搭建Web集群
    【计算机网络笔记】Cookie技术
    分公司电脑访问总部服务器突然不通了走的是SSL隧道,如何排查处理?
  • 原文地址:https://blog.csdn.net/weixin_62710048/article/details/125908371