Anit.Sequence.Abstractions 10.0.0.2

Anit.Sequence.Abstractions

Anit.Sequence.Abstractions 是一个序列号生成器的抽象接口库，提供了统一的序列号生成标准，支持各种序列号生成场景，如简单序列号、每日序列号和格式化序列号等。

功能特性

• 提供统一的序列号生成接口定义
• 支持多种序列号生成模式

安装

通过 NuGet 包管理器安装：

Install-Package Anit.Sequence.Abstractions

接口说明

IAnitSequenceGenerator 是核心接口，定义了序列号生成的标准方法：

public interface IAnitSequenceGenerator
{
    /// <summary>
    /// 获取下一个序列号
    /// </summary>
    /// <param name="sequenceCode">序列代码</param>
    /// <returns>序列号</returns>
    Task<int> NextNumberAsync(string sequenceCode);

    /// <summary>
    /// 获取下一个每日序列号
    /// </summary>
    /// <param name="sequenceCode">序列代码</param>
    /// <param name="dateFormat">日期格式</param>
    /// <returns>每日序列号</returns>
    Task<int> NextDailyNumberAsync(string sequenceCode, string dateFormat = "yyMMdd");

    /// <summary>
    /// 获取下一个格式化序列号
    /// </summary>
    /// <param name="sequenceCode">序列代码</param>
    /// <param name="dateFormat">日期格式</param>
    /// <param name="numberLength">数字长度</param>
    /// <returns>格式化序列号</returns>
    Task<string> NextSerialNumberAsync(string sequenceCode, string dateFormat = "yyMMdd", int numberLength = 5);

    /// <summary>
    /// 批量获取序列号
    /// </summary>
    /// <param name="count">获取数量</param>
    /// <param name="sequenceCode">序列代码</param>
    /// <returns>序列号数组</returns>
    Task<int[]> NextNumbersAsync(int count, string sequenceCode);

    /// <summary>
    /// 批量获取每日序列号
    /// </summary>
    /// <param name="count">获取数量</param>
    /// <param name="sequenceCode">序列代码</param>
    /// <param name="dateFormat">日期格式</param>
    /// <returns>每日序列号数组</returns>
    Task<int[]> NextDailyNumbersAsync(int count, string sequenceCode, string dateFormat = "yyMMdd");

    /// <summary>
    /// 批量获取格式化序列号
    /// </summary>
    /// <param name="count">获取数量</param>
    /// <param name="sequenceCode">序列代码</param>
    /// <param name="dateFormat">日期格式</param>
    /// <param name="numberLength">数字长度</param>
    /// <returns>格式化序列号数组</returns>
    Task<string[]> NextSerialNumbersAsync(int count, string sequenceCode, string dateFormat = "yyMMdd", int numberLength = 5);
}

已有的实现

• Anit.Sequence.Redis.CSRedis：基于 Redis 的序列号生成器实现
• Anit.Sequence.Redis.StackExchangeRedis：基于 StackExchange.Redis 的序列号生成器实现
• 本项目提供了默认的基于字典的序列号生成器实现 DefaultAnitSequenceGenerator，用于处理单元测试，不可用于生产环境。

使用场景

这个抽象接口适用于以下场景：

1. 需要生成订单号、流水号等唯一标识符的系统
2. 需要按日期分组的序列号生成
3. 需要格式化序列号（包含日期、固定前缀等）的业务场景
4. 需要高性能批量生成序列号的场景