流水編號

日常在我們開發的過程中可能會用到編號的功能,如銷售訂單號，採購訂單號,紀錄檔編號，憑證號...等等,為了保證唯一有些表的主鍵要麼用自增長，要麼用GUID值,或通過雪花ID演演算法生成。這此方式基本都能產生唯一的ID，但如果在分散式環境下產生流水ID，以上這幾種方式可能就不太好用，如有以下場景

1. 工作流的流水編號

工作流的編號通常會是以下格式 如2022060200001-2022060299999 到了第二天時尾數又要生00001開始編，這種編號規則有一個好處就是非常直觀的通過工作流編號就可以看出來這是哪一天申請的流程，一天大概有多少流水碼。那麼如果我們用常規編號規則其實是比較難完成此需求的。

2. 採購訂單號

如在實際業務需求中 標準採購訂單要用5000000000-5999999999 這個號進行進行編碼，委外採購訂單用4000000000-4999999999號段進行編碼

3. XX業務受理單編號

在辦裡某業務時根據業務型別使用不同的編號 如財務收款用的流水號是 SK10000000-SK99999999，支出用的是ZC10000000-ZC99999999

根據以上的業務場景如果使用常規的編號是比較難實現的（要保證分散式環境編號不重複且按流水編碼），那麼HiSql 提供了比較方便的解決方案

該版本還未正式更新nuget 需要使用請下載原始碼

• HiSql 原始碼(github) https://github.com/tansar/HiSql
• HiSql 原始碼(gitee) https://gitee.com/tansar/HiSql

怎樣開啟編號規則

  //如果需要使用編號那麼一定要開啟此功能
  HiSql.Global.SnroOn = true;


  //開啟編號後進行初始化  
  sqlClient.CodeFirst.InstallHisql();//僅需執行一次 如果使用的低版本的HiSql 升級參照包手需要重新初始化安裝

初始安裝完成後會生成表Hi_Snro 這個編號設定表

編號設定介紹

Hi_Snro 表詳細說明

PreType 前置編號型別設定

在PreType 是一個列舉類

根據以上設定規則將資料設定到表中

設定樣例

Hi_Snro 的設定可以自行做個設定介面進行設定，以下是通過程式進行設定儲存.

  List<Hi_Snro> list = new List<Hi_Snro>();

  ///工作流編號設定
  ///按天產生流水號 如2205061000000-2205069999999 之間

  list.Add( new Hi_Snro { SNRO = "WFNO", SNUM = 1, IsSnow = false, SnowTick = 0, StartNum = "1000000", EndNum = "9999999", Length = 7, CurrNum = "1000000", IsNumber = true, PreType=PreType.Y2MD, FixPreChar="", IsHasPre = true, CacheSpace = 5, Descript = "工作流編號" });

  ///生成銷售訂單編碼 每分鐘從0開始編號 如20220602145800001-20220602145899999
  list.Add(new Hi_Snro{ SNRO = "SALENO", SNUM = 1, IsSnow = false, SnowTick = 0, StartNum = "10000", EndNum = "99999", Length = 5, CurrNum = "10000", IsNumber = true, PreType = PreType.YMDHm, FixPreChar = "", IsHasPre = true, CacheSpace = 10, Descript = "銷售訂單號流水" });
  ///生成另外一種銷售訂單編碼 年的是取後兩位 按每秒順序生成 如22060214581200001-22060214581299999
  list.Add(new Hi_Snro { SNRO = "SALENO", SNUM = 2, IsSnow = false, SnowTick = 0, StartNum = "10000", EndNum = "99999", Length = 5, CurrNum = "10000", IsNumber = true, PreType = PreType.Y2MDHms, FixPreChar = "", IsHasPre = true, CacheSpace = 10, Descript = "銷售訂單號流水" });


  ///通過雪花ID生成
  list.Add( new Hi_Snro { SNRO = "Order", SNUM = 1, IsSnow=true, SnowTick=145444, StartNum = "", EndNum = "",Length=7, CurrNum = "", IsNumber = true, IsHasPre = false, CacheSpace = 10, Descript = "訂單號雪花ID" });


  //儲存設定到表中
  sqlClient.Modi("Hi_Snro", list).ExecCommand();

編號生成程式碼環境設定

建議把SeriNumber 做成一個局靜態變數

  public static SeriNumber number = null;  //定義個全域性變更的流水號物件

設定連線

  //sqlClient 為資料庫連線物件
  number = new SeriNumber(sqlClient);

如果應用進行了分散式佈署 請一定要啟用以下程式碼

  HiSql.Global.RedisOn = true;//開啟redis快取
  HiSql.Global.RedisOptions = new RedisOptions { Host = "172.16.80.178", PassWord = "qwe123", Port = 6379, CacheRegion = "HRM", Database = 2 };



  HiSql.Global.NumberOptions.MultiMode= true;


  //如果部署了分散式且也要生成雪花ID 一定要設定以下當前應用的ID 多個應用間只要不重複即可0-31之間
  HiSql.Global.NumberOptions.WorkId=1;

通過以上設定則分散式編號環境設定完成，下面就可以進行編號測試了

編號測試

為了測試編號是否有重複我這裡建了一個測試記錄表H_nlog ，編號生成完成後可以分析該表的資料看是否有重複資料，（測試環境 為SqlServer） sql程式碼如下

  SET ANSI_NULLS ON
  GO

  SET QUOTED_IDENTIFIER ON
  GO

  CREATE TABLE [dbo].[H_nlog](
    [Nid] [int] IDENTITY(1,1) NOT NULL,
    [Numbers] [varchar](50) NULL,
    [CreateTime] [datetime] NULL,
    [CreateName] [nvarchar](50) NULL,
    [ModiTime] [datetime] NULL,
    [ModiName] [nvarchar](50) NULL,
  CONSTRAINT [PK_H_nlog] PRIMARY KEY CLUSTERED 
  (
    [Nid] ASC
  )WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
  ) ON [PRIMARY]
  GO

  ALTER TABLE [dbo].[H_nlog] ADD  CONSTRAINT [DF_H_nlog_CreateTime]  DEFAULT (getdate()) FOR [CreateTime]
  GO

  ALTER TABLE [dbo].[H_nlog] ADD  CONSTRAINT [DF_H_nlog_CreateName]  DEFAULT ('') FOR [CreateName]
  GO

  ALTER TABLE [dbo].[H_nlog] ADD  CONSTRAINT [DF_H_nlog_ModiTime]  DEFAULT (getdate()) FOR [ModiTime]
  GO

  ALTER TABLE [dbo].[H_nlog] ADD  CONSTRAINT [DF_H_nlog_ModiName]  DEFAULT ('') FOR [ModiName]
  GO

  EXEC sys.sp_addextendedproperty @name=N'MS_Description', @value=N'建立時間' , @level0type=N'SCHEMA',@level0name=N'dbo', @level1type=N'TABLE',@level1name=N'H_nlog', @level2type=N'COLUMN',@level2name=N'CreateTime'
  GO

  EXEC sys.sp_addextendedproperty @name=N'MS_Description', @value=N'建立人' , @level0type=N'SCHEMA',@level0name=N'dbo', @level1type=N'TABLE',@level1name=N'H_nlog', @level2type=N'COLUMN',@level2name=N'CreateName'
  GO

  EXEC sys.sp_addextendedproperty @name=N'MS_Description', @value=N'修改時間' , @level0type=N'SCHEMA',@level0name=N'dbo', @level1type=N'TABLE',@level1name=N'H_nlog', @level2type=N'COLUMN',@level2name=N'ModiTime'
  GO

  EXEC sys.sp_addextendedproperty @name=N'MS_Description', @value=N'修改人' , @level0type=N'SCHEMA',@level0name=N'dbo', @level1type=N'TABLE',@level1name=N'H_nlog', @level2type=N'COLUMN',@level2name=N'ModiName'
  GO

根據編號規則WFNO 子編號1 生成編號

  List<object> lst = new List<object>();
  for (int i = 0; i < 1000; i++)
  {
      var num = number.NewNumber("WFNO", 1);
      lst.Add(new { Numbers = num });
      Console.WriteLine(num);
  }

    sqlClient.Insert("H_nlog", lst).ExecCommand();

測試結果

啟用了分散式多個應用同時對同一個編號規則產生編號不會產生重複編號。