Known框架实战演练——进销存基础数据
本文介绍如何实现进销存管理系统的基础数据模块,基础数据模块包括商品信息、供应商管理和客户管理3个菜单页面。供应商和客户字段相同,因此可共用一个页面组件类。
- 项目代码:JxcLite
- 开源地址: https://gitee.com/known/JxcLite
1. 配置模块
运行项目,在【系统管理-模块管理】中添加商品信息、供应商管理、客户管理3个模块菜单,模块基本信息、模型、页面、表单设置之前有视频教程,这里不再细说了。
2. 实体类
在JxcLite
项目Entities
文件夹下面添加JxGoods.cs
和JxPartner.cs
两个实体类文件,实体类代码可以直接复制模块管理中由模型设置生成的代码。文章中只简单描述一下实体类的定义,具体代码参见开源,代码定义如下:
namespace JxcLite.Entities; /// <summary> /// 商品信息类。 /// </summary> public class JxGoods : EntityBase { } /// <summary> /// 商业伙伴信息类。 /// </summary> public class JxPartner : EntityBase { }
3. 建表脚本
最理想的情况是:在系统安装时,通过实体类和数据库类型自动生成建表脚本创建实体数据库表。这里还是用传统手动方式执行建表脚本,在JxcLite.Web
项目Resources
文件夹下添加Tables.sql
资源文件,复制粘贴由【模块管理-模型设置】中生成的建表脚本。文章中只简单描述一下建表脚本,具体脚本参见开源,内容如下:
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. 服务接口
在JxcLite
项目Services
文件夹下面添加基础数据模块服务接口类,文件名定义为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); //分页查询供应商和客户信息 Task<PagingResult<JxPartner>> QueryPartnersAsync(PagingCriteria criteria); //批量删除供应商和客户信息 Task<Result> DeletePartnersAsync(List<JxPartner> models); //保存供应商和客户信息 Task<Result> SavePartnerAsync(UploadInfo<JxPartner> info); }
5. 服务实现
在JxcLite.Web
项目Services
文件夹下面添加基础数据模块服务接口的实现类,文件名定义为BaseDataService.cs
,文章中只简单描述一下实现类的定义和继承,具体实现参见开源,定义如下:
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
方法中注册服务类,前端组件可以通过依赖注入工厂创建服务的实例。代码如下:
public static class AppWeb { public static void AddJxcLiteCore(this IServiceCollection services) { services.AddScoped<IBaseDataService, BaseDataService>(); } }
6. 数据依赖
在JxcLite.Web
项目Repositories
文件夹下面添加基础数据模块数据依赖类,文件名定义为BaseDataRepository.cs
,文章中只简单描述一下依赖类的定义,具体实现参见开源,定义如下:
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. 数据导入类
在JxcLite.Web
项目Imports
文件夹下面添加商品信息、供应商和客户的导入类,文件名定义为JxGoodsImport.cs
和JxPartnerImport.cs
,导入类名称命名规范是:实体类名+Import,导入框架自动根据名称识别,文章中只简单描述一下导入类的定义,具体实现参见开源,定义如下:
namespace JxcLite.Web.Imports; class JxGoodsImport(ImportContext context) : ImportBase<JxGoods>(context) { //初始化导入字段,自动生成导入规范Excel文件 public override void InitColumns() { } //执行导入文件 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
文件夹下面添加商品信息和商业伙伴页面类,文件名定义为GoodsList.cs
和PartnerList.cs
,这3个模块的功能和页面非常简单,只有单表的增删改查导功能,表单页面直接通过在线表单进行配置。列表页面继承BaseTablePage
类,由于该框架类封装了列表页面常用的增删改查导功能,因此具体的功能列表页面代码显得格外简单,只需要定义各操作的服务调用方法即可,具体的完整代码如下:
- 商品信息页面
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(); }
- 供应商和客户页面
[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; //商业伙伴类型虚拟属性,供应商和客户页面覆写。 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); } }
Known 是基于 Blazor 轻量级、跨平台、低代码、易扩展的插件开发框架。
源码:https://gitee.com/known/Known
源码:https://github.com/known/Known
如果对您有帮助,点击⭐Star⭐关注 ,感谢支持开源!
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 微软正式发布.NET 10 Preview 1:开启下一代开发框架新篇章
· C# 集成 DeepSeek 模型实现 AI 私有化(本地部署与 API 调用教程)
· DeepSeek R1 简明指南:架构、训练、本地部署及硬件要求
· 没有源码,如何修改代码逻辑?
· NetPad:一个.NET开源、跨平台的C#编辑器
2023-07-23 Blazor前后端框架Known-V1.2.6