在前面我已經介紹了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