ABP入门系列目录——学习Abp框架之实操演练

1. 解释下应用服务层

应用服务用于将领域(业务)逻辑暴露给展现层。展现层通过传入DTO(数据传输对象)参数来调用应用服务，而应用服务通过领域对象来执行相应的业务逻辑并且将DTO返回给展现层。因此，展现层和领域层将被完全隔离开来。
以下几点，在创建应用服务时需要注意：

  1. 在ABP中，一个应用服务需要实现IApplicationService接口，最好的实践是针对每个应用服务都创建相应继承自IApplicationService的接口。（通过继承该接口，ABP会自动帮助依赖注入）
  2. ABP为IApplicationService提供了默认的实现ApplicationService，该基类提供了方便的日志记录和本地化功能。实现应用服务的时候继承自ApplicationService并实现定义的接口即可。
  3. ABP中，一个应用服务方法默认是一个工作单元（Unit of Work）。ABP针对UOW模式自动进行数据库的连接及事务管理，且会自动保存数据修改。

2. 定义ITaskAppService接口

2.1. 先来看看定义的接口

    public interface ITaskAppService : IApplicationService{GetTasksOutput GetTasks(GetTasksInput input);void UpdateTask(UpdateTaskInput input);int CreateTask(CreateTaskInput input);Task<TaskDto> GetTaskByIdAsync(int taskId);TaskDto GetTaskById(int taskId);void DeleteTask(int taskId);IList<TaskDto> GetAllTasks();}

观察方法的参数及返回值，大家可能会发现并未直接使用Task实体对象。这是为什么呢？因为展现层与应用服务层是通过Data Transfer Object（DTO）进行数据传输。

2.2. 为什么需要通过dto进行数据传输？

总结来说，使用DTO进行数据传输具有以下好处。

  • 数据隐藏
  • 序列化和延迟加载问题
  • ABP对DTO提供了约定类以支持验证
  • 参数或返回值改变，通过Dto方便扩展

了解更多详情请参考：
ABP框架 - 数据传输对象

2.3. Dto规范 （灵活应用）

  • ABP建议命名输入/输出参数为：MethodNameInput和MethodNameOutput
  • 并为每个应用服务方法定义单独的输入和输出DTO（如果为每个方法的输入输出都定义一个dto，那将有一个庞大的dto类需要定义维护。一般通过定义一个公用的dto进行共用）
  • 即使你的方法只接受/返回一个参数，也最好是创建一个DTO类
  • 一般会在对应实体的应用服务文件夹下新建Dtos文件夹来管理Dto类。

3. 定义应用服务接口需要用到的DTO

3.1. 先来看看TaskDto的定义

namespace LearningMpaAbp.Tasks.Dtos
{/// <summary>/// A DTO class that can be used in various application service methods when needed to send/receive Task objects./// </summary>public class TaskDto : EntityDto{public long? AssignedPersonId { get; set; }public string AssignedPersonName { get; set; }public string Title { get; set; }public string Description { get; set; }public DateTime CreationTime { get; set; }public TaskState State { get; set; }//This method is just used by the Console Application to list taskspublic override string ToString(){return string.Format("[Task Id={0}, Description={1}, CreationTime={2}, AssignedPersonName={3}, State={4}]",Id,Description,CreationTime,AssignedPersonId,(TaskState)State);}}
}

该TaskDto直接继承自EntityDto，EntityDto是一个通用的实体只定义Id属性的简单类。直接定义一个TaskDto的目的是为了在多个应用服务方法中共用。

3.2. 下面来看看GetTasksOutput的定义

就是直接共用了TaskDto。

public class GetTasksOutput{public List<TaskDto> Tasks { get; set; }}

3.3. 再来看看CreateTaskInput、UpdateTaskInput

  public class CreateTaskInput{public int? AssignedPersonId { get; set; }[Required]public string Description { get; set; }[Required]public string Title { get; set; }public TaskState State { get; set; }public override string ToString(){return string.Format("[CreateTaskInput > AssignedPersonId = {0}, Description = {1}]", AssignedPersonId, Description);}}

  /// <summary>/// This DTO class is used to send needed data to <see cref="ITaskAppService.UpdateTask"/> method./// /// Implements <see cref="ICustomValidate"/> for additional custom validation./// </summary>public class UpdateTaskInput : ICustomValidate{[Range(1, Int32.MaxValue)] //Data annotation attributes work as expected.public int Id { get; set; }public int? AssignedPersonId { get; set; }public TaskState? State { get; set; }[Required]public string Title { get; set; }[Required]public string Description { get; set; }//Custom validation method. It's called by ABP after data annotation validations.public void AddValidationErrors(CustomValidationContext context){if (AssignedPersonId == null && State == null){context.Results.Add(new ValidationResult("Both of AssignedPersonId and State can not be null in order to update a Task!", new[] { "AssignedPersonId", "State" }));}}public override string ToString(){return string.Format("[UpdateTaskInput > TaskId = {0}, AssignedPersonId = {1}, State = {2}]", Id, AssignedPersonId, State);}}

其中UpdateTaskInput实现了ICustomValidate接口，来实现自定义验证。了解DTO验证可参考 ABP框架 - 验证数据传输对象

3.4. 最后来看一下GetTasksInput的定义

其中包括两个属性用来进行过滤。

  public class GetTasksInput{public TaskState? State { get; set; }public int? AssignedPersonId { get; set; }}

定义完DTO，是不是脑袋有个疑问，我在用DTO在展现层与应用服务层进行数据传输，但最终这些DTO都需要转换为实体才能与数据库直接打交道啊。如果每个dto都要自己手动去转换成对应实体，这个工作量也是不可小觑啊。
聪明如你，你肯定会想肯定有什么方法来减少这个工作量。

4.使用AutoMapper自动映射DTO与实体

4.1. 简要介绍AutoMapper

开始之前，如果对AutoMapper不是很了解，建议看下这篇文章AutoMapper小结。

AutoMapper的使用步骤，简单总结下：

  • 创建映射规则（Mapper.CreateMap<source, destination>();）
  • 类型映射转换（Mapper.Map<source,destination>(sourceModel)）

在Abp中有两种方式创建映射规则：

  • 特性数据注解方式：

    • AutoMapFrom、AutoMapTo 特性创建单向映射
    • AutoMap 特性创建双向映射
  • 代码创建映射规则：
    • Mapper.CreateMap<source, destination>();

4.2. 为Task实体相关的Dto定义映射规则

4.2.1.为CreateTasksInput、UpdateTaskInput定义映射规则

CreateTasksInput、UpdateTaskInput中的属性名与Task实体的属性命名一致，且只需要从Dto映射到实体，不需要反向映射。所以通过AutoMapTo创建单向映射即可。

    [AutoMapTo(typeof(Task))] //定义单向映射public class CreateTaskInput{...}[AutoMapTo(typeof(Task))] //定义单向映射public class UpdateTaskInput{...}

4.2.2. 为TaskDto定义映射规则

TaskDto与Task实体的属性中，有一个属性名不匹配。TaskDto中的AssignedPersonName属性对应的是Task实体中的AssignedPerson.FullName属性。针对这一属性映射，AutoMapper没有这么智能需要我们告诉它怎么做；

 var taskDtoMapper = mapperConfig.CreateMap<Task, TaskDto>();taskDtoMapper.ForMember(dto => dto.AssignedPersonName, map => map.MapFrom(m => m.AssignedPerson.FullName));

为TaskDto与Task创建完自定义映射规则后，我们需要思考，这段代码该放在什么地方呢？

5. 创建统一入口注册AutoMapper映射规则

如果在映射规则既有通过特性方式又有通过代码方式创建，这时就会容易混乱不便维护。
为了解决这个问题，统一采用代码创建映射规则的方式。并通过IOC容器注册所有的映射规则类，再循环调用注册方法。

5.1. 定义抽象接口IDtoMapping

应用服务层根目录创建IDtoMapping接口，定义CreateMapping方法由映射规则类实现。

namespace LearningMpaAbp
{/// <summary>///     实现该接口以进行映射规则创建/// </summary>internal interface IDtoMapping{void CreateMapping(IMapperConfigurationExpression mapperConfig);}
}

5.2. 为Task实体相关Dto创建映射类

namespace LearningMpaAbp.Tasks
{public class TaskDtoMapping : IDtoMapping{public void CreateMapping(IMapperConfigurationExpression mapperConfig){//定义单向映射mapperConfig.CreateMap<CreateTaskInput, Task>();mapperConfig.CreateMap<UpdateTaskInput, Task>();mapperConfig.CreateMap<TaskDto, UpdateTaskInput>();//自定义映射var taskDtoMapper = mapperConfig.CreateMap<Task, TaskDto>();taskDtoMapper.ForMember(dto => dto.AssignedPersonName, map => map.MapFrom(m => m.AssignedPerson.FullName));}}
}

5.3. 注册IDtoMapping依赖

在应用服务的模块中对IDtoMapping进行依赖注册，并解析以进行映射规则创建。

namespace LearningMpaAbp
{[DependsOn(typeof(LearningMpaAbpCoreModule), typeof(AbpAutoMapperModule))]public class LearningMpaAbpApplicationModule : AbpModule{public override void PreInitialize(){Configuration.Modules.AbpAutoMapper().Configurators.Add(mapper =>{//Add your custom AutoMapper mappings here...});}public override void Initialize(){           IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());//注册IDtoMappingIocManager.IocContainer.Register(Classes.FromAssembly(Assembly.GetExecutingAssembly()).IncludeNonPublicTypes().BasedOn<IDtoMapping>().WithService.Self().WithService.DefaultInterfaces().LifestyleTransient());//解析依赖，并进行映射规则创建Configuration.Modules.AbpAutoMapper().Configurators.Add(mapper =>{var mappers = IocManager.IocContainer.ResolveAll<IDtoMapping>();foreach (var dtomap in mappers)dtomap.CreateMapping(mapper);});}}
}

通过这种方式，我们只需要实现IDtoMappting进行映射规则定义。创建映射规则的动作就交给模块吧。

6. 万事俱备，实现ITaskAppService

认真读完以上内容，那么到这一步，就很简单了，业务只是简单的增删该查，实现起来就很简单了。可以自己尝试自行实现，再参考代码：

namespace LearningMpaAbp.Tasks
{/// <summary>/// Implements <see cref="ITaskAppService"/> to perform task related application functionality./// /// Inherits from <see cref="ApplicationService"/>./// <see cref="ApplicationService"/> contains some basic functionality common for application services (such as logging and localization)./// </summary>public class TaskAppService : LearningMpaAbpAppServiceBase, ITaskAppService{//These members set in constructor using constructor injection.private readonly IRepository<Task> _taskRepository;/// <summary>///In constructor, we can get needed classes/interfaces.///They are sent here by dependency injection system automatically./// </summary>public TaskAppService(IRepository<Task> taskRepository,){_taskRepository = taskRepository;}public GetTasksOutput GetTasks(GetTasksInput input){var query = _taskRepository.GetAll();if (input.AssignedPersonId.HasValue){query = query.Where(t => t.AssignedPersonId == input.AssignedPersonId.Value);}if (input.State.HasValue){query = query.Where(t => t.State == input.State.Value);}//Used AutoMapper to automatically convert List<Task> to List<TaskDto>.return new GetTasksOutput{Tasks = Mapper.Map<List<TaskDto>>(query.ToList())};}public async Task<TaskDto> GetTaskByIdAsync(int taskId){//Called specific GetAllWithPeople method of task repository.var task = await _taskRepository.GetAsync(taskId);//Used AutoMapper to automatically convert List<Task> to List<TaskDto>.return task.MapTo<TaskDto>();}public TaskDto GetTaskById(int taskId){var task = _taskRepository.Get(taskId);return task.MapTo<TaskDto>();}public void UpdateTask(UpdateTaskInput input){//We can use Logger, it's defined in ApplicationService base class.Logger.Info("Updating a task for input: " + input);//Retrieving a task entity with given id using standard Get method of repositories.var task = _taskRepository.Get(input.Id);//Updating changed properties of the retrieved task entity.if (input.State.HasValue){task.State = input.State.Value;}//We even do not call Update method of the repository.//Because an application service method is a 'unit of work' scope as default.//ABP automatically saves all changes when a 'unit of work' scope ends (without any exception).}public int CreateTask(CreateTaskInput input){//We can use Logger, it's defined in ApplicationService class.Logger.Info("Creating a task for input: " + input);//Creating a new Task entity with given input's propertiesvar task = new Task{Description = input.Description,Title = input.Title,State = input.State,CreationTime = Clock.Now};//Saving entity with standard Insert method of repositories.return _taskRepository.InsertAndGetId(task);}public void DeleteTask(int taskId){var task = _taskRepository.Get(taskId);if (task != null){_taskRepository.Delete(task);}}}
}

到此，此章节就告一段落。为了加深印象，请自行回答如下问题：

  1. 什么是应用服务层？
  2. 如何定义应用服务接口？
  3. 什么DTO，如何定义DTO？
  4. DTO如何与实体进行自动映射？
  5. 如何对映射规则统一创建？

源码已上传至Github-LearningMpaAbp，可自行参考。

作者：圣杰
链接：https://www.jianshu.com/p/da69ca7b27c6
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

ABP入门系列（4）——创建应用服务相关推荐

  1. ABP入门系列（7）——分页实现

    ABP入门系列目录--学习Abp框架之实操演练 完成了任务清单的增删改查,咱们来讲一讲必不可少的的分页功能. 首先很庆幸ABP已经帮我们封装了分页实现,实在是贴心啊. 来来来,这一节咱们就来捋一捋如何 ...

  2. ABP入门系列（5）——展现层实现增删改查

    ABP入门系列目录--学习Abp框架之实操演练 源码路径:Github-LearningMpaAbp 这一章节将通过完善Controller.View.ViewModel,来实现展现层的增删改查.最终 ...

  3. ABP入门系列（7）——分页实现_0

    ABP入门系列目录--学习Abp框架之实操演练 完成了任务清单的增删改查,咱们来讲一讲必不可少的的分页功能. 首先很庆幸ABP已经帮我们封装了分页实现,实在是贴心啊. 来来来,这一节咱们就来捋一捋如何 ...

  4. [置顶]ABP入门系列目录——学习Abp框架之实操演练

    本系列文章主要是基于ABP模板开发Mpa(多页面)『任务清单』项目. 由于是入门系列,不会用到代码生成器,每一行代码都是手动敲入. 源码已上传至Github-LearningMpaAbp,可自行参考. ...

  5. ABP入门系列（14）——应用BootstrapTable表格插件

    1. 引言 之前的文章ABP入门系列(7)--分页实现讲解了如何进行分页展示,但其分页展示仅适用于前台web分页,在后台管理系统中并不适用.后台管理系统中的数据展示一般都是使用一些表格插件来完成的.这 ...

  6. ABP入门系列（6）——定义导航菜单

    ABP入门系列目录--学习Abp框架之实操演练 源码路径:Github-LearningMpaAbp 完成了增删改查以及页面展示,这一节我们来为任务清单添加[导航菜单]. 在以往的项目中,大家可能会手 ...

  7. WF4.0入门系列1——创建一个简单的工作流

    WF4.0入门系列1--创建一个简单的工作流 打开VS2010,选择文件-新建-项目,选择Workflow项 工作流台应用程序,在名称处输入chapter01,选择合适的位置,这里默认,单击确定. V ...

  8. ABP入门系列（8）——Json格式化

    ABP入门系列目录--学习Abp框架之实操演练 源码路径:Github-LearningMpaAbp 讲完了分页功能,这一节我们先不急着实现新的功能.来简要介绍下Abp中Json的用法.为什么要在这一 ...

  9. abp.ajax get,ABP入门系列之Json格式化

    讲完了分页功能,这一节我们先不急着实现新的功能.来简要介绍下Abp中Json的用法.为什么要在这一节讲呢?当然是做铺垫啊,后面的系列文章会经常和Json这个东西打交道. 一.Json是干什么的 JSO ...

最新文章

  1. 2.5 数据不匹配时，偏差和方差的分析-深度学习第三课《结构化机器学习项目》-Stanford吴恩达教授
  2. java父类序列化_父类的序列化与 Transient 关键字
  3. RSPapers | 工业界推荐系统论文合集
  4. python数据字典排序_Python自动处理数据字典(Python是3.6版本)
  5. mysql insert 运算_MySql insert插入操作的3个小技巧分享
  6. uva 11991 - Easy Problem from Rujia Liu?(STL)
  7. 逆向常用命令android常用逆向命令
  8. Java JDK11的下载与安装
  9. jsonp 跨域 java_浅析 JSONP 跨域原理
  10. Battleship
  11. 伊利洛伊大学厄巴纳-香槟分校计算机专业,伊利诺伊大学厄巴纳香槟分校哪些专业比较好？...
  12. 【金猿人物展】龙盈智达首席数据科学家王彦博：量子科技为AI大数据创新发展注入新动能...
  13. matlab毕业答辩会问什么,论文答辩必备：自述模板和注意问题
  14. vue 设置滚动条的位置
  15. 如何通过引用传递变量？
  16. win7一直显示正在关机_win7系统一直卡在正在关机无法关机怎么解决
  17. 你从未见过的“地狱级”烂项目
  18. 写一个关机代码让别人的电脑根据你的指令关机，c语言写小程序恶搞别人
  19. Mysql数据库基本操作（八-2）窗口函数
  20. 【IoT案例征集文章】60 万年薪招聘物联网工程师！此专业要火！

热门文章

  1. Lesson 028 —— python 模块
  2. Linux实战案例（2）实例讲解使用软连接的场景和过程
  3. Objective-C浮点数转化整数（向上取整、向下取整）
  4. 10个让人很舒服的沟通技巧
  5. Android学习（二十）Notification通知栏
  6. 【iOS】Quartz2D图片剪切
  7. 简明Python3教程 16.标准库
  8. [密码学基础][每个信息安全博士生应该知道的52件事][Bristol Cryptography][第22篇]如何用蒙哥马利算法表示一个数字和多个相乘的数字
  9. [剑指offer][JAVA]面试题第[46]题[把数字翻译成字符串][递归][逆推]
  10. [剑指offer][JAVA][面试题第13题][机器人的运动][DFS][BFS]