1.引言
自上次更新有一個多月了,發現越往下寫,越不知如何去寫。特別是當遇到DDD中一些概念術語的時候,尤其迷惑。如果只是簡單的去介紹如何去使用ABP,我只需參照官方文檔,實現到任務清單Demo中去就可以了,不勞神不費力。但是,這樣就等於一知半解。
知之為知之,不知為不知,是知也。知其然知其所以然,方能舉一反三嘛。
為了揭開迷惑,最近開始研讀《實現領域驅動設計》去學習DDD中的思想,並開了一個DDD專題去記錄我學習的成果。歡迎大家關注,共同學習進步並不吝賜教!
后續的文章我會繼續保持之前的書寫風格,並適當穿插一些對DDD中的概念的理解,來加深對ABP框架的學習。
2.用例分析
用戶可以無限創建任務但僅能分配給自己;管理員具有分配任務給他人的權限,任務分配成功后要通知接收人。
我們分析下這個業務用例,其實主要涉及到一個業務操作——任務分配。按照我們傳統的思路,在做任務分配這個操作時,就是對任務進行編輯,沒有什么特別的地方,通過代碼調用應用層服務更新Task實體即可。
//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);
//獲取是否有權限
bool canAssignTaskToOther = PermissionChecker.IsGranted(PermissionNames.Pages_Tasks_AssignPerson);
//如果任務已經分配且未分配給自己,且不具有分配任務權限,則拋出異常
if (input.AssignedPersonId.HasValue && input.AssignedPersonId.Value != AbpSession.GetUserId() )
{
if (!canAssignTaskToOther)
throw new AbpAuthorizationException("沒有分配任務給他人的權限!");
else
{
var updateTask = Mapper.Map<Task>(input);
_taskRepository.Update(updateTask);
//發送通知
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() });
}
}
}
以上代碼也能滿足以上需求,但是這已經違背了ABP分層架構的思想,其實也就是違背了DDD的思想。
應用層不包含業務邏輯,而我們的UpdateTask
方法明顯承載了太多的業務,既要檢查權限又要發送通知。
那可如何是好?自然是在領域服務去處理這些業務邏輯了。
這里就引入了DDD中的兩個概念,應用服務和領域服務,我們有必要先來介紹一下,之后再來用領域服務來改造。
3.應用服務VS領域服務
應用服務對應的是應用層,領域服務對應的領域層。它們之間主要的區別在於是否處理業務邏輯。那這個限制從何而來呢?DDD的分層架構思想。
- 用戶接口層(Presentation):提供一個用戶界面,實現用戶交互操作。
- 應用層(Application):進行展現層與領域層之間的協調,協調業務對象來執行特定的應用程序的任務。它不包含業務邏輯。
- 領域層(Domain):包括業務對象和業務規則,這是應用程序的核心層。
- 基礎設施層(Infrastructure):提供通用技術來支持更高的層。例如基礎設施層的倉儲(Repository)可通過ORM來實現數據庫交互。
應用服務作為領域服務的消費方,領域服務是無狀態的(領域對象具有狀態和行為,而領域服務是用來處理業務邏輯的,它本身是一個行為,所以是無狀態的)。領域服務是用來協調領域對象完成某個操作,狀態由領域對象保存。
上面也說了,領域對象是具有狀態和行為的。那就是說我們也可以在實體或值對象來處理業務邏輯。那我們該如何取舍呢?
一般來說,在下面的幾種情況下,我們可以使用領域服務:
- 執行某個具體的業務操作。
- 領域對象的轉換。
- 以多個領域對象為輸入,返回一個值對象。
4. 使用領域服務
經過上面的分析,很顯然我們的用例,使用領域服務來實現更合適。
ABP中定義了IDomainService
接口,按約定所有的領域服務都要實現它,實現之后,領域服務被自動暫時的注冊到依賴注入系統。
同樣,領域服務也可以從DomainService
類繼承,因此它可以使用繼承得來的日志、本地化、等屬性。
這里,我們定義一個ITaskManager
(Abp中約定俗成的領域服務命名規則,以Manager結尾,當然你也可以自行命名)來定義我們的領域服務,然后實現它。
namespace LearningMpaAbp.Tasks
{
public interface ITaskManager : IDomainService
{
void AssignTaskToPerson(Task task, User user);
}
}
實現的領域服務負責主要的業務邏輯,其中發送通知的業務我定義了一個領域事件去實現。關於領域事件,我們下節再聊。
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)
{
//已經分配,就不再分配
if (task.AssignedPersonId.HasValue && task.AssignedPersonId.Value == user.Id)
{
return;
}
if (task.State != TaskState.Open)
{
throw new ApplicationException("處於非活動狀態的任務不能分配!");
}
//獲取是否有【分配任務給他人】的權限
bool canAssignTaskToOther = _permissionChecker.IsGranted(PermissionNames.Pages_Tasks_AssignPerson);
if (user.Id != _abpSession.GetUserId() && !canAssignTaskToOther)
{
throw new AbpAuthorizationException("沒有分配任務給他人的權限!");
}
task.AssignedPersonId = user.Id;
//使用領域事件觸發發送通知操作
_eventBus.Trigger(new TaskAssignedEventData(task, user));
}
}
}
定義完領域服務,我們直接在應用服務層調用即可。
public void UpdateTask(UpdateTaskInput input)
{
//We can use Logger, it's defined in ApplicationService base class.
Logger.Info("Updating a task for input: " + input);
//獲取是否有權限
//bool canAssignTaskToOther = PermissionChecker.IsGranted(PermissionNames.Pages_Tasks_AssignPerson);
//如果任務已經分配且未分配給自己,且不具有分配任務權限,則拋出異常
if (input.AssignedPersonId.HasValue && input.AssignedPersonId.Value != AbpSession.GetUserId())
{
var updateTask = Mapper.Map<Task>(input);
var user = _userRepository.Get(input.AssignedPersonId.Value);
//先執行分配任務
_taskManager.AssignTaskToPerson(updateTask, user);
//再更新其他字段
_taskRepository.Update(updateTask);
////發送通知
//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
方法已經注釋掉了權限檢查以及發布通知的業務邏輯,整個方法也講更清晰。
5.總結
這一節沒有太難的知識點,我們只需謹記,領域服務和應用服務的區別在於只有領域服務才處理業務邏輯。應用服務作為領域服務的消費方,是很薄的一層。
當然,我們也要記住,過度使用領域服務會導致貧血領域模型(即所有的業務邏輯都位於領域服務中,而不是實體和值對象中)。