ABP创建应用服务
原文作者:圣杰
原文地址:ABP入门系列(4)——创建应用服务
在原文作者上进行改正,适配ABP新版本。内容相同
1. 解释下应用服务层
应用服务用于将领域(业务)逻辑暴露给展现层。展现层通过传入DTO(数据传输对象)参数来调用应用服务,而应用服务通过领域对象来执行相应的业务逻辑并且将DTO返回给展现层。因此,展现层和领域层将被完全隔离开来。
以下几点,在创建应用服务时需要注意:
- 在ABP中,一个应用服务需要实现
IApplicationService
接口,最好的实践是针对每个应用服务都创建相应继承自IApplicationService
的接口。(通过继承该接口,ABP会自动帮助依赖注入) - ABP为
IApplicationService
提供了默认的实现ApplicationService
,该基类提供了方便的日志记录和本地化功能。实现应用服务的时候继承自ApplicationService
并实现定义的接口即可。 - ABP中,一个应用服务方法默认是一个工作单元(Unit of Work)。ABP针对UOW模式自动进行数据库的连接及事务管理,且会自动保存数据修改。
2. 定义ITaskAppService接口
2.1. 先来看看定义的接口
将服务接口声明在xxxx.Application =》 Tasks =》Services目录下
using Abp.Application.Services;
using Coreqi.Tasks.Dtos;
using System;
using System.Collections.Generic;
using System.Text;
using System.Threading.Tasks; namespace Coreqi.Tasks.Services
{
public interface ITaskAppServic: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的定义
using Abp.Application.Services.Dto;
using System;
using System.Collections.Generic;
using System.Text; namespace Coreqi.Tasks.Dtos
{
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; } public 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
。
using System;
using System.Collections.Generic;
using System.Text; namespace Coreqi.Tasks.Dtos
{
public class GetTasksOutput
{
public List<TaskDto> Tasks { get; set; }
}
}
3.3. 再来看看CreateTaskInput、UpdateTaskInput
using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.Text; namespace Coreqi.Tasks.Dtos
{
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);
}
}
}
using Abp.Runtime.Validation;
using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.Text; namespace Coreqi.Tasks.Dtos
{
public class UpdateTaskInput: ICustomValidate
{
[Range(, 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的定义
其中包括两个属性用来进行过滤。
using System;
using System.Collections.Generic;
using System.Text; namespace Coreqi.Tasks.Dtos
{
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
应用服务层根目录(xxxx.Application)创建IDtoMapping
接口,定义CreateMapping
方法由映射规则类实现。
using AutoMapper;
using System;
using System.Collections.Generic;
using System.Text; namespace Coreqi
{
/// <summary>
/// 实现该接口以进行映射规则创建
/// </summary>
public interface IDtoMapping
{
void CreateMapping(IMapperConfigurationExpression mapperConfig);
}
}
5.2. 为Task实体相关Dto创建映射类
using System;
using System.Collections.Generic;
using System.Text;
using AutoMapper;
using Coreqi.Tasks;
using Coreqi.Tasks.Dtos; namespace Coreqi
{
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()); //注册IDtoMapping
IocManager.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 properties
var 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);
}
}
}
}
ABP创建应用服务的更多相关文章
- ABP入门系列(5)——创建应用服务
一.解释下应用服务层 应用服务用于将领域(业务)逻辑暴露给展现层.展现层通过传入DTO(数据传输对象)参数来调用应用服务,而应用服务通过领域对象来执行相应的业务逻辑并且将DTO返回给展现层.因此,展现 ...
- ABP入门系列(4)——创建应用服务
ABP入门系列目录--学习Abp框架之实操演练 一.解释下应用服务层 应用服务用于将领域(业务)逻辑暴露给展现层.展现层通过传入DTO(数据传输对象)参数来调用应用服务,而应用服务通过领域对象来执行相 ...
- abp(net core)+easyui+efcore仓储系统——创建应用服务(五)
abp(net core)+easyui+efcore仓储系统目录 abp(net core)+easyui+efcore仓储系统——ABP总体介绍(一) abp(net core)+easyui+e ...
- ABP入门教程8 - 应用层创建应用服务
点这里进入ABP入门教程目录 创建目录 在应用层(即JD.CRS.Application)下创建文件夹Course //用以存放Course相关应用服务 在JD.CRS.Application/Cou ...
- ABP(现代ASP.NET样板开发框架)系列之15、ABP应用层——应用服务(Application services)
点这里进入ABP系列文章总目录 基于DDD的现代ASP.NET开发框架--ABP系列之15.ABP应用层——应用服务(Application services) ABP是“ASP.NET Boiler ...
- ABP框架 - 应用服务
文档目录 本节内容: IApplicationService 接口 ApplicationService 类 CrudAppService 和 AsyncCrudAppService 类 简单的CRU ...
- ABP应用层——应用服务(Application services)
ABP应用层——应用服务(Application services) 点这里进入ABP系列文章总目录 基于DDD的现代ASP.NET开发框架--ABP系列之15.ABP应用层——应用服务(Applic ...
- ABP创建数据库操作步骤
1 ABP创建数据库操作步骤 1.1 SimpleTaskSystem.Web项目中的Web.config文件修改数据库配置. <add name="Default" pro ...
- C# ABP - 创建自己的模块
本篇文章介绍怎么创建自己的模块,并且使用依赖注入方法进行模块间的无缝结合. 我们创建一下自己的一个会员模块,针对不同的系统都可以用.你们可以看看我是怎么做的,或者从中得到启发. 目录 1.开始创建项目 ...
随机推荐
- 百度智能api接口汇总
一:自然语言处理 # -*- coding: utf-8 -*- # @Author : FELIX # @Date : 2018/5/18 9:47 # pip install baidu-aip ...
- 图像傅里叶变换(快速傅里叶变换FFT)
学习DIP第7天,图像傅里叶变换 转载请标明出处:http://blog.csdn.net/tonyshengtan,欢迎大家转载,发现博客被某些论坛转载后,图像无法正常显示,无法正常表达本人观点,对 ...
- python 正则相关函数全解析
前言:网上有很多关于python正则函数的方法说明,这里尽可能用最简单的demo把所有函数之间的逻辑关系说清楚,供参考. 1.最原始的 re.compile()这个函数一般是需要和其它函数一起使用的, ...
- 关于phoenix构建hbase视图,更新hbase表后,视图表是否更新的验证
1:创建表 create 'MY_TABLE', 'CF1','CF2' 2:在hbase上插入一条数据 put ' ,'CF1:V1', 'uwo1' 3:在phoenix上创建视图 create ...
- koa 项目实战(十一)验证登录和注册的 input
1.验证注册参数 根目录/validation/register.js const Validator = require('validator'); const isEmpty = require( ...
- laravel-5.6路由命名
1.第一种:通过route路由中的as关键字来实现 1 Route::get('api/user',['as'='web.user'],'messageController@userInformati ...
- Elasticsearch的安装入门
大纲: 一.简介 二.Logstash 三.Redis 四.Elasticsearch 五.Kinaba 一.简介 1.核心组成 ELK由Elasticsearch.Logstash和Kibana三部 ...
- 深度学习之NLP获取词向量
1.代码 def clean_text(text, remove_stopwords=False): """ 数据清洗 """ text = ...
- Selenium 2自动化测试实战37(自动发邮件功能)
自动发邮件功能 例如,如果想在自动化脚本运行完成之后,邮箱就可以收到最新的测试报告结果.SMTP(Simple Mail Transfer Protocol)是简单邮件传输协议,它是一组用于由源地址到 ...
- js手写数组Api--模拟实现常见数组Api
数组的API经常用,但是api的内部实现还没研究过,于是就研究学习了下. 原文地址: https://www.cnblogs.com/yalong/p/11606865.html 数组的API的具体使 ...