Sparkdo.IdGeneration 1.0.3

Sparkdo.IdGeneration

Sparkdo 框架的 ID 生成库，提供多种 ID 生成策略。

功能特性

• 雪花算法 (Snowflake): 基于 Twitter 的雪花算法实现，生成全局唯一的 Long 类型 ID
• 顺序 GUID: 生成顺序 GUID，提高数据库索引性能
• 字符串 ID: 生成基于 Base32 编码的字符串 ID，避免容易混淆的字符
• 可配置: 支持通过配置文件自定义各种参数

安装

dotnet add package Sparkdo.IdGeneration

核心组件

1. 雪花算法 ID 生成器

基于 Twitter 的雪花算法实现，支持以下特性：

• 支持多数据中心部署
• 支持毫秒级和秒级时间戳
• 支持漂移算法和传统算法
• 可配置机器码位长、序列数位长等参数

2. 顺序 GUID 生成器

生成顺序 GUID，可以提高数据库索引性能：

• 支持三种顺序类型：SequentialAsString、SequentialAsBinary、SequentialAtEnd
• 可配置默认顺序类型

3. 字符串 ID 生成器

生成基于 Base32 编码的字符串 ID：

• 使用 Crockford Base32 编码，避免容易混淆的字符 (0, O, I, L)
• 生成固定长度的 26 位字符串 ID

配置文件示例：

{
 "Sparkdo": {
 "IdGeneration": {
 "SnowflakeId": {
 "WorkerId": 1,
 "WorkerIdBitLength": 6,
 "SeqBitLength": 6
 }
 }
 }
}

使用 ID 生成器：

public class MyService
{
 private readonly ILongIdGenerator _longIdGenerator;
 private readonly IGuidGenerator _guidGenerator;
 private readonly IStringIdGenerator _stringIdGenerator;

 public MyService(
 ILongIdGenerator longIdGenerator,
 IGuidGenerator guidGenerator,
 IStringIdGenerator stringIdGenerator)
 {
 _longIdGenerator = longIdGenerator;
 _guidGenerator = guidGenerator;
 _stringIdGenerator = stringIdGenerator;
 }

 public void GenerateIds()
 {
 // 生成雪花 ID
 long snowflakeId = _longIdGenerator.Create();

 // 生成顺序 GUID
 Guid sequentialGuid = _guidGenerator.Create();

 // 生成字符串 ID
 string stringId = _stringIdGenerator.Create();
 }
}

配置选项

雪花算法配置 (SparkdoSnowflakeIdOptions)

• Method: 雪花计算方法（1-漂移算法|2-传统算法），默认1
• BaseTime: 基础时间，不能超过当前系统时间
• WorkerId: 机器码，必须由外部设定
• WorkerIdBitLength: 机器码位长，默认值6
• SeqBitLength: 序列数位长，默认值6
• MaxSeqNumber: 最大序列数，默认值0（表示取最大值）
• MinSeqNumber: 最小序列数，默认值5
• TopOverCostCount: 最大漂移次数，默认2000
• DataCenterId: 数据中心ID，默认0
• DataCenterIdBitLength: 数据中心ID长度，默认0
• TimestampType: 时间戳类型（0-毫秒，1-秒），默认0

顺序 GUID 配置 (SequentialGuidGeneratorOptions)

• DefaultSequentialGuidType: 默认顺序 GUID 类型