一、解释下应用服务层
应用服务用于将领域(业务)逻辑暴露给展现层。展现层通过传入DTO(数据传输对象)参数来调用应用服务,而应用服务通过领域对象来执行相应的业务逻辑并且将DTO返回给展现层。因此,展现层和领域层将被完全隔离开来。
以下几点,在创建应用服务时需要注意:
- 在ABP中,一个应用服务需要实现
IApplicationService
接口,最好的实践是针对每个应用服务都创建相应继承自IApplicationService
的接口。(通过继承该接口,ABP会自动帮助依赖注入) - ABP为
IApplicationService
提供了默认的实现ApplicationService
,该基类提供了方便的日志记录和本地化功能。实现应用服务的时候继承自ApplicationService
并实现定义的接口即可。 - ABP中,一个应用服务方法默认是一个工作单元(Unit of Work)。ABP针对UOW模式自动进行数据库的连接及事务管理,且会自动保存数据修改。
二、定义ITaskAppService接口
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, 为什么需要通过dto进行数据传输?
总结来说,使用DTO进行数据传输具有以下好处。
- 数据隐藏
- 序列化和延迟加载问题
- ABP对DTO提供了约定类以支持验证
- 参数或返回值改变,通过Dto方便扩展
了解更多详情请参考:
ABP框架 - 数据传输对象
3,Dto规范 (灵活应用)
- ABP建议命名输入/输出参数为:MethodNameInput和MethodNameOutput
- 并为每个应用服务方法定义单独的输入和输出DTO(如果为每个方法的输入输出都定义一个dto,那将有一个庞大的dto类需要定义维护。一般通过定义一个公用的dto进行共用)
- 即使你的方法只接受/返回一个参数,也最好是创建一个DTO类
- 一般会在对应实体的应用服务文件夹下新建Dtos文件夹来管理Dto类。
三、定义应用服务接口需要用到的DTO
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 tasks
public override string ToString()
{
return string.Format(
"[Task Id={0}, Description={1}, CreationTime={2}, AssignedPersonName={3}, State={4}]",
Id,
Description,
CreationTime,
AssignedPersonId,
(TaskState)State
);
}
}
}
</