首页 > 代码库 > 应用服务
应用服务
文档目录
本节内容：
- IApplicationService 接口
- ApplicationService 类
- CrudAppService 和 AsyncCrudAppService 类
- 简单的CRUD应用服务示例
- 定制CRUD应用服务
- 获取列表
- 创建和更新
- 其它
- 工作单元
- 一个应用服务生命周期
应用服务把领域逻辑暴露给展现层。一个应用服务被展现层使用一个DTO（数据传输对象）参数所调用，使用领域对象执行一些特殊业务逻辑并返回一个DTO给展现层。因此，展现层是完全独立于领域层，在一个理想的分层应用里，展现层从不直接使用领域对象。
IApplicationService 接口
在ABP里，一个应用服务应当实现IApplicationService接口，为每个应用服务创建一个接口是好的做法，所以我们先为一个应用服务创建一个接口，如下所示：
public interface IPersonAppService : IApplicationService
{
void CreatePerson(CreatePersonInput input);
}
IPersonAppService只有一个方法，它被展现层用来创建一个新的person，CreatePersonInput是一个DTO对象，如下所示：
public class CreatePersonInput
{
[Required]
public string Name { get; set; }
public string EmailAddress { get; set; }
}
然后我们可以实现IPersonAppService：
public class PersonAppService : IPersonAppService
{
private readonly IRepository<Person> _personRepository;
public PersonAppService(IRepository<Person> personRepository)
{
_personRepository = personRepository;
}
public void CreatePerson(CreatePersonInput input)
{
var person = _personRepository.FirstOrDefault(p => p.EmailAddress == input.EmailAddress);
if (person != null)
{
throw new UserFriendlyException("There is already a person with given email address");
}
person = new Person { Name = input.Name, EmailAddress = input.EmailAddress };
_personRepository.Insert(person);
}
}
这里有几个关键点：
- PersonAppService使用IRepository<Person>执行数据库操作，它使用构造器注入模式，这里我们使用依赖注入。
- PersonAppService实现IApplicationService（因为IPersonAppService扩展了IApplicationService），它自动被ABP注入到依赖注入系统，然后被其它类注入并使用。这里命名约定很重要，查看依赖注入文档获取更多信息。
- CreatePerson方法取得CreatePersonInput，它是一个输入的DTO并被ABP自动验证，更多细节查看DTO和验证文档。
ApplicationService 类
一个应用服务应当实现IApplicationService接口，如上所示，也可随意的继承于ApplicationService基类，因为它内部实现了IApplicationService，同时ApplicationService有些基本的功能，使得日志、本地化等更容易。建议为你的应用服务创建一个特殊的继承于ApplicationService类的基类，从而可以为所有应用服务添加一些通用的功能，一个应用服务示例如下：
public class TaskAppService : ApplicationService, ITaskAppService
{
public TaskAppService()
{
LocalizationSourceName = "SimpleTaskSystem";
}
public void CreateTask(CreateTaskInput input)
{
//Write some logs (Logger is defined in ApplicationService class)
Logger.Info("Creating a new task with description: " + input.Description);
//Get a localized text (L is a shortcut for LocalizationHelper.GetString(...), defined in ApplicationService class)
var text = L("SampleLocalizableTextKey");
//TODO: Add new task to database...
}
}
你有一个在构造器里定义了LocalizationSourceName的基类，这样，你就不用为所有的服务类重复定义了，这个主题的更多信息请查看日志和本地化文档。
CrudAppService 和 AsyncCrueAppService 类
如果你需要为一个特定的实体创建一个包含Create、Update、Delete、GetAll方法的应用服务，可以从CrudAppService（或AsyncCrudAppService，创建异步方法）继承，CrudAppService基类是一个以相关Entity和DTO类型为参数的泛型，并可通过重写功能进行你需要的定制。
简单的CRUD应用服务示例
假设你有一个Task实体，定义如下：
public class Task : Entity, IHasCreationTime
{
public string Title { get; set; }
public string Description { get; set; }
public DateTime CreationTime { get; set; }
public TaskState State { get; set; }
public Person AssignedPerson { get; set; }
public Guid? AssignedPersonId { get; set; }
public Task()
{
CreationTime = Clock.Now;
State = TaskState.Open;
}
}
我们为该实体创建一个DTO：
(Task))]
public class TaskDto : EntityDto, IHasCreationTime
{
public string Title { get; set; }
public string Description { get; set; }
public DateTime CreationTime { get; set; }
public TaskState State { get; set; }
public Guid? AssignedPersonId { get; set; }
public string AssignedPersonName { get; set; }
}
AutoMap特性创建实体与DTO之间的映射配置，现在，我们可以创建一个应用服务，如：
public class TaskAppService : AsyncCrudAppService<Task, TaskDto>
{
public TaskAppService(IRepository<Task> repository)
: base(repository)
{
}
}
我们注入仓储并把它传给基类（如果要使用同步的方法，我们可以从CrudAppService继承）。这就是所有代码！TaskAppService现在就已经有了简单的CRUD方法，如果你想为这个应用服务创建一个接口，可以像下面这样：
public interface ITaskAppService : IAsyncCrudAppService<TaskDto>
{
}
注意：IAsyncCrudAppService没有以实体（Task）作为泛型参数，因为实体与实现相关，不应该包含在公开的接口里，接下来，我们就可以为TaskAppService类实现ITaskAppService接口：
public class TaskAppService : AsyncCrudAppService<Task, TaskDto>, ITaskAppService
{
public TaskAppService(IRepository<Task> repository)
: base(repository)
{
}
}
定制CRUD应用服务
获取列表
Crud应用服务的GetAll方法默认以PagedAndSortedResultRequestInput为参数，该参数提供可选的排序和分页参数，但你可能想为GetAll方法添加另一个参数，例如：你想添加一些自定义过滤，这种情况，你可以为GetAll方法创建一个DTO，如：
public class GetAllTasksInput : PagedAndSortedResultRequestInput
{
public TaskState? State { get; set; }
}
我们从PagedAndSortedResultRequestInput继承（不是必须，但可以直接从基类得到paging和sorting参数），并添加一个可空的State属性，用来过滤task。现在我们应该修改TaskAppService，使它接受自定义过滤：
public class TaskAppService : AsyncCrudAppService<Task, TaskDto, int, GetAllTasksInput>
{
public TaskAppService(IRepository<Task> repository)
: base(repository)
{
}
CreateFilteredQuery(GetAllTasksInput input)
{
input.State.Value);
}
}
首先，我们添加GetAllTasksInputAsyncCrudAppService第4个泛型参数（第三个是实体主键的类型），然后重写CreateFilteredQuery方法实现自定义过滤，该方法是AsyncCrudAppService类的一个扩展点（WhereIf是ABP的一个扩展方法，用来简化条件过滤，但实质上我们所做的是简单过滤一个IQueryable）。
注意：如果你已创建应用服务接口，那么你就需要为接口添加相同的泛型参数。
创建和更新
注意：我们为获取、创建和更新Task使用相同的DTO（TaskDto），在现实应用里，这可能不太好，所以我们想定制创建和更新的DTO，让我们从创建一个CreateTaskInput类开始：
(Task))]
public class CreateTaskInput
{
[Required]
[MaxLength(Task.MaxTitleLength)]
public string Title { get; set; }
[MaxLength(Task.MaxDescriptionLength)]
public string Description { get; set; }
public Guid? AssignedPersonId { get; set; }
}
接着创建一个UpdateTaskInput DTO：
(Task))]
public class UpdateTaskInput : CreateTaskInput, IEntityDto
{
public int Id { get; set; }
public TaskState State { get; set; }
}
我们为Update操作从CreateTaskInput上继承所有属性（但你也可以不这么做），此处必须实现实现IEntity（或不同于int类型的主键的IEntity<PrimaryKey>），因为我们需要知道哪一个实体需要更新，最后，我添加了一个额外的属性State，它不包含在CreateTaskInput里。
接下来，我们可以使用这些DTO类作为AsyncCrudAppService类的泛型接口，如下所示：
public class TaskAppService : AsyncCrudAppService<Task, TaskDto, int, GetAllTasksInput, CreateTaskInput, UpdateTaskInput>
{
public TaskAppService(IRepository<Task> repository)
: base(repository)
{
}
protected override IQueryable<Task> CreateFilteredQuery(GetAllTasksInput input)
{
return base.CreateFilteredQuery(input)
.WhereIf(input.State.HasValue, t => t.State == input.State.Value);
}
}
不需要修改其它的代码。
其它
如果你想定制Get和Delete方法的input的DTO，AsyncCrudAppService可以接受更多的泛型参数。同样，所有的基类方法都是virtual，所以你可以重写它们进行行为定制。
工作单元
在ABP里一个应用服务方法就是一个工作单元，因此，任何一个应用服务方法都是事务性的，并自动在方法结束时保存修改到数据库。
更多信息查看工作单元文档。
一个应用服务的生命周期
所有应用服务实体都是Transient（短暂的），也就说：它们都是暂存于每次使用里。更多信息查看依赖注入文档。
应用服务