业务流水号规则生成组件

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