ABP入门系列(18)—— 使用领域服务
1.引言
自上次更新有一個(gè)多月了,發(fā)現(xiàn)越往下寫,越不知如何去寫。特別是當(dāng)遇到DDD中一些概念術(shù)語的時(shí)候,尤其迷惑。如果只是簡單的去介紹如何去使用ABP,我只需參照官方文檔,實(shí)現(xiàn)到任務(wù)清單Demo中去就可以了,不勞神不費(fèi)力。但是,這樣就等于一知半解。
知之為知之,不知為不知,是知也。知其然知其所以然,方能舉一反三嘛。
為了揭開迷惑,最近開始研讀《實(shí)現(xiàn)領(lǐng)域驅(qū)動設(shè)計(jì)》去學(xué)習(xí)DDD中的思想,并開了一個(gè)DDD專題去記錄我學(xué)習(xí)的成果。歡迎大家關(guān)注,共同學(xué)習(xí)進(jìn)步并不吝賜教!
后續(xù)的文章我會繼續(xù)保持之前的書寫風(fēng)格,并適當(dāng)穿插一些對DDD中的概念的理解,來加深對ABP框架的學(xué)習(xí)。
2.用例分析
用戶可以無限創(chuàng)建任務(wù)但僅能分配給自己;管理員具有分配任務(wù)給他人的權(quán)限,任務(wù)分配成功后要通知接收人。
我們分析下這個(gè)業(yè)務(wù)用例,其實(shí)主要涉及到一個(gè)業(yè)務(wù)操作——任務(wù)分配。按照我們傳統(tǒng)的思路,在做任務(wù)分配這個(gè)操作時(shí),就是對任務(wù)進(jìn)行編輯,沒有什么特別的地方,通過代碼調(diào)用應(yīng)用層服務(wù)更新Task實(shí)體即可。
//TaskAppService.cs public void UpdateTask(UpdateTaskInput input) {//We can use Logger, it's defined in ApplicationService base class.Logger.Info("Updating a task for input: " + input);//獲取是否有權(quán)限bool canAssignTaskToOther = PermissionChecker.IsGranted(PermissionNames.Pages_Tasks_AssignPerson);//如果任務(wù)已經(jīng)分配且未分配給自己,且不具有分配任務(wù)權(quán)限,則拋出異常if (input.AssignedPersonId.HasValue && input.AssignedPersonId.Value != AbpSession.GetUserId() ){if (!canAssignTaskToOther)throw new AbpAuthorizationException("沒有分配任務(wù)給他人的權(quán)限!");else{var updateTask = Mapper.Map<Task>(input);_taskRepository.Update(updateTask);//發(fā)送通知var message = "You hava been assigned one task into your todo list.";_smtpEmailSender.Send("ysjshengjie@qq.com", updateTask.AssignedPerson.EmailAddress, "New Todo item", message);_notificationPublisher.Publish("NewTask", new MessageNotificationData(message), null,NotificationSeverity.Info, new[] { updateTask.AssignedPerson.ToUserIdentifier() });}} }以上代碼也能滿足以上需求,但是這已經(jīng)違背了ABP分層架構(gòu)的思想,其實(shí)也就是違背了DDD的思想。
應(yīng)用層不包含業(yè)務(wù)邏輯,而我們的UpdateTask方法明顯承載了太多的業(yè)務(wù),既要檢查權(quán)限又要發(fā)送通知。
那可如何是好?自然是在領(lǐng)域服務(wù)去處理這些業(yè)務(wù)邏輯了。
這里就引入了DDD中的兩個(gè)概念,應(yīng)用服務(wù)和領(lǐng)域服務(wù),我們有必要先來介紹一下,之后再來用領(lǐng)域服務(wù)來改造。
3.應(yīng)用服務(wù)VS領(lǐng)域服務(wù)
應(yīng)用服務(wù)對應(yīng)的是應(yīng)用層,領(lǐng)域服務(wù)對應(yīng)的領(lǐng)域?qū)?。它們之間主要的區(qū)別在于是否處理業(yè)務(wù)邏輯。那這個(gè)限制從何而來呢?DDD的分層架構(gòu)思想。
- 用戶接口層(Presentation):提供一個(gè)用戶界面,實(shí)現(xiàn)用戶交互操作。
- 應(yīng)用層(Application):進(jìn)行展現(xiàn)層與領(lǐng)域?qū)又g的協(xié)調(diào),協(xié)調(diào)業(yè)務(wù)對象來執(zhí)行特定的應(yīng)用程序的任務(wù)。它不包含業(yè)務(wù)邏輯。
- 領(lǐng)域?qū)?#xff08;Domain):包括業(yè)務(wù)對象和業(yè)務(wù)規(guī)則,這是應(yīng)用程序的核心層。
- 基礎(chǔ)設(shè)施層(Infrastructure):提供通用技術(shù)來支持更高的層。例如基礎(chǔ)設(shè)施層的倉儲(Repository)可通過ORM來實(shí)現(xiàn)數(shù)據(jù)庫交互。
應(yīng)用服務(wù)作為領(lǐng)域服務(wù)的消費(fèi)方,領(lǐng)域服務(wù)是無狀態(tài)的(領(lǐng)域?qū)ο缶哂袪顟B(tài)和行為,而領(lǐng)域服務(wù)是用來處理業(yè)務(wù)邏輯的,它本身是一個(gè)行為,所以是無狀態(tài)的)。領(lǐng)域服務(wù)是用來協(xié)調(diào)領(lǐng)域?qū)ο笸瓿赡硞€(gè)操作,狀態(tài)由領(lǐng)域?qū)ο蟊4妗?/p>
上面也說了,領(lǐng)域?qū)ο笫蔷哂袪顟B(tài)和行為的。那就是說我們也可以在實(shí)體或值對象來處理業(yè)務(wù)邏輯。那我們該如何取舍呢?
一般來說,在下面的幾種情況下,我們可以使用領(lǐng)域服務(wù):
4. 使用領(lǐng)域服務(wù)
經(jīng)過上面的分析,很顯然我們的用例,使用領(lǐng)域服務(wù)來實(shí)現(xiàn)更合適。
ABP中定義了IDomainService接口,按約定所有的領(lǐng)域服務(wù)都要實(shí)現(xiàn)它,實(shí)現(xiàn)之后,領(lǐng)域服務(wù)被自動暫時(shí)的注冊到依賴注入系統(tǒng)。
同樣,領(lǐng)域服務(wù)也可以從DomainService類繼承,因此它可以使用繼承得來的日志、本地化、等屬性。
這里,我們定義一個(gè)ITaskManager(Abp中約定俗成的領(lǐng)域服務(wù)命名規(guī)則,以Manager結(jié)尾,當(dāng)然你也可以自行命名)來定義我們的領(lǐng)域服務(wù),然后實(shí)現(xiàn)它。
namespace LearningMpaAbp.Tasks {public interface ITaskManager : IDomainService{void AssignTaskToPerson(Task task, User user);} }實(shí)現(xiàn)的領(lǐng)域服務(wù)負(fù)責(zé)主要的業(yè)務(wù)邏輯,其中發(fā)送通知的業(yè)務(wù)我定義了一個(gè)領(lǐng)域事件去實(shí)現(xiàn)。關(guān)于領(lǐng)域事件,我們下節(jié)再聊。
namespace LearningMpaAbp.Tasks {public class TaskManager : DomainService, ITaskManager{private readonly IPermissionChecker _permissionChecker;private readonly IAbpSession _abpSession;private readonly IEventBus _eventBus;public TaskManager(IPermissionChecker permissionChecker, IAbpSession abpSession, IEventBus eventBus){_permissionChecker = permissionChecker;_abpSession = abpSession;_eventBus = eventBus;}public void AssignTaskToPerson(Task task, User user){//已經(jīng)分配,就不再分配if (task.AssignedPersonId.HasValue && task.AssignedPersonId.Value == user.Id){return;}if (task.State != TaskState.Open){throw new ApplicationException("處于非活動狀態(tài)的任務(wù)不能分配!");}//獲取是否有【分配任務(wù)給他人】的權(quán)限bool canAssignTaskToOther = _permissionChecker.IsGranted(PermissionNames.Pages_Tasks_AssignPerson);if (user.Id != _abpSession.GetUserId() && !canAssignTaskToOther){throw new AbpAuthorizationException("沒有分配任務(wù)給他人的權(quán)限!");}task.AssignedPersonId = user.Id;//使用領(lǐng)域事件觸發(fā)發(fā)送通知操作_eventBus.Trigger(new TaskAssignedEventData(task, user));}} }定義完領(lǐng)域服務(wù),我們直接在應(yīng)用服務(wù)層調(diào)用即可。
public void UpdateTask(UpdateTaskInput input) {//We can use Logger, it's defined in ApplicationService base class.Logger.Info("Updating a task for input: " + input);//獲取是否有權(quán)限//bool canAssignTaskToOther = PermissionChecker.IsGranted(PermissionNames.Pages_Tasks_AssignPerson);//如果任務(wù)已經(jīng)分配且未分配給自己,且不具有分配任務(wù)權(quán)限,則拋出異常if (input.AssignedPersonId.HasValue && input.AssignedPersonId.Value != AbpSession.GetUserId()){var updateTask = Mapper.Map<Task>(input);var user = _userRepository.Get(input.AssignedPersonId.Value);//先執(zhí)行分配任務(wù)_taskManager.AssignTaskToPerson(updateTask, user);//再更新其他字段_taskRepository.Update(updateTask);發(fā)送通知//var message = "You hava been assigned one task into your todo list.";//_smtpEmailSender.Send("ysjshengjie@qq.com", updateTask.AssignedPerson.EmailAddress, "New Todo item", message);//_notificationPublisher.Publish("NewTask", new MessageNotificationData(message), null,// NotificationSeverity.Info, new[] { updateTask.AssignedPerson.ToUserIdentifier() });} }更新后UpdateTask方法已經(jīng)注釋掉了權(quán)限檢查以及發(fā)布通知的業(yè)務(wù)邏輯,整個(gè)方法也講更清晰。
5.總結(jié)
這一節(jié)沒有太難的知識點(diǎn),我們只需謹(jǐn)記,領(lǐng)域服務(wù)和應(yīng)用服務(wù)的區(qū)別在于只有領(lǐng)域服務(wù)才處理業(yè)務(wù)邏輯。應(yīng)用服務(wù)作為領(lǐng)域服務(wù)的消費(fèi)方,是很薄的一層。
當(dāng)然,我們也要記住,過度使用領(lǐng)域服務(wù)會導(dǎo)致貧血領(lǐng)域模型(即所有的業(yè)務(wù)邏輯都位于領(lǐng)域服務(wù)中,而不是實(shí)體和值對象中)。
推薦鏈接:你必須知道的.NET Core開發(fā)指南?
推薦鏈接:你必須知道的ML.NET開發(fā)指南?
推薦鏈接:你必須知道的Office開發(fā)指南?
推薦鏈接:你必須知道的IOT開發(fā)指南?
總結(jié)
以上是生活随笔為你收集整理的ABP入门系列(18)—— 使用领域服务的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: NuGet是什么?理解与使用(下)
- 下一篇: DNS的A、CNAME、MX、NS、TX