业务流水号规则生成组件

article/2025/11/8 16:27:20

对于很多业务系统都需要生成业务流水号，如果订单号、购采单号等等；而这些业务流水号并不是简单的一个增长数值，它们很多时候都有一些不同的规则来定义，如不同类型的字母或地区拼音简写等。为了更灵活生成这些有规则的业务流水号BeetleX提供对应的组件，接下来简单介绍一下组件的使用。

首先需要通过Nuget引用BeetleX.BNR组件，然后通过以下方法即可以生业务流水号

for (int i = 0; i < 10; i++)
{var number = await BNRFactory.Default.Create("[CN:广州][D:yyyyMMdd][N:[D:yyyyMMdd]/000000]");Console.WriteLine(number);
}

那个规则看上去好像很复杂，不过先看一下结果输出是怎样的

GZ20220520000008
GZ20220520000009
GZ20220520000010
GZ20220520000011
GZ20220520000012
GZ20220520000013
GZ20220520000014
GZ20220520000015
GZ20220520000016
GZ20220520000017

以上流水号规则是[广州拼间首字母]+[年月日]+[基于年月日为标识的6位自增量]。

组件提供的规则是由表达式组成，规则可以根据需求定义多个表达式；表达式的编写方式是[表达式函数:参数]。接下来介绍一下组件提供的基础表达式

[CN:中文]

返回对应中文信息拼间首字线大写

[N:标识/填充格式]

根据标识来生成对应自增量的数字

[D:日期格式]

根据日期输出当前日期

[S:字符]

输出一个指定的字符

有了上面的描述，接下来定义一个简单的规则

[CN:广州][D:yyyyMMdd]

相信对应回上面的表达式应该能知道结果了。

自定义表达式

组件默认提供的表达式有限，但可以根据实际需求来制定一个表达式，可以通过查看一个默认的表达式相信更容易理解

/// <summary>/// {D:yyyyMMdd}/// </summary>[ParameterType("D")]public class DateParameterHandler : IParameterHandler{public Task Execute(StringBuilder sb, string value){sb.Append(DateTime.Now.ToString(value));return Task.CompletedTask;}public BNRFactory Factory{get;set;}}

以上是日期输出的表达式。

使用Redis自增

组件虽然提供了一个自增量的表达式，但存在一个问题就是不同服务之间是无法同步的；通过借助于Reids的自增函数就能实现不同服务中生成唯一的自增数。虽然这个表达式组件集成了，但并没有直接引入到默认表达式模块中，需要使用者单独引入

DefaultRedis.Instance.Host.AddWriteHost("localhost");
BNRFactory.Default.Register("redis", new RedisSequenceParameter(DefaultRedis.Instance));
var number = await BNRFactory.Default.Create("[CN:广州][redis:[D:yyyy]/000000]");

根据需要注册一个表达式名称即可使用。这个Redis的自增表达式实现也非常简单

public class RedisSequenceParameter : IParameterHandler{public RedisSequenceParameter(Redis.RedisDB db){mRedisDB = db;}private Redis.RedisDB mRedisDB;public BNRFactory Factory { get; set; }public async Task Execute(StringBuilder sb, string value){string[] properties = value.Split('/');StringBuilder key = new StringBuilder();string[] items = RuleAnalysis.Execute(properties[0]);foreach (string p in items){string[] sps = RuleAnalysis.GetProperties(p);IParameterHandler handler = null;if (Factory.Handlers.TryGetValue(sps[0], out handler)){await handler.Execute(key, sps[1]);}}var redisKey = key.ToString();var number = await mRedisDB.Incr(redisKey);sb.Append(number.ToString(properties[1]));}}

示例代码:

https://github.com/beetlex-io/BeetleX-Samples/tree/master/BeetleX.BNR.App