<<ABP文檔 - 框架>> 1.1 介紹

来源:http://www.cnblogs.com/kid1412/archive/2016/10/18/5971842.html
-Advertisement-
Play Games

文檔目錄 本節內容: 簡介 一個快速示例 其它特性 啟動模板 如何使用 簡介 我們總是對不同的需求開發不同的應用。但至少在某些層面上,一次又一次地重覆實現通用的和類似的功能。如:授權,驗證,異常處理,日誌,本地化,資料庫連接管理,設置管理,審核日誌等功能。所以我們創建架構和最佳實踐,如分層和模塊架構 ...


文檔目錄

 

本節內容:

 

簡介

我們總是對不同的需求開發不同的應用。但至少在某些層面上,一次又一次地重覆實現通用的和類似的功能。如:授權,驗證,異常處理,日誌,本地化,資料庫連接管理,設置管理,審核日誌等功能。所以我們創建架構和最佳實踐,如分層和模塊架構,DDD,依賴註入等,並嘗試開發應用時基於一些約定。

 

由於所有這些是非常耗時而且很難單獨創建並可適用於每個項目,許多公司創建自己的框架,他們用自己的框架能快速開發新應用而且不出錯。但不是所有的公司都是幸運的,大部分公司沒有時間,預算和團隊來開發好的框架。他們甚至都沒有可能創建一個框架,因為編寫文檔,培訓開發人員和維護框架都是非常困難的。

 

ASP.NET Boilerplate (ABP) 是一個開源並且有豐富文檔的應用框架,開發宗旨是:“為所有公司,所有開發人員,開發出一個通用框架!”,而且不只是一個框架,同時提供一個強大的基於DDD的構架模型和最佳實踐。

 

一個快速示例

讓我們從一個簡單的類來體會一下ABP帶來的便利:

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

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

    [AbpAuthorize(MyPermissions.UpdatingTasks)]
    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("CouldNotFoundTheTaskMessage"));
        }

        Input.MapTo(task);
    }
}

示例里我們看到一個應用服務方法,在DDD中,應用服務方法是在表示層執行應用的用戶用例的。我們可以想成UpdateTask方法是被Ajax調用。讓我們看看ABP帶來的便利:

  • 依賴註入:ABP使用並提供一個強大而且符合約定的DI框架。上述的應用服務,按照約定臨時的(每個請求Request創建一個)註冊到DI容器,它能簡單地註入所有依賴項(如示例中的Irepository<Task>)。
  • 倉儲:ABP能為每個實體創建一個預設的倉儲(如示例中的Irepository<Task>)。預設倉儲包含許多有用的方法,如示例中的FirstOrDefault方法。我們可以根據需要,很容易地擴展預設倉儲。倉儲抽象了DBMS和ORM以及簡化了數據訪問邏輯。
  • 授權:ABP可以檢查許可。如果當前用戶沒有“updating task”許可權或是未登錄,ABP就會阻止他們訪問UpdateTask方法。用陳述性的特性來簡化授權,當然還有另外的授權方式。
  • 驗證:ABP自動檢查input是否為null。根據標準的數據註釋特性和自定義驗證規則,檢查一個input的所有屬性。如果請求沒有通過驗證,會拋出一個對應的驗證異常。
  • 審核日誌:根據約定和配置,每個請求的用戶、瀏覽器、Ip地址、調用服務、方法、參數、調用時間、執行耗時和其它的一些信息會被自動地保存下來。
  • 工作單元:在ABP里,每個應用服務方法都預設地被認定為一個工作單元。在方法開始前,它自動創建一個連接並開啟一個事務。如果方法成功完成,接著事務會被提交並釋放連接。即使是使用不同的倉儲或是方法,它們都可以是原子性(事務性)的,並且當事務提交時實體中所有的修改都自動地被保存。因此,如同示例所示,我們甚至不需要去調用_repository.Update(task)方法。
  • 異常處理:我們幾乎不用在一個使用ABP的Web應用中寫異常處理。所有的異常都自動地被預設處理。當一個異常發生,ABP自動記錄它並返回一個對應的結果給客戶端。例如,一個AJAX請求,它會返回一個Json對象給客戶端,告知發生了一個錯誤。如示例所示,UserFriendlyException可以向客戶端隱藏具體的異常,顯示友好信息。它同樣可以在客戶端理解並處理客戶端錯誤,並向用戶顯示對應的信息。
  • 日誌:如你所見,我們可以用定義在基類中的Logger對象寫日誌。預設使用Log4Net,不過這是可修改和可配置的。
  •  本地化:請註意我們在拋出異常時,使用了L方法。因此,它可自動依據用戶區域,使用相應的本地化信息。當然,我們需要在某處定義CouldNotFoundTheTaskMessage(更多信息參見“本地化”文檔)。
  • 自動映射:最後一行代碼,我們使用ABP的MapTo擴展方法來映射input屬性到實體屬性。它使用AutoMapper庫來執行映射。因此,我們可以簡單地基於命名約定,從一個對象映射到另一個。
  • 動態Web API 層:實際上TaskAppService是一個簡單的類(甚至是不需要從ApplicationService繼承)。我們通常包裝一個Web API 控制器為Javascript客戶端公開方法,ABP會在運行時自動地完成這件事。因此,我們可以直接在客戶端使用應用服務。
  • 動態Javascript AJAX 代理:ABP創建Javascript代理方法,以便就本地調用一樣,來調用應用服務。

通過這麼一個簡單類我們能看到ABP的便利。完成這些任務一般來說都是很費時的,但是所有的一切,ABP都自動處理了。

 

其它特性

除了示例所示,ABP提供了一個強大的基礎架構和應用模型,下列為ABP的其它特性:

  • 模塊化:提供一個強大的基礎架構來創建可重用的模塊。
  • 數據過濾:提供自動地數據過濾來實現一些模式,像軟刪除和多租戶。
  • 多租戶:完全地支持多租戶,包含單資料庫或每租戶一個單獨資料庫。
  • 設置管理:提供一個基礎架構來讀取/修改應用、租戶和用戶級別的設置。
  • 單元和集成測試:以可測試為宗旨,當然提供基礎類來簡化單元測試和集成測試。點擊查看更多相關信息

 

啟動模板

開始一個新的解決方案、創建層、安裝nuget包、創建一個簡單的佈局和菜單...所有這些都是耗時的工作。

ABP提供預創建的啟動模板,使開始一個新的解決方案更簡單。模板支持SPA(單頁面應用)和MPA(多頁面MVC應用)結構。同時允許我們使用不同的ORM工具。

 

如何使用

ABP開源項目在Github上,分發在Nuget上。“啟動模板”是使用ABP的最簡單方式(按文檔所述操作)。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 本節介紹TreeMap,相比HashMap,它有什麼不同?除了Map介面,它還實現的SortedMap和NavigableMap介面有哪些方法?TreeMap具體是如何實現的?... ...
  • String str = "str"; str.length(); //3 返回字元串長度 str.indexOf("s"); //0 返回s所在下標0開始; 沒有則返回-1 str.trim(); //"str" 去除str的前後空格 str.substring(0,1); //"s" 含首不含尾 ...
  • 加 ^$ 整個字元串滿足要求 不加部分字元串滿足要求即可通過 \:轉義字元 \d:任意一個數字 (digit:數字) \w:任意一個單詞字元( 數字,字母,下劃線)(word:單詞) \s:任意一個空白字元(\t \r \n \f \x0B) (space:空) \D:任意一個非數字字元 \W:任意 ...
  • 1.查看id生成策略,2.查看是否是手動設置的id ;3.查看實體對象映射配置是否正確. 例如: public Emplopes(String name, char gender) { super(name, gender); // TODO Auto-generated constructor s ...
  • 一、滑鼠控制角色行走(每一步固定距離) 1.首先,要理解角色移動的原理。 2.現在來定義所需變數,在main窗體模塊中最頂端輸入以下代碼。 3.在main窗體中繪製一個timer時間控制項,將其Enabled(啟動)設為false,Interval(間隔)設為30(這個可以自定義,是用來調整角色移動速 ...
  • 1.領域驅動簡介 領域驅動本身是一款古老的軟體建模思想 領域驅動兩大特性:通用語言.限界上下文 1.通用語言是一種思想.解釋是:團隊共用的術語.便於交流.//比如行業的術語或者.一個圈子內通俗的名稱如開發者們對Visual Studio 的簡稱:VS. 2.限界上下文是整個應用程式之內一種概念性邊界 ...
  • 回到目錄 對於Lind.DDD這個敏捷框架來說,插件也是其中的一個亮點,所有被認為是插件(Plugins)的模塊都會繼承自IPlugins這個標示介面,它在程式啟動時會找到所有插件,並通過autofac註冊到運行時中,然後在使用時通過PluginManager對象進行獲取,即所有模塊只註冊一次,在使 ...
  • 談談互聯網後端基礎設施 談談互聯網後端基礎設施 來自:http://chuansong.me/n/717637351233 對於一個互聯網企業,後端服務是必不可少的一個組成部分。拋開業務應用來說,往下的基礎服務設施做到哪些才能夠保證業務的穩定可靠、易維護、高可用呢?縱觀整個互聯網技術體系再結合公司的 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...