经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置:技术经验 » 程序设计 » 编程经验 » 查看文章
Known框架实战演练——进销存基础数据
来源:cnblogs  作者:known  时间:2024/7/23 9:07:12  对本文有异议

本文介绍如何实现进销存管理系统的基础数据模块,基础数据模块包括商品信息、供应商管理和客户管理3个菜单页面。供应商和客户字段相同,因此可共用一个页面组件类。

1. 配置模块

运行项目,在【系统管理-模块管理】中添加商品信息、供应商管理、客户管理3个模块菜单,模块基本信息、模型、页面、表单设置之前有视频教程,这里不再细说了。

2. 实体类

JxcLite项目Entities文件夹下面添加JxGoods.csJxPartner.cs两个实体类文件,实体类代码可以直接复制模块管理中由模型设置生成的代码。文章中只简单描述一下实体类的定义,具体代码参见开源,代码定义如下:

  1. namespace JxcLite.Entities;
  2. /// <summary>
  3. /// 商品信息类。
  4. /// </summary>
  5. public class JxGoods : EntityBase { }
  6. /// <summary>
  7. /// 商业伙伴信息类。
  8. /// </summary>
  9. public class JxPartner : EntityBase { }

3. 建表脚本

最理想的情况是:在系统安装时,通过实体类和数据库类型自动生成建表脚本创建实体数据库表。这里还是用传统手动方式执行建表脚本,在JxcLite.Web项目Resources文件夹下添加Tables.sql资源文件,复制粘贴由【模块管理-模型设置】中生成的建表脚本。文章中只简单描述一下建表脚本,具体脚本参见开源,内容如下:

  1. CREATE TABLE [JxGoods] (
  2. [Id] varchar(50) NOT NULL PRIMARY KEY,
  3. ...
  4. [Files] nvarchar(500) NULL
  5. );
  6. CREATE TABLE [JxPartner] (
  7. [Id] varchar(50) NOT NULL PRIMARY KEY,
  8. ...
  9. [Note] ntext NULL,
  10. [Files] nvarchar(500) NULL
  11. );

4. 服务接口

JxcLite项目Services文件夹下面添加基础数据模块服务接口类,文件名定义为IBaseDataService.cs,该接口定义前后端交互的Api访问方法,包括分页查询、批量删除实体、保存实体。具体方法定义如下:

  1. namespace JxcLite.Services;
  2. public interface IBaseDataService : IService
  3. {
  4. //分页查询商品信息
  5. Task<PagingResult<JxGoods>> QueryGoodsesAsync(PagingCriteria criteria);
  6. //批量删除商品信息
  7. Task<Result> DeleteGoodsesAsync(List<JxGoods> models);
  8. //保存商品信息
  9. Task<Result> SaveGoodsAsync(UploadInfo<JxGoods> info);
  10. //分页查询供应商和客户信息
  11. Task<PagingResult<JxPartner>> QueryPartnersAsync(PagingCriteria criteria);
  12. //批量删除供应商和客户信息
  13. Task<Result> DeletePartnersAsync(List<JxPartner> models);
  14. //保存供应商和客户信息
  15. Task<Result> SavePartnerAsync(UploadInfo<JxPartner> info);
  16. }

5. 服务实现

JxcLite.Web项目Services文件夹下面添加基础数据模块服务接口的实现类,文件名定义为BaseDataService.cs,文章中只简单描述一下实现类的定义和继承,具体实现参见开源,定义如下:

  1. namespace JxcLite.Web.Services;
  2. class BaseDataService(Context context) : ServiceBase(context), IBaseDataService
  3. {
  4. public Task<PagingResult<JxGoods>> QueryGoodsesAsync(PagingCriteria criteria) { }
  5. public Task<Result> DeleteGoodsesAsync(List<JxGoods> models) { }
  6. public Task<Result> SaveGoodsAsync(UploadInfo<JxGoods> info) { }
  7. public Task<PagingResult<JxPartner>> QueryPartnersAsync(PagingCriteria criteria) { }
  8. public Task<Result> DeletePartnersAsync(List<JxPartner> models) { }
  9. public Task<Result> SavePartnerAsync(UploadInfo<JxPartner> info) { }
  10. }

双击打开JxcLite.Web项目中的AppWeb.cs文件,在AddJxcLiteCore方法中注册服务类,前端组件可以通过依赖注入工厂创建服务的实例。代码如下:

  1. public static class AppWeb
  2. {
  3. public static void AddJxcLiteCore(this IServiceCollection services)
  4. {
  5. services.AddScoped<IBaseDataService, BaseDataService>();
  6. }
  7. }

6. 数据依赖

JxcLite.Web项目Repositories文件夹下面添加基础数据模块数据依赖类,文件名定义为BaseDataRepository.cs,文章中只简单描述一下依赖类的定义,具体实现参见开源,定义如下:

  1. namespace JxcLite.Web.Repositories;
  2. class BaseDataRepository
  3. {
  4. internal static Task<PagingResult<JxGoods>> QueryGoodsesAsync(Database db, PagingCriteria criteria) { }
  5. internal static async Task<bool> ExistsGoodsCodeAsync(Database db, JxGoods model) { }
  6. internal static Task<PagingResult<JxPartner>> QueryPartnersAsync(Database db, PagingCriteria criteria) { }
  7. internal static async Task<bool> ExistsPartnerNameAsync(Database db, JxPartner model) { }
  8. }

7. 数据导入类

JxcLite.Web项目Imports文件夹下面添加商品信息、供应商和客户的导入类,文件名定义为JxGoodsImport.csJxPartnerImport.cs导入类名称命名规范是:实体类名+Import,导入框架自动根据名称识别,文章中只简单描述一下导入类的定义,具体实现参见开源,定义如下:

  1. namespace JxcLite.Web.Imports;
  2. class JxGoodsImport(ImportContext context) : ImportBase<JxGoods>(context)
  3. {
  4. //初始化导入字段,自动生成导入规范Excel文件
  5. public override void InitColumns() { }
  6. //执行导入文件
  7. public override async Task<Result> ExecuteAsync(SysFile file) { }
  8. }
  9. class JxPartnerImport(ImportContext context) : ImportBase<JxPartner>(context)
  10. {
  11. public override void InitColumns() { }
  12. public override async Task<Result> ExecuteAsync(SysFile file) { }
  13. }

8. 前端页面

JxcLite.Client项目Pages\BaseData文件夹下面添加商品信息和商业伙伴页面类,文件名定义为GoodsList.csPartnerList.cs,这3个模块的功能和页面非常简单,只有单表的增删改查导功能,表单页面直接通过在线表单进行配置。列表页面继承BaseTablePage类,由于该框架类封装了列表页面常用的增删改查导功能,因此具体的功能列表页面代码显得格外简单,只需要定义各操作的服务调用方法即可,具体的完整代码如下:

  • 商品信息页面
  1. namespace JxcLite.Client.Pages.BaseData;
  2. [StreamRendering]
  3. [Route("/bds/goods")]
  4. public class GoodsList : BaseTablePage<JxGoods>
  5. {
  6. private IBaseDataService Service;
  7. protected override async Task OnPageInitAsync()
  8. {
  9. await base.OnPageInitAsync();
  10. Service = await CreateServiceAsync<IBaseDataService>();
  11. Table.OnQuery = Service.QueryGoodsesAsync;
  12. }
  13. public void New() => Table.NewForm(Service.SaveGoodsAsync, new JxGoods());
  14. public void DeleteM() => Table.DeleteM(Service.DeleteGoodsesAsync);
  15. public void Edit(JxGoods row) => Table.EditForm(Service.SaveGoodsAsync, row);
  16. public void Delete(JxGoods row) => Table.Delete(Service.DeleteGoodsesAsync, row);
  17. public void Import() => ShowImportForm();
  18. public async void Export() => await ExportDataAsync();
  19. }
  • 供应商和客户页面
  1. [StreamRendering]
  2. [Route("/bds/suppliers")]
  3. public class SupplierList : PartnerList
  4. {
  5. protected override string Type => PartnerType.Supplier;
  6. }
  7. [StreamRendering]
  8. [Route("/bds/customers")]
  9. public class CustomerList : PartnerList
  10. {
  11. protected override string Type => PartnerType.Customer;
  12. }
  13. public class PartnerList : BaseTablePage<JxPartner>
  14. {
  15. private IBaseDataService Service;
  16. //商业伙伴类型虚拟属性,供应商和客户页面覆写。
  17. protected virtual string Type { get; }
  18. protected override async Task OnPageInitAsync()
  19. {
  20. await base.OnPageInitAsync();
  21. Service = await CreateServiceAsync<IBaseDataService>();
  22. Table.OnQuery = QueryPartnersAsync;
  23. }
  24. public void New() => Table.NewForm(Service.SavePartnerAsync, new JxPartner { Type = Type });
  25. public void DeleteM() => Table.DeleteM(Service.DeletePartnersAsync);
  26. public void Edit(JxPartner row) => Table.EditForm(Service.SavePartnerAsync, row);
  27. public void Delete(JxPartner row) => Table.Delete(Service.DeletePartnersAsync, row);
  28. public void Import() => ShowImportForm();
  29. public async void Export() => await ExportDataAsync();
  30. private Task<PagingResult<JxPartner>> QueryPartnersAsync(PagingCriteria criteria)
  31. {
  32. criteria.SetQuery(nameof(JxPartner.Type), QueryType.Equal, Type);
  33. return Service.QueryPartnersAsync(criteria);
  34. }
  35. }

原文链接:https://www.cnblogs.com/known/p/18317479

 友情链接:直通硅谷  点职佳  北美留学生论坛

本站QQ群:前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

W3xue 的所有内容仅供测试,对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接(目前9元/月)请联系QQ:27243702 沸活量
皖ICP备17017327号-2 皖公网安备34020702000426号