本文介紹如何實現(xiàn)進銷存管理系統(tǒng)的基礎(chǔ)數(shù)據(jù)模塊敷扫，基礎(chǔ)數(shù)據(jù)模塊包括商品信息哀蘑、供應(yīng)商管理和客戶管理3個菜單頁面。供應(yīng)商和客戶字段相同葵第，因此可共用一個頁面組件類绘迁。
- 項目代碼：JxcLite
- 開源地址： https://gitee.com/known/JxcLite
1. 配置模塊
運行項目，在【系統(tǒng)管理-模塊管理】中添加商品信息卒密、供應(yīng)商管理缀台、客戶管理3個模塊菜單，模塊基本信息哮奇、模型膛腐、頁面睛约、表單設(shè)置之前有視頻教程，這里不再細說了哲身。
2. 實體類
在JxcLite項目Entities文件夾下面添加JxGoods.cs和JxPartner.cs兩個實體類文件辩涝，實體類代碼可以直接復(fù)制模塊管理中由模型設(shè)置生成的代碼。文章中只簡單描述一下實體類的定義勘天，具體代碼參見開源怔揩，代碼定義如下：
namespace JxcLite.Entities;
/// <summary>
/// 商品信息類。
/// </summary>
public class JxGoods : EntityBase { }
/// <summary>
/// 商業(yè)伙伴信息類误辑。
/// </summary>
public class JxPartner : EntityBase { }
3. 建表腳本
最理想的情況是：在系統(tǒng)安裝時沧踏，通過實體類和數(shù)據(jù)庫類型自動生成建表腳本創(chuàng)建實體數(shù)據(jù)庫表。這里還是用傳統(tǒng)手動方式執(zhí)行建表腳本巾钉，在JxcLite.Web項目Resources文件夾下添加Tables.sql資源文件翘狱，復(fù)制粘貼由【模塊管理-模型設(shè)置】中生成的建表腳本。文章中只簡單描述一下建表腳本砰苍，具體腳本參見開源潦匈，內(nèi)容如下：
CREATE TABLE [JxGoods] (
[Id] varchar(50) NOT NULL PRIMARY KEY,
...
[Files] nvarchar(500) NULL
);
CREATE TABLE [JxPartner] (
[Id] varchar(50) NOT NULL PRIMARY KEY,
...
[Note] ntext NULL,
[Files] nvarchar(500) NULL
);
4. 服務(wù)接口
在JxcLite項目Services文件夾下面添加基礎(chǔ)數(shù)據(jù)模塊服務(wù)接口類，文件名定義為IBaseDataService.cs赚导，該接口定義前后端交互的Api訪問方法茬缩，包括分頁查詢、批量刪除實體吼旧、保存實體凰锡。具體方法定義如下：
namespace JxcLite.Services;
public interface IBaseDataService : IService
{
//分頁查詢商品信息
Task<PagingResult<JxGoods>> QueryGoodsesAsync(PagingCriteria criteria);
//批量刪除商品信息
Task<Result> DeleteGoodsesAsync(List<JxGoods> models);
//保存商品信息
Task<Result> SaveGoodsAsync(UploadInfo<JxGoods> info);
//分頁查詢供應(yīng)商和客戶信息
Task<PagingResult<JxPartner>> QueryPartnersAsync(PagingCriteria criteria);
//批量刪除供應(yīng)商和客戶信息
Task<Result> DeletePartnersAsync(List<JxPartner> models);
//保存供應(yīng)商和客戶信息
Task<Result> SavePartnerAsync(UploadInfo<JxPartner> info);
}
5. 服務(wù)實現(xiàn)
在JxcLite.Web項目Services文件夾下面添加基礎(chǔ)數(shù)據(jù)模塊服務(wù)接口的實現(xiàn)類，文件名定義為BaseDataService.cs圈暗，文章中只簡單描述一下實現(xiàn)類的定義和繼承掂为，具體實現(xiàn)參見開源，定義如下：
namespace JxcLite.Web.Services;
class BaseDataService(Context context) : ServiceBase(context), IBaseDataService
{
public Task<PagingResult<JxGoods>> QueryGoodsesAsync(PagingCriteria criteria) { }
public Task<Result> DeleteGoodsesAsync(List<JxGoods> models) { }
public Task<Result> SaveGoodsAsync(UploadInfo<JxGoods> info) { }
public Task<PagingResult<JxPartner>> QueryPartnersAsync(PagingCriteria criteria) { }
public Task<Result> DeletePartnersAsync(List<JxPartner> models) { }
public Task<Result> SavePartnerAsync(UploadInfo<JxPartner> info) { }
}
雙擊打開JxcLite.Web項目中的AppWeb.cs文件员串，在AddJxcLiteCore方法中注冊服務(wù)類勇哗，前端組件可以通過依賴注入工廠創(chuàng)建服務(wù)的實例。代碼如下：
public static class AppWeb
{
public static void AddJxcLiteCore(this IServiceCollection services)
{
services.AddScoped<IBaseDataService, BaseDataService>();
}
}
6. 數(shù)據(jù)依賴
在JxcLite.Web項目Repositories文件夾下面添加基礎(chǔ)數(shù)據(jù)模塊數(shù)據(jù)依賴類寸齐，文件名定義為BaseDataRepository.cs欲诺，文章中只簡單描述一下依賴類的定義，具體實現(xiàn)參見開源渺鹦，定義如下：
namespace JxcLite.Web.Repositories;
class BaseDataRepository
{
internal static Task<PagingResult<JxGoods>> QueryGoodsesAsync(Database db, PagingCriteria criteria) { }
internal static async Task<bool> ExistsGoodsCodeAsync(Database db, JxGoods model) { }
internal static Task<PagingResult<JxPartner>> QueryPartnersAsync(Database db, PagingCriteria criteria) { }
internal static async Task<bool> ExistsPartnerNameAsync(Database db, JxPartner model) { }
}
7. 數(shù)據(jù)導(dǎo)入類
在JxcLite.Web項目Imports文件夾下面添加商品信息扰法、供應(yīng)商和客戶的導(dǎo)入類，文件名定義為JxGoodsImport.cs和JxPartnerImport.cs毅厚，導(dǎo)入類名稱命名規(guī)范是：實體類名+Import迹恐，導(dǎo)入框架自動根據(jù)名稱識別，文章中只簡單描述一下導(dǎo)入類的定義，具體實現(xiàn)參見開源殴边，定義如下：
namespace JxcLite.Web.Imports;
class JxGoodsImport(ImportContext context) : ImportBase<JxGoods>(context)
{
//初始化導(dǎo)入字段憎茂，自動生成導(dǎo)入規(guī)范Excel文件
public override void InitColumns() { }
//執(zhí)行導(dǎo)入文件
public override async Task<Result> ExecuteAsync(SysFile file) { }
}
class JxPartnerImport(ImportContext context) : ImportBase<JxPartner>(context)
{
public override void InitColumns() { }
public override async Task<Result> ExecuteAsync(SysFile file) { }
}
8. 前端頁面
在JxcLite.Client項目Pages\BaseData文件夾下面添加商品信息和商業(yè)伙伴頁面類，文件名定義為GoodsList.cs和PartnerList.cs锤岸，這3個模塊的功能和頁面非常簡單竖幔，只有單表的增刪改查導(dǎo)功能，表單頁面直接通過在線表單進行配置是偷。列表頁面繼承BaseTablePage類拳氢，由于該框架類封裝了列表頁面常用的增刪改查導(dǎo)功能，因此具體的功能列表頁面代碼顯得格外簡單蛋铆，只需要定義各操作的服務(wù)調(diào)用方法即可馋评，具體的完整代碼如下：
- 商品信息頁面
namespace JxcLite.Client.Pages.BaseData;
[StreamRendering]
[Route("/bds/goods")]
public class GoodsList : BaseTablePage<JxGoods>
{
private IBaseDataService Service;
protected override async Task OnPageInitAsync()
{
await base.OnPageInitAsync();
Service = await CreateServiceAsync<IBaseDataService>();
Table.OnQuery = Service.QueryGoodsesAsync;
}
public void New() => Table.NewForm(Service.SaveGoodsAsync, new JxGoods());
public void DeleteM() => Table.DeleteM(Service.DeleteGoodsesAsync);
public void Edit(JxGoods row) => Table.EditForm(Service.SaveGoodsAsync, row);
public void Delete(JxGoods row) => Table.Delete(Service.DeleteGoodsesAsync, row);
public void Import() => ShowImportForm();
public async void Export() => await ExportDataAsync();
}
- 供應(yīng)商和客戶頁面
[StreamRendering]
[Route("/bds/suppliers")]
public class SupplierList : PartnerList
{
protected override string Type => PartnerType.Supplier;
}
[StreamRendering]
[Route("/bds/customers")]
public class CustomerList : PartnerList
{
protected override string Type => PartnerType.Customer;
}
public class PartnerList : BaseTablePage<JxPartner>
{
private IBaseDataService Service;
//商業(yè)伙伴類型虛擬屬性，供應(yīng)商和客戶頁面覆寫刺啦。
protected virtual string Type { get; }
protected override async Task OnPageInitAsync()
{
await base.OnPageInitAsync();
Service = await CreateServiceAsync<IBaseDataService>();
Table.OnQuery = QueryPartnersAsync;
}
public void New() => Table.NewForm(Service.SavePartnerAsync, new JxPartner { Type = Type });
public void DeleteM() => Table.DeleteM(Service.DeletePartnersAsync);
public void Edit(JxPartner row) => Table.EditForm(Service.SavePartnerAsync, row);
public void Delete(JxPartner row) => Table.Delete(Service.DeletePartnersAsync, row);
public void Import() => ShowImportForm();
public async void Export() => await ExportDataAsync();
private Task<PagingResult<JxPartner>> QueryPartnersAsync(PagingCriteria criteria)
{
criteria.SetQuery(nameof(JxPartner.Type), QueryType.Equal, Type);
return Service.QueryPartnersAsync(criteria);
}
}
