Rafy 框架 - 流水号插件

Rafy 框架又添新成员：流水号插件。本文将解释 Rafy 框架中的流水插件的场景、使用方法。

场景

在开发各类数据库应用系统时，往往需要生成从一开始的流水号，有时还需要按月或者按日进行独立生成，如下面的格式：2016031800000001、2016031800000002……。

设计本插件用于生成上述相应格式的编号。

使用方法

添加插件

1.通过 Nuget Package Manager 搜索并安装 Rafy.SerialNumber 插件。

2.在 DomainApp 中添加该插件；同时，设置该插件所对应的数据库配置名：

class JXCApp : DomainApp
{
    protected override void InitEnvironment()
    {
        //配置插件所对应的数据库配置名。
        Rafy.SerialNumber.SerialNumberPlugin.DbSettingName = "TestDb";

        //添加流水号插件到 Rafy 应用程序集中。
        RafyEnvironment.DomainPlugins.Add(new Rafy.SerialNumber.SerialNumberPlugin());

        base.InitEnvironment();
    }
}

使用插件

1.生成数据库。

该插件中自带两个实体：SerialNumberInfo 、SerialNumberValue ，所以 Rafy 会为其在数据库中添加相应的两张表。

2.添加流水号生成规则。

SerialNumberInfo 表示定义的流水号生成规则信息。而 SerialNumberValue 则表示生成的流水号的具体值。所以要生成流水号，必须先为其定义生成规则。可以使用 SerialNumberController 进行简单的每日规则创建，示例如下：

var controller = DomainControllerFactory.Create<SerialNumberController>();
var sni = controller.CreateDailySerialNumberInfo("流水号规则-1");

CreateDailySerialNumberInfo 方法内部其实非常简单，开发者可以参考以下代码创建新的生成规则，如下：

/// <summary>
/// 创建一个以日期进行分组生成编号的规则，存储到仓库中，并返回。
/// 性能-仓库访问次数：1。
/// </summary>
/// <param name="name"></param>
/// <returns></returns>
public SerialNumberInfo CreateDailySerialNumberInfo(string name, string format = "yyyyMMdd********")
{
    var sni = new SerialNumberInfo
    {
        Name = name,
        TimeGroupFormat = "yyyyMMdd",
        Format = format,
        RollValueStart = 1,
        RollValueStep = 1,
    };

    var infoRepo = RF.Concrete<SerialNumberInfoRepository>();
    infoRepo.Save(sni);

    return sni;
});

3.生成流水号。

使用以下代码生成流水号即可：

var next = controller.GenerateNext("流水号规则-1");
Assert.AreEqual("2016031800000001", next);
next = controller.GenerateNext("流水号规则-1");
Assert.AreEqual("2016031800000002", next);
next = controller.GenerateNext(sni);
Assert.AreEqual("2016031800000002", next);

PS:该文已经纳入《 Rafy 用户手册》中。