一步一步abp電商模塊-1、搭建模塊環境

前言目前在開發abp電商模塊，打算做一步，寫一步，算是對自己的記錄，主要是參考nopcommoner 並結合abp模塊開發知識都是連貫的，如果你熟悉asp.net core 3.x、abp（非vNext）並且需要做電商功能，也許可以做個參考。即使不做電商，可能裡面的其它功能也可以作為參考，如： ...

前言

目前在開發abp電商模塊，打算做一步，寫一步，算是對自己的記錄，主要是參考nopcommoner 並結合abp模塊開發

知識都是連貫的，如果你熟悉asp.net core 3.x、abp（非vNext）並且需要做電商功能，也許可以做個參考。即使不做電商，可能裡面的其它功能也可以作為參考，如：如何開發abp模塊、如何集成簡單的微信功能（小程式登錄、小程式支付）、通用字典模塊、等等...

如果不熟悉asp.net core或abp，那建議還是補充基礎知識後再說

如果你是專註電商的.neter，建議用nopcommerce，它是一個成熟完善的.net開源電商

本篇說說搭建電商模塊開發環境

資源

建立電商模塊項目

abp的模塊就是個dll+一個特殊的類（其中包含生命周期方法），具體概念請參考官方文檔

我這裡說的電商模塊是指的功能模塊，按abp的分層方式分為：

xxx.Core：實體、領域服務、領域事件和其它核心功能
xxx.EFCore：基於efCore的倉儲實現，由於abp的牛B，它基本為空
xxx.Application：應用服務，動態webApi

木有提供UI部分，因為是前後單分離的（WebAdmin是基於JQuery的純靜態網站）

可以看到結構與abp預設項目模板保持一致

XXX.Core

與abp模型項目模板一致，它用來定義實體類、領域服務、領域事件、倉儲介面等。它是一個dll，也是一個獨立的abp模塊
Authorization：按abp的要求定義電商系統中涉及到的許可權定義
Configuration：按abp要求定義的電商系統設計到“設置”功能，這個後期可能細化
Localization：商場模塊有自己獨立的本地化配置，
BXJGShopConsts：常量定義
BXJGShopDomainServiceBase：領域服務抽象類，將來定義的領域服務可能大多會繼承這個類
BXJGShopCoreModule：這個還是按abp的標準模塊定義方式，在模塊的生命周期事件中做些初始化工作。

可以看到所有東東還是原來的配方，如果你熟悉abp 幾乎不用思考。

本篇主要講商城模塊環境搭架，所以下麵只是簡單說說正在做的一些具體功能

Catalogue/ItemsEntity：是已經在做的“商品上架信息”的實體類，裡面包含：商品基本信息、上架信息（是否熱賣，是否新品、上架開始/結束時間等）、價格信息（原價、優惠價、等.），後續會陸續添加其它電商業務相關實體，訂單、會員啥的...

Common/BXJGShopDictionaryEntity：電商模塊單獨的“通用字典”功能，比如支付方式、配送方式將來很多下拉框數據都使用這個，它是它是通過我們之前說的通用樹模塊來實現的。

Customer：顧客功能，它與abp的用戶是做一對一關聯，可以發現CustomerEntity<TUser>使用的泛型，這樣將來你在引入商城模塊時需要提供你自己的用戶類型。整個商城功能可能會存在大量這種泛型的設計，目的是讓模塊與主程式分離。

Sale：中是跟銷售相關的功能，核心的就是訂單咯，後續會細講

XXX.EFCore

這個是對應abp中的XXX.EntityFrameworkCore模塊，是用來定義電商業務中數據操作的，也稱為倉儲實現層。但是由於abp已經提供了一個通用的泛型倉儲實現，因此這個類庫中基本上看不到啥東西，除非有特殊情況才需要專門定義。

另一個重要作用是用來定義EF映射配置，因為決定所有實體採用ef api的方式來定義映射。其中ModelBuilderExt用來定義擴展方法，方便將來調用方一次性配置商城系統中的EF映射。在你的主程式的DbContext做如下配置：

1 protected override void OnModelCreating(ModelBuilder modelBuilder)
2 {
3             base.OnModelCreating(modelBuilder);
4             //掃描並應用商城模塊中的ef映射
5             modelBuilder.ApplyConfigurationBXJGShop<User>();
6 }

XXX.Applicatiom

商城模塊應用服務層，同時它也是一個abp模塊。
BXJGShopApplicationModule：按abp模塊套路定義的
BXJGShopAppServiceBase：商城功能應用服務基類
BXJGShopNavigationProvider：註意這是一個靜態類，裡面定義了商城功能的菜單，你需要在你主程式中的NavigationProvider中來調用這個靜態方法，並傳入上級菜單定義，這樣做的目的是允許你將商城功能相關的菜單插入到你主菜單的指定節點位置。

以“商品上架信息ItemEntity”為例感受下

在XXX.Shop.Core中定義實體

商城裡肯定包含很多商品咯，它的實體定義在這裡：源碼

在XXX.Shop.Core中定義商品管理相關許可權

參考這倆文件

在xxx.Shop.EFCore中定義EF映射配置

目前源碼里針對商品信息的映射沒有定義，因為使用api映射是後來決定的，不過有“訂單”的映射文件可以參考。然後修改ModelBuilderExt，添加映射類，參考Order的設計

在xxx.Shop.Application中定義應用服務

定義DTO、IAppService、AppService這個就是abp老套路，特別註意就是泛型的定義，目的之前說過，為了實現商城模塊獨立於主程式。參考源碼。
然後定義商品管理對應的菜單

主程式如何引入？

1、主程式的EF中的DbContext配置

 1         #region 註冊商城模塊中的實體
 2         public virtual DbSet<BXJGShopDictionaryEntity> BXJGShopDictionaries { get; set; }
 3         public virtual DbSet<ItemEntity> BXJGShopItems { get; set; }
 4         public virtual DbSet<CustomerEntity<User>> BXJGShopCustomers { get; set; }
 5         public virtual DbSet<OrderEntity<User>> BXJGShopOrders { get; set; }
 6         #endregion
 7 
 8         public ZLJDbContext(DbContextOptions<ZLJDbContext> options)
 9             : base(options)
10         { }
11 
12         protected override void OnModelCreating(ModelBuilder modelBuilder)
13         {
14             base.OnModelCreating(modelBuilder);
15             
16             //掃描並應用商城模塊中的ef映射
17             modelBuilder.ApplyConfigurationBXJGShop<User>();
18         }

View Code

2、主程式的Core/AuthorizationProvider配置商品管理的許可權

 1     public class ZLJAuthorizationProvider : AuthorizationProvider
 2     {
 3         GeneralTreeModuleConfig cfg;
 4         public ZLJAuthorizationProvider(GeneralTreeModuleConfig cfg)
 5         {
 6             this.cfg = cfg;
 7         }
 8         public override void SetPermissions(IPermissionDefinitionContext context)
 9         {
10             var admin = context.CreatePermission(PermissionNames.Administrator, L("Administrator"));
11             //{codegenerator}
12             #region 商城
13             BXJGShopAuthorizationProvider.SetPermissions(admin);
14             #endregion
15             #region 資產管理

View Code

3、主程式的應用層中提供應用服務類，目的是指定商城管理服務需要的泛型

1 public class ItemAppService : ItemAppService<Tenant, User, Role, TenantManager, UserManager>
2 {
3         public ItemAppService(IRepository<ItemEntity, long> repository) : base(repository)
4         {
5         }
6 }

View Code

4、主程式的Web.Core註冊商城模塊的動態api功能

1  Configuration.Modules.AbpAspNetCore().CreateControllersForAppServices(typeof(BXJGShopApplicationModule).Assembly/*,"bxjgshop"*/);

View Code

最後

整個設計儘量做到模塊分離，主要還是參考abp zero的思路，它讓你去提供User類，使用UserManager時也需要提供TUser，最後達到模塊獨立的效果、方便擴展，你可以實現自己的User添加擴展欄位。

如何做到模塊可擴展性呢？有幾種思路，剛纔說的模塊內部大量使用泛型和抽象類，讓模塊的調用方（比如我們的主程式）可以通過繼承的方式來進行擴展。
也可以使用abp提供的EventBus功能，在模塊內部觸發各種事件，調用方（也就是我們這裡的主程式）可以註冊這些事件，達到參與到商城業務的目的。

後面再考慮吧，萬里長征第一步才開始~希望不會爛尾....