文檔目錄 本節內容: IApplicationService 介面 ApplicationService 類 CrudAppService 和 AsyncCrudAppService 類 簡單的CRUD應用服務示例 定製CRUD應用服務 獲取列表 創建和更新 其它 工作單元 一個應用服務生命周期 簡 ...
本節內容:
應用服務把領域邏輯暴露給展現層。一個應用服務被展現層使用一個DTO(數據傳輸對象)參數所調用,使用領域對象執行一些特殊業務邏輯並返回一個DTO給展現層。因此,展現層是完全獨立於領域層,在一個理想的分層應用里,展現層從不直接使用領域對象。
在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和驗證文檔。
一個應用服務應當實現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類型為參數的泛型,並可通過重寫功能進行你需要的定製。
假設你有一個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:
[AutoMap(typeof(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應用服務的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) { } protected override IQueryable<Task> CreateFilteredQuery(GetAllTasksInput input) { return base.CreateFilteredQuery(input) .WhereIf(input.State.HasValue, t => t.State == input.State.Value); } }
首先,我們添加GetAllTasksInputAsyncCrudAppService第4個泛型參數(第三個是實體主鍵的類型),然後重寫CreateFilteredQuery方法實現自定義過濾,該方法是AsyncCrudAppService類的一個擴展點(WhereIf是ABP的一個擴展方法,用來簡化條件過濾,但實質上我們所做的是簡單過濾一個IQueryable)。
註意:如果你已創建應用服務介面,那麼你就需要為介面添加相同的泛型參數。
註意:我們為獲取、創建和更新Task使用相同的DTO(TaskDto),在現實應用里,這可能不太好,所以我們想定製創建和更新的DTO,讓我們從創建一個CreateTaskInput類開始:
[AutoMapTo(typeof(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:
[AutoMapTo(typeof(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(短暫的),也就說:它們都是暫存於每次使用里。更多信息查看依賴註入文檔。