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
}
}