using HslCommunication.Core; using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading; namespace HslCommunication.BasicFramework { /******************************************************************************************** * * 一个高度灵活的流水号生成的类,允许根据指定规则加上时间数据进行生成 * * 根据保存机制进行优化,必须做到好并发量 * ********************************************************************************************/ /// /// 一个用于自动流水号生成的类,必须指定保存的文件,实时保存来确认安全 /// /// /// /// 序号生成器软件,当获取序列号,清空序列号操作后,会自动的将ID号存储到本地的文件中,存储方式采用乐观并发模型实现。 /// /// /// /// 此处举个例子,也是Demo程序的源代码,包含了2个按钮的示例和瞬间调用100万次的性能示例。 /// 百万次调用的实际耗时取决于计算机的性能,不同的计算机的表现存在差异,比如作者的:i5-4590cpu,内存ddr3-8G表示差不多在800毫秒左右 /// /// public sealed class SoftNumericalOrder : SoftFileSaveBase { #region Constructor /// /// 实例化一个流水号生成的对象 /// /// 流水号的头文本 /// 流水号带的时间信息 /// 流水号数字的标准长度,不够补0 /// 流水号存储的文本位置 public SoftNumericalOrder( string textHead, string timeFormate, int numberLength, string fileSavePath ) { LogHeaderText = "SoftNumericalOrder"; TextHead = textHead; TimeFormate = timeFormate; NumberLength = numberLength; FileSavePath = fileSavePath; LoadByFile( ); AsyncCoordinator = new HslAsyncCoordinator( ( ) => { if (!string.IsNullOrEmpty( FileSavePath )) { using (System.IO.StreamWriter sw = new System.IO.StreamWriter( FileSavePath, false, Encoding.Default )) { sw.Write( CurrentIndex ); } } } ); } #endregion #region Private Member /// /// 当前的生成序列号 /// private long CurrentIndex = 0; /// /// 流水号的文本头 /// private string TextHead = string.Empty; /// /// 时间格式默认年月日 /// private string TimeFormate = "yyyyMMdd"; /// /// 流水号数字应该显示的长度 /// private int NumberLength = 5; #endregion #region Public Method /// /// 获取流水号的值 /// /// 字符串信息 public override string ToSaveString( ) { return CurrentIndex.ToString( ); } /// /// 加载流水号 /// /// 源字符串信息 public override void LoadByString( string content ) { CurrentIndex = Convert.ToInt64( content ); } /// /// 清除流水号计数,进行重新计数 /// public void ClearNumericalOrder( ) { Interlocked.Exchange( ref CurrentIndex, 0 ); AsyncCoordinator.StartOperaterInfomation( ); } /// /// 获取流水号数据 /// /// 新增计数后的信息 public string GetNumericalOrder( ) { long number = Interlocked.Increment( ref CurrentIndex ); AsyncCoordinator.StartOperaterInfomation( ); if (string.IsNullOrEmpty( TimeFormate )) { return TextHead + number.ToString( ).PadLeft( NumberLength, '0' ); } else { return TextHead + DateTime.Now.ToString( TimeFormate ) + number.ToString( ).PadLeft( NumberLength, '0' ); } } /// /// 获取流水号数据 /// /// 指定一个新的文本头 /// 带头信息的计数后的信息 public string GetNumericalOrder( string textHead ) { long number = Interlocked.Increment( ref CurrentIndex ); AsyncCoordinator.StartOperaterInfomation( ); if (string.IsNullOrEmpty( TimeFormate )) { return textHead + number.ToString( ).PadLeft( NumberLength, '0' ); } else { return textHead + DateTime.Now.ToString( TimeFormate ) + number.ToString( ).PadLeft( NumberLength, '0' ); } } /// /// 单纯的获取数字形式的流水号 /// /// 新增计数后的信息 public long GetLongOrder( ) { long number = Interlocked.Increment( ref CurrentIndex ); AsyncCoordinator.StartOperaterInfomation( ); return number; } #endregion #region High Performance Save /// /// 高性能存储块 /// private HslAsyncCoordinator AsyncCoordinator = null; #endregion } /// /// 一个简单的不持久化的序号自增类,采用线程安全实现,并允许指定最大数字,将包含该最大值,到达后清空从指定数开始 /// public sealed class SoftIncrementCount : IDisposable { #region Constructor /// /// 实例化一个自增信息的对象,包括最大值 /// /// 数据的最大值,必须指定 /// 数据的起始值,默认为0 public SoftIncrementCount( long max, long start = 0 ) { this.start = start; this.max = max; current = start; hybirdLock = new SimpleHybirdLock( ); } #endregion #region Private Member private long start = 0; private long current = 0; private long max = long.MaxValue; private SimpleHybirdLock hybirdLock; #endregion #region Public Method /// /// 获取自增信息 /// /// 计数自增后的值 public long GetCurrentValue( ) { long value = 0; hybirdLock.Enter( ); value = current; current += IncreaseTick; if (current > max) { current = start; } hybirdLock.Leave( ); return value; } /// /// 重置当前序号的最大值 /// /// 最大值 public void ResetMaxNumber(long max ) { hybirdLock.Enter( ); if (max > start) { if (max < current) current = start; this.max = max; } hybirdLock.Leave( ); } #endregion #region Public Properties /// /// 增加的单元,如果设置为0,就是不增加。注意,不能小于0 /// public int IncreaseTick { get; set; } = 1; #endregion #region Object Override /// /// 返回表示当前对象的字符串 /// /// 返回具体的值信息 public override string ToString( ) { return $"SoftIncrementCount[{this.current}]"; } #endregion #region IDisposable Support private bool disposedValue = false; // 要检测冗余调用 void Dispose( bool disposing ) { if (!disposedValue) { if (disposing) { // TODO: 释放托管状态(托管对象)。 hybirdLock.Dispose( ); } // TODO: 释放未托管的资源(未托管的对象)并在以下内容中替代终结器。 // TODO: 将大型字段设置为 null。 disposedValue = true; } } // TODO: 仅当以上 Dispose(bool disposing) 拥有用于释放未托管资源的代码时才替代终结器。 // ~SoftIncrementCount() { // // 请勿更改此代码。将清理代码放入以上 Dispose(bool disposing) 中。 // Dispose(false); // } // 添加此代码以正确实现可处置模式。 /// /// 释放当前对象所占用的资源 /// public void Dispose( ) { // 请勿更改此代码。将清理代码放入以上 Dispose(bool disposing) 中。 Dispose( true ); // TODO: 如果在以上内容中替代了终结器,则取消注释以下行。 // GC.SuppressFinalize(this); } #endregion } }