ABP是為新的現代Web應用程式使用最佳實踐和使用最流行工具的一個起點。可作為一般用途的應用程式的基礎框架或項目模板。本系列是介紹基於ABP+EasyUI的Web開發框架的形成過程,期間包括一些ABP的介紹,ASP.NET MVC Core技術、EasyUI技術、JQuery技術、WebAPI 技術... ...
在前面我已經介紹了ASP.NET MVC、ASP.NET Razor、WEBAPI等技術。我準備通過一個實踐項目來整體應用一下之前介紹的技術。本系列是介紹基於ABP+EasyUI的Web開發框架的形成過程,期間包括一些ABP的介紹,ASP.NET MVC Core技術、EasyUI技術、JQuery技術、WebAPI 技術,以及一些我對整體框架改造的基礎性東西,力求更加穩定、通用、高效、簡潔,最少的代碼做最多的事情。我所使用的ABP版本是4.3,是2019年3月14日的版本。
一、ABP 的由來
“DRY——避免重覆代碼”是一個優秀的開發者在開發軟體時所具備的最重要的思想之一。我們在開發企業WEB應用程式時都有一些類似的需求,例如:都需要登錄頁面、用戶/角色管理、許可權驗證、數據有效性驗證、多語言/本地化等等。一個高品質的大型軟體都會運用一些最佳實踐,例如分層體繫結構、領域驅動設計、依賴註入等。我們也可能會採用ORM、資料庫遷移(Database Migrations)、日誌記錄(Logging)等工具。
從零開始創建一個企業應用程式是一件繁瑣的事,因為需要重覆做很多常見的基礎工作。許多公司都在開發自己的應用程式框架來重用於不同的項目,然後在框架的基礎上開發一些新的功能。但並不是每個公司都有這樣的實力。假如我們可以分享的更多,也許可以避免每個公司或每個項目的重覆編寫類似的代碼。作者之所以把項目命名為“ASP.NET Boilerplate”,就是希望它能成為開發一般企業WEB應用的新起點,直接把ABP作為項目模板。
二、ABP是什麼?
ABP是為新的現代Web應用程式使用最佳實踐和使用最流行工具的一個起點。可作為一般用途的應用程式的基礎框架或項目模板。它的功能包括:
伺服器端:
- 基於最新的.NET技術 (我使用的是ASP.NET Core MVC、Web API 2、C#)
- 實現領域驅動設計(實體、倉儲、領域服務、領域事件、應用服務、數據傳輸對象,工作單元等等)
- 實現分層體繫結構(領域層,應用層,展現層和基礎設施層)
- 提供了一個基礎架構來開發可重用可配置的模塊
- 集成一些最流行的開源框架/庫,也許有些是你正在使用的。
- 提供了一個基礎架構讓我們很方便地使用依賴註入
- 提供Repository倉儲模式支持不同的ORM(已實現Entity Framework 、NHibernate、MangoDb和記憶體資料庫)
- 支持並實現資料庫遷移(EF 的 Code first)
- 模塊化開發(每個模塊有獨立的EF DbContext,可單獨指定資料庫)
- 包括一個簡單的和靈活的多語言/本地化系統
- 包括一個 EventBus來實現伺服器端全局的領域事件
- 統一的異常處理(應用層幾乎不需要處理自己寫異常處理代碼)
- 數據有效性驗證
- 通過Application Services自動創建Web Api層
- 提供基類和幫助類讓我們方便地實現一些常見的任務
- 使用“約定優於配置原則”
客戶端:
- Bootstrap、React、AngularJs、jQuery、Vue和其他JS庫: jQuery.validate、jQuery.form、jQuery.blockUI、json2等
- 為單頁面應用程式(AngularJs、Vue 、React)和多頁面應用程式(Bootstrap+Jquery)提供了項目模板。
- 自動創建Javascript 的代理層來更方便使用Web Api
- 封裝一些Javascript 函數,更方便地使用ajax、消息框、通知組件、忙狀態的遮罩層等等
除ABP框架項目以外,還開發了名叫“Zero”的模塊,實現了以下功能:
- 身份驗證與授權管理(通過ASP.NET Identity實現的)
- 用戶&角色管理
- 系統設置存取管理(系統級、租戶級、用戶級,作用範圍自動管理)
- 審計日誌(自動記錄每一次介面的調用者和參數)
三、ABP不是什麼?
ABP 提供了一個應用程式開發模型用於最佳實踐。它擁有基礎類、介面和工具使我們容易建立起可維護的大規模的應用程式。
它不是RAD工具之一,RAD工具的目的是無需編碼創建應用程式。相反,ABP提供了一種編碼的最佳實踐。
它不是一個代碼生成工具。在運行時雖然它有一些特性構建動態代碼,但它不能生成代碼。
它不是一個一體化的框架。相反,它使用流行的工具/庫來完成特定的任務(例如用EF做ORM,用Log4Net做日誌記錄,使得Castle Windsor作為賴註入容器, AngularJs 用於SPA 框架)。
四、進入官網創建項目模板
- 在瀏覽器中輸入https://aspnetboilerplate.com/Templates。然後依次按下圖選擇:
- 下載提示,如下圖。
五、開發工具
Visual Studio 2017(以上)
SQL Server 2012 以上
六、啟動項目
1.使用Visual Studio 2017打開我們剛纔在官網上創建的項目“ABP.TPLMS”,Visual Studio 2017會自動還原Nuget包,如下圖。
2. 設置“ABP.TPLMS.Web.Mvc”為啟動項目,如下圖。
3.打開“appsettings.json”文件,修改連接字元串,如下圖。(因為我本地裝的sqlserver是實例是.\sqlexpress,所以需要手動修改server。)
4. 在Visual Studio 2017中,選擇“菜單>工具>NuGet包管理器>程式包管理器控制台”,打開程式包管理器控制台。 如下圖。
5.在程式包管理器控制臺中的“預設項目”選擇“ABP.TPLMS.EntityFrameworkCore”項目,並執行Update-Database
,以創建資料庫。如下圖。
6.在Visual Studio 2017中按F5運行應用程式,然後在瀏覽器中顯示的登錄頁面中使用賬號admin/123qwe,登陸即可。如下圖。
7.在正常登錄之後,瀏覽器中顯示如下圖。
8.預設是英文,可以選擇其他語言。如下圖1,圖2。
圖1
圖2