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

前言

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

知識都是連貫的，若是你熟悉asp.net core 3.x、abp（非vNext） 而且須要作電商功能，也許能夠作個參考。即便不作電商，可能裏面的其它功能也能夠做爲參考，如：如何開發abp模塊、如何集成簡單的微信功能（小程序登陸、小程序支付）、通用字典模塊、等等...

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

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

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

資源

• asp.net core 3框架揭祕【書】
• 大文件分片上傳/秒傳附件功能【視頻】
• 通用數據字典【視頻】
• 微信小程序登陸【視頻】
• 微信小程序支付【視頻】
• >>>>>>>>>>>源碼地址

創建電商模塊項目

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老套路，特別注意就是泛型的定義，目的以前說過，爲了實現商城模塊獨立於主程序。參考源碼。
而後定義商品管理對應的菜單

主程序如何引入？

一、主程序的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

二、主程序的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

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

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

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

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

View Code

最後

整個設計儘可能作到模塊分離，主要仍是參考abp zero的思路，它讓你去提供User類，使用UserManager時也須要提供TUser，最後達到模塊獨立的效果、方便擴展，你能夠實現本身的User添加擴展字段。

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

後面再考慮吧，萬里長征第一步纔開始~但願不會爛尾....