WinForm应用实战开发指南 - 如何实现通用业务编码规则生成？

在我们很多应用系统中往往都需要根据实际情况生成一些编码规则如订单号、入库单号、出库单号、退货单号等。有时候根据规则自行增加一个函数来生成处理不过仔细观察后发现它们的编码规则有很大的共通性因此可以考虑使用一些通用的业务编码规则生成从而在系统中统一维护即可本文将介绍如何在WinForm界面中实现通用的业务编码规则生成。PS给大家推荐一个C#开发可以用到的界面组件——DevExpress WinForms它能完美构建流畅、美观且易于使用的应用程序无论是Office风格的界面还是分析处理大批量的业务数据它都能轻松胜任DevExpress新旧版本帮助文档获取可点击这篇文章查看——《界面控件DevExpress v26.1帮助文档大全CHM版本》一、常见单号的业务编码规则刚才我们提到一些编码规则如订单号、入库单号、出库单号、退货单号等等它们都是有大同小异的规则有前缀、有日期的编码、有一些流水号还有一些特殊的规则处理往往就是这些需要协调好流水号的增加处理即可。例如原来在我的CRM业务模块中增加了一个函数用来生成订单号的如下所示。/// summary /// 生成单据号码,编码为XS-{userId}-{yyyyMMdd}-流水号 /// /summary /// returns/returns public async Taskstring GetOrderNo() { string prefix string.Format(XS-{0}-{1}, CurrentApiUser.Id, DateTime.Now.ToString(yyyyMMdd)); //获取当天的记录数量1 DateTime currentDate DateTime.Now.ToString(yyyy-MM-dd).ToDateTime(); //当前日期 //计算条件数量1 int count this.EntityDb.Count(s s.OrderDate currentDate s.OrderDate currentDate.AddDays(1)) 1; //循环检索直到不重复的编号 string number string.Format({0}-{1}, prefix, count); while (true) { var result await CheckNumberExist(number); if (result) { //存在增加1再判断 number string.Format({0}-{1}, prefix, count); } else { break; } } return number; }这里为了增加对流水号的循环判断直到没有重复的即可输出来作为订单号。大多数的编码规则大同小异因此我们可以考虑使用共同的规则进行处理类似通用字典的模块处理。订单编码可以在新建订单的时候生成也可以提供用户手动生成【生成编号】的操作如下界面所示。二、设计通用的业务编码规则我们归纳了一些编码规则基本上也就是前缀日期分隔分隔符后缀流水号这些元素的组合如果需要更加复杂的也可以自行调整接口这里设计一个通用的编码规则对这些元素进行组合配置数据库设计如下所示。根据这些内容使用手工编码或者代码生成工具生成相关的基础代码 可以基于EnterpriseLibrary的框架代码或者基于SqlSugar开发框架的代码最终我们都用于WinForm的界面调用。这里以基于SqlSugar开发框架的代码生成为例。生成后会生成一个相关的业务类实现相关的CRUD接口如下代码定义所示如果你有自己的基础框架实现那么也可以忽略具体的代码生成关注业务编码的生成的的规则即可。/// summary /// 业务表编码规则 应用层服务接口实现 /// /summary public class TableNumberService : MyCrudServiceTableNumberInfo, string, TableNumberPagedDto, ITableNumberService为了控制编码的规则生成我们增加一个同步锁来实现冲突处理。/// summary /// 同步锁 /// /summary private static SemaphoreSlim syncRoot new SemaphoreSlim(1);最终我们的实现代码如下所示。/// summary /// 根据定义表名、单据头、分割符1、分割符2生成业务编码。如果生成错误返回空字符串 /// /summary /// param nametableNameOrCode表名或代码/param /// returns/returns public async Taskstring GenerateNumber(string tableNameOrCode) { string businessNumber ; await syncRoot.WaitAsync(); //等待锁 try { var info await base.GetFirstAsync(s s.TableName tableNameOrCode || s.Code tableNameOrCode); if (info ! null) { string currentDate ; string lastDate ; int currentNumber 1; //流水号起始值 int serialLength 3; //流水号长度 if(!info.LastGenerateTime.HasValue) { info.LastGenerateTime DateTime.Now; } if (info.RuleFormat 年月日) { currentDate DateTime.Now.ToString(yyyyMMdd); lastDate info.LastGenerateTime.Value.ToString(yyyyMMdd); } else if (info.RuleFormat 年月) { currentDate DateTime.Now.ToString(yyyyMM); lastDate info.LastGenerateTime.Value.ToString(yyyyMM); } //如果当前日期和最后日期不一致流水号重置为0 if(!currentDate.Equals(lastDate)) { info.CurrentValue 0; } //如果流水号非起始值那么累计计算 if(info.CurrentValue.HasValue info.CurrentValue 0) { currentNumber (int)info.CurrentValue 1;//流水号当前值 } //流水号长度 if(info.ValueLength.HasValue info.ValueLength 3) { serialLength (int)info.ValueLength;//流水号长度 } var SplitString1 string.IsNullOrEmpty(info.SplitString1) ? - : info.SplitString1; var SplitString2 string.IsNullOrEmpty(info.SplitString2) ? - : info.SplitString2; //生成业务编码 businessNumber ${info.Prex}{SplitString1}{currentDate}{SplitString2}{currentNumber.ToString().PadLeft(serialLength, 0)}{info.Suffix}; //更新记录 info.CurrentValue currentNumber; info.SplitString1 SplitString1; info.SplitString2 SplitString2; info.CurrentNumberString businessNumber; info.LastGenerateTime DateTime.Now;//更新最后生成编码日期 await base.UpdateAsync(info); } } catch (Exception ex) { var errorText $生成单号时出现错误{ex.Message}; LogTextHelper.Error(errorText, ex); } finally { syncRoot.Release();//释放锁 } return businessNumber; }上面主要注意的就是流水号的生成这个稍微特殊处理一下如果定义的规则是年月日那么和最后的生成日期和当前日期不一致的话转换为年月日对比就认为流水号重新重置为1否则是同一天的流水号递增即可。如果是年月的也是判断最后日期和当前日期的年月是否一致不一致则重置为1否则递增。注意流水号的编码长度一般为4位如果不满足的可以增加到6位等。最终我们实际的业务编码的管理界面和查看的对应编码的界面如下所示供参考设计界面处理。编辑单个业务编码规则的界面如下所示。为了方便我们这里提供一个【测试生成】的按钮用于测试具体的编码生成我们具体的业务调用就是类似这个调用即可。var handNo await BLLFactoryITableNumberService.Instance.GenerateNumber(tableNameOrCode);同样我们也可以把这个界面搬到WPF框架界面上去可以重用具体的业务编码规则处理如上类似的界面处理。单个通用的业务编码规则的编辑界面如下所示。因此不管对于Winform还是WPF的界面他们的展示方式都是类似的我们可以重用业务层对通用编码规则的定义。本文转载自博客园 - 伍华聪