1. 程式人生 > 實用技巧 >初識ABP vNext(2):ABP啟動模板

初識ABP vNext(2):ABP啟動模板

目錄

前言

上一篇介紹了ABP的一些基礎知識,本篇繼續介紹ABP的啟動模板。使用ABP CLI命令就可以得到這個啟動模板,其中包含了一些基礎功能模組,你可以基於這個模板來快速開發。

開始

首先ABP CLI的安裝以及基本指令這些就不說了,官網上寫的很清楚。目前ABP的前端部分只支援ASP.NET Core MVC / Razor Pages和Angular,移動端支援React Native。

初學者建議跟著官網https://docs.abp.io/zh-Hans/abp/latest/Tutorials/Part-1?UI=MVC這個指引做一遍,體驗一下ABP開發的基本流程,雖然ABP開發流程幾乎都標準化了,照著官網的流程編寫程式碼就能完成一個功能的開發,但是這個過程有些繁瑣,容易出錯。這裡推薦一個開源專案:

https://github.com/EasyAbp/AbpHelper.GUI,這是一個ABP幫助工具,你只需要建立一個實體,剩下的程式碼它都可以幫你生成。這個專案是https://github.com/EasyAbp下的一個子專案,EasyAbp是國內ABP愛好者建立的,裡面還有很多開箱即用的模組,可以關注一下。。。

AbpHelper

使用AbpHelper來完成官網的例子非常容易,首先建立專案解決方案:

AbpHelper提供了圖形化配置,自動幫我們執行ABP CLI指令:

執行完成後,開啟解決方案,先啟動Acme.BookStore.DbMigrator專案來初始化資料庫:

然後就可以啟動Acme.BookStore.Web專案,這是APB啟動模板的預設介面:

接下來,在Acme.BookStore.Domain專案中建立Book實體,我直接從官網上覆制程式碼。

public class Book : AuditedAggregateRoot<Guid>
{
    public string Name { get; set; }

    public BookType Type { get; set; }

    public DateTime PublishDate { get; set; }

    public float Price { get; set; }

    protected Book()
    {
    }
    public Book(Guid id, string name, BookType type, DateTime publishDate, float price)
        : base(id)
    {
        Name = name;
        Type = type;
        PublishDate = publishDate;
        Price = price;
    }
}

在Acme.BookStore.Domain.Shared專案中新增列舉類BookType:

public enum BookType
{
    Undefined,
    Adventure,
    Biography,
    Dystopia,
    Fantastic,
    Horror,
    Science,
    ScienceFiction,
    Poetry
}

第一次使用需要安裝一下AbpHelper CLI:

選擇Generate CRUD,填入實體名稱和解決方案路徑,然後Execute即可:

生成程式碼時可能會報這個錯(如果沒裝ef tools):

這時安裝一下ef tools就好了,dotnet tool install -g dotnet-ef

程式碼生成完後,執行Acme.BookStore.Web專案:

使用預設使用者 admin/1q2w3E* 登入系統,給admin角色分配BookStore相關許可權:

然後就可以看到book選單了,包括基本的增刪改查介面:

至此就完成了一個基本功能的開發,AbpHelper確實很方便,他還有CLI版本,直接命令列操作。

模組安裝

ABP的模組化可以實現外掛式的開發,你可以預先構建一些通用的模組,比如日誌模組,使用者模組等等,當你以後需要時就可以直接安裝到專案中。有一些由ABP社群開發和維護的開源免費的應用程式模組,我們可以直接使用;比如我要使用官方的Blogging模組,Blogging是用於建立精美的部落格。

同樣使用AbpHelper來安裝:

安裝過程出了點小問題,提示找不到DbContext。。。不過沒關係,自己執行一下遷移命令就行。。。

Acme.BookStore.Web專案設為啟動項,預設專案為Acme.BookStore.EntityFrameworkCore.DbMigrations,然後執行:

Add-Migration AddedBlogging

Update-DataBase

接下來再次執行Acme.BookStore.Web專案,為admin角色配置部落格相關的許可權:

然後就就可以看到部落格的相關功能:

Swagger:

當然,這些模組不一定完全符合你的要求,你可能需要稍作修改,ABP也允許你擴充套件實體,重寫服務包括重寫使用者介面,你可以很方便的修改。這些後面再介紹,包括如何去開發這種模組。。。

最後

EasyAbp上也有很多開源模組,地址是:https://github.com/EasyAbp/EasyAbpGuide,目前這些模組的UI部分都只支援MVC/Razor Pages,不支援Angular之類的。。。當然模組不一定非要UI,一些Framework級別的模組就不需要UI。基礎部分就寫到這裡,主要還是需要認真看下官網,然後自己動手練習一下。下一篇將進入vue+ABP實戰部分。