业务流水号规则生成组件

Posted 2022-05-25 dotNET跨平台

        对于很多业务系统都需要生成业务流水号，如果订单号、购采单号等等；而这些业务流水号并不是简单的一个增长数值，它们很多时候都有一些不同的规则来定义，如不同类型的字母或地区拼音简写等。为了更灵活生成这些有规则的业务流水号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

BeetleX

开源跨平台通讯框架(支持TLS)

提供HTTP,Websocket,Redis,RPC和服务网关开源组件

https://beetlex-io.com