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("
 
[email protected]", 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來實現資料庫互動。

應用服務作為領域服務的消費方，領域服務是無狀態的（領域物件具有狀態和行為，而領域服務是用來處理業務邏輯的，它本身是一個行為，所以是無狀態的）。領域服務是用來協調領域物件完成某個操作，狀態由領域物件儲存。

上面也說了，領域物件是具有狀態和行為的。那就是說我們也可以在實體或值物件來處理業務邏輯。那我們該如何取捨呢？
一般來說，在下面的幾種情況下，我們可以使用領域服務：

1. 執行某個具體的業務操作。
2. 領域物件的轉換。
3. 以多個領域物件為輸入，返回一個值物件。

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("[email protected]", updateTask.AssignedPerson.EmailAddress, "New Todo item", message);

        //_notificationPublisher.Publish("NewTask", new MessageNotificationData(message), null,
        //    NotificationSeverity.Info, new[] { updateTask.AssignedPerson.ToUserIdentifier() });
    }
}

更新後UpdateTask方法已經註釋掉了許可權檢查以及釋出通知的業務邏輯，整個方法也講更清晰。

5.總結

這一節沒有太難的知識點，我們只需謹記，領域服務和應用服務的區別在於只有領域服務才處理業務邏輯。應用服務作為領域服務的消費方，是很薄的一層。
當然，我們也要記住，過度使用領域服務會導致貧血領域模型（即所有的業務邏輯都位於領域服務中，而不是實體和值物件中）。