ABP之什麼是ABP(ASP.NET Boilerplate)

1.介紹

ABP是開源的且文檔比較齊全的應用程式框架。其實它不僅僅是個框架，考慮其最佳實踐，ABP更提供了基於領域驅動設計（DDD）的強大價格模型。

ABP支持最新的ASP.NET Core和EF Core，同時也支持ASP.NET MVC 5.x和EF 6.x.

2.快速看一個示例

public class TaskAppService : ApplicationService, ITaskAppService
{
    private readonly IRepository<Task> _taskRepository;

    public TaskAppService(IRepository<Task> taskRepository)
    {
        _taskRepository = taskRepository;
    }

    [AbpAuthorize(MyPermissions.UpdateTasks)]
    public async Task UpdateTask(UpdateTaskInput input)
    {
        Logger.Info("Updating a task for input: " + input);

        var task = await _taskRepository.FirstOrDefaultAsync(input.TaskId);
        if (task == null)
        {
            throw new UserFriendlyException(L("CouldNotFindTheTaskMessage"));
        }

        input.MapTo(task);
    }
}

上面是一個Application Service 方法示例，DDD中方的Application Service直接由表示層調用來執行應用程式的用例。

將UpdateTask看成是JavaScript通過AJAX調用的方法。

3.ABP的優勢

依賴註入（DI）:ABP提供了傳統的DI基礎設施，由於此類是應用程式服務，因此它通常在DI容器中註冊為瞬態（根據請求創建）. 它可以簡單地註入任何依賴項（例如此示例中的IRepository <Task>）。

倉儲：ABP可以為每個實體創建一個預設存儲庫（例如本例中的IRepository <Task>）。 預設存儲庫有許多有用的方法，例如本例中使用的FirstOrDefault方法。 我們可以擴展預設存儲庫以滿足我們的需求。 倉儲庫抽象了DBMS和ORM並簡化數據訪問邏輯。

授權：ABP可以聲明性的檢查許可權，如果當前用戶沒有“update tasks”許可權或者未登錄，ABP會阻止訪問UpdateTask方法。ABP不僅使用聲明性屬性，而且還有其他一些授權方法。

驗證：ABP會自動檢查輸入是否為Null，它還基於標準數據註釋屬性和自定義驗證規則驗證輸入的所有屬性。如果請求無效，則會拋出異常併在客戶端進行處理。

審計日誌：根據約定和配置，為每個請求自動保存用戶，瀏覽器，IP地址，調用服務，方法，參數，調用時間，執行時長以及其他一些信息。

工作單元：在ABP，每個應用程式服務方法預設都被假設成一個工作單元。它自動的在方法開始時創建一個連接並開始一個事務。如果這個方法沒有任何異常的完成，事務會被提交並且釋放連接。儘管這個方法用了不同的倉儲或者方法，他們都將是原子的（事務的）。當一個事務被提交的時候，對實體的所有修改將會自動被保存。我們甚至不需要調用_repository.Update(task)，如上例所示。

異常處理：在一個ABP的web應用程式中，我們幾乎從來不用手動去處理異常.預設情況下所有的異常都會被自動處理！如果一個異常發生，ABP會自動記錄並向客戶端返回正確的結果。比如，如果這是一個AJAX請求，它返回一個JSON對象到客戶端標識一個錯誤的發生。只有在UserFriendlyException情況下，它會隱藏真實的異常。它還可以處理客戶端上的錯誤，並向用戶展示相應的信息。

日誌：我們可以使用在基類中定義的Logger對象。預設使用Log4Net，但是這個是可更改可配置的。

本地化：註意我們在拋出異常時使用了'L'方法？ 這樣，它會根據當前用戶的文化自動進行本地化。

自動映射：在最後一行中，我們使用ABP的MapTo擴展方法將輸入屬性映射到實體屬性。 它使用AutoMapper庫來執行映射。 我們可以根據命名約定輕鬆地將屬性從一個對象映射到另一個對象。

動態的API：TaskAppService是一個簡單的類。 通常我們必須編寫一個包裝器API控制器來向JavaScript客戶端公開方法，但ABP會在運行時自動執行該操作。 這樣，我們可以直接從客戶端使用應用程式服務方法。

動態AJAX代理：ABP創建代理方法，這些方法使調用應用程式服務方法就像在客戶端上調用JavaScript方法一樣簡單。

我們可以在這個簡單的類中看到ABP的好處。 所有這些任務通常需要花費很長時間，但在ABP中，框架都幫我們做了。我們只需要關註自己真正的業務。