+ USnowflakeID：增加雪花ID

SunnyUI/SunnyUI.csproj

@@ -399,6 +399,7 @@
     <Compile Include="Controls\UIToolTip.cs">
       <SubType>Component</SubType>
     </Compile>
+    <Compile Include="Units\USnowflakeID.cs" />
     <Compile Include="Units\UThunder.cs" />
     <Compile Include="Controls\UILine.cs">
       <SubType>Component</SubType>

SunnyUI/Units/USnowflakeID.cs

@@ -0,0 +1,250 @@
+/******************************************************************************
+ * SunnyUI 开源控件库、工具类库、扩展类库。
+ * CopyRight (C) 2012-2020 ShenYongHua(沈永华).
+ * QQ群：56829229 QQ：17612584 EMail：SunnyUI@qq.com
+ *
+ * Blog:   https://www.cnblogs.com/yhuse
+ * Gitee:  https://gitee.com/yhuse/SunnyUI.git
+ * GitHub: https://github.com/yhuse/SunnyUI
+ *
+ * SunnyUI can be used for free under the GPL-3.0 license.
+ * If you use this code, please keep this note.
+ * 如果您使用此代码，请保留此说明。
+ ******************************************************************************
+ * 文件名称: USnowflakeID.cs
+ * 文件说明: 雪花ID
+ * 当前版本: V2.2.0.0
+ * 创建日期: 2020-01-01
+ *
+ * 2020-01-01: V2.2 增加文件说明
+******************************************************************************/
+
+using System;
+using System.Text;
+
+namespace Sunny.UI
+{
+    /*
+     * https://blog.csdn.net/jackpk/article/details/78248351
+     * https://www.cnblogs.com/sunyuliang/
+     * https://www.cnblogs.com/relucent/p/4955340.html
+     * 雪花ID
+     * Twitter_Snowflake
+     * SnowFlake的结构如下(每部分用-分开)
+     * 0 - 0000000000 0000000000 0000000000 0000000000 0 - 00000 - 00000 - 000000000000
+     * 1位标识，由于long基本类型在Java中是带符号的，最高位是符号位，正数是0，负数是1，所以id一般是正数，最高位是0
+     * 41位时间截(毫秒级)，注意，41位时间截不是存储当前时间的时间截，而是存储时间截的差值（当前时间截 - 开始时间截)得到的值），
+     * 41位的时间截，可以使用69年，年T = (1L << 41) / (1000L * 60 * 60 * 24 * 365) = 69
+     * 这里的的开始时间截，一般是我们的id生成器开始使用的时间，由我们程序来指定的（如下下面程序IdWorker类的startTime属性）。
+     * 10位的数据机器位，可以部署在1024个节点，包括5位datacenterId和5位workerId
+     * 12位序列，毫秒内的计数，12位的计数顺序号支持每个节点每毫秒(同一机器，同一时间截)产生4096个ID序号
+     * 总共加起来刚好64位，为一个Long型。
+     * SnowFlake的优点是，整体上按照时间自增排序，并且整个分布式系统内不会产生ID碰撞(由数据中心ID和机器ID作区分)，
+     * 并且效率较高，经测试，SnowFlake单机每秒都能够产生出极限4,096,000个ID来
+     */
+
+    /// <summary>
+    /// 雪花ID
+    /// </summary>
+    public class SnowflakeID
+    {
+        private static SnowflakeID instance;
+
+        public static SnowflakeID Instance => instance ?? (instance = new SnowflakeID());
+
+        // 开始时间截 (new DateTime(2020, 1, 1).ToUniversalTime() - Jan1st1970).TotalMilliseconds
+        private const long twepoch = 1577808000000L;
+
+        // 机器id所占的位数
+        private const int workerIdBits = 5;
+
+        // 数据标识id所占的位数
+        private const int datacenterIdBits = 5;
+
+        // 支持的最大机器id，结果是31 (这个移位算法可以很快的计算出几位二进制数所能表示的最大十进制数)
+        private const long maxWorkerId = -1L ^ (-1L << workerIdBits);
+
+        // 支持的最大数据标识id，结果是31
+        private const long maxDatacenterId = -1L ^ (-1L << datacenterIdBits);
+
+        // 序列在id中占的位数
+        private const int sequenceBits = 12;
+
+        // 数据标识id向左移17位(12+5)
+        private const int datacenterIdShift = sequenceBits + workerIdBits;
+
+        // 机器ID向左移12位
+        private const int workerIdShift = sequenceBits;
+
+        // 时间截向左移22位(5+5+12)
+        private const int timestampLeftShift = sequenceBits + workerIdBits + datacenterIdBits;
+
+        // 生成序列的掩码，这里为4095 (0b111111111111 = 0xfff = 4095)
+        private const long sequenceMask = -1L ^ (-1L << sequenceBits);
+
+        // 数据中心ID(0~31)
+        public long DataCenterID { get; }
+
+        // 工作机器ID(0~31)
+        public long WorkerID { get; }
+
+        // 毫秒内序列(0~4095)
+        private long Sequence { get; set; }
+
+        // 上次生成ID的时间截
+        private long LastTimestamp { get; set; }
+
+        /// <summary>
+        /// 雪花ID
+        /// </summary>
+        /// <param name="dataCenterId">数据中心ID</param>
+        /// <param name="workerId">工作机器ID</param>
+        public SnowflakeID(long dataCenterId = 0, long workerId = 0)
+        {
+            if (dataCenterId > maxDatacenterId || dataCenterId < 0)
+            {
+                throw new Exception($"datacenter Id can't be greater than {maxDatacenterId} or less than 0");
+            }
+
+            if (workerId > maxWorkerId || workerId < 0)
+            {
+                throw new Exception($"worker Id can't be greater than {maxWorkerId} or less than 0");
+            }
+
+            WorkerID = workerId;
+            DataCenterID = dataCenterId;
+            Sequence = 0L;
+            LastTimestamp = -1L;
+        }
+
+        /// <summary>
+        /// 获得下一个ID
+        /// </summary>
+        /// <returns></returns>
+        public long NextID()
+        {
+            lock (this)
+            {
+                long timestamp = GetCurrentTimestamp();
+                if (timestamp > LastTimestamp) //时间戳改变，毫秒内序列重置
+                {
+                    Sequence = 0L;
+                }
+                else if (timestamp == LastTimestamp) //如果是同一时间生成的，则进行毫秒内序列
+                {
+                    Sequence = (Sequence + 1) & sequenceMask;
+                    if (Sequence == 0) //毫秒内序列溢出
+                    {
+                        timestamp = GetNextTimestamp(LastTimestamp); //阻塞到下一个毫秒,获得新的时间戳
+                    }
+                }
+                else   //当前时间小于上一次ID生成的时间戳，证明系统时钟被回拨，此时需要做回拨处理
+                {
+                    Sequence = (Sequence + 1) & sequenceMask;
+                    if (Sequence > 0)
+                    {
+                        timestamp = LastTimestamp;     //停留在最后一次时间戳上，等待系统时间追上后即完全度过了时钟回拨问题。
+                    }
+                    else   //毫秒内序列溢出
+                    {
+                        timestamp = LastTimestamp + 1;   //直接进位到下一个毫秒
+                    }
+                    //throw new Exception(string.Format("Clock moved backwards.  Refusing to generate id for {0} milliseconds", LastTimestamp - timestamp));
+                }
+
+                LastTimestamp = timestamp;       //上次生成ID的时间截
+
+                //移位并通过或运算拼到一起组成64位的ID
+                var id = ((timestamp - twepoch) << timestampLeftShift)
+                        | (DataCenterID << datacenterIdShift)
+                        | (WorkerID << workerIdShift)
+                        | Sequence;
+                return id;
+            }
+        }
+
+        /// <summary>
+        /// 解析雪花ID
+        /// </summary>
+        /// <returns></returns>
+        public static SnowflakeIDDetail AnalyzeID(long Id)
+        {
+            DateTime Jan1st1970 = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
+            SnowflakeIDDetail result = new SnowflakeIDDetail();
+            result.SnowflakeID = Id;
+            var timestamp = (Id >> timestampLeftShift);
+            var time = Jan1st1970.AddMilliseconds(timestamp + twepoch);
+            result.DateTime = time.ToLocalTime();
+            result.DataCenterID = (Id ^ (timestamp << timestampLeftShift)) >> datacenterIdShift;
+            result.WorkerID = (Id ^ ((timestamp << timestampLeftShift) | (result.DataCenterID << datacenterIdShift))) >> workerIdShift;
+            result.Sequence = Id & sequenceMask;
+            return result;
+        }
+
+        /// <summary>
+        /// 阻塞到下一个毫秒，直到获得新的时间戳
+        /// </summary>
+        /// <param name="lastTimestamp">上次生成ID的时间截</param>
+        /// <returns>当前时间戳</returns>
+        private static long GetNextTimestamp(long lastTimestamp)
+        {
+            long timestamp = GetCurrentTimestamp();
+            while (timestamp <= lastTimestamp)
+            {
+                timestamp = GetCurrentTimestamp();
+            }
+            return timestamp;
+        }
+
+        /// <summary>
+        /// 获取当前时间戳
+        /// </summary>
+        /// <returns></returns>
+        private static long GetCurrentTimestamp()
+        {
+            DateTime Jan1st1970 = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
+            return (long)(DateTime.UtcNow - Jan1st1970).TotalMilliseconds;
+        }
+    }
+
+    public struct SnowflakeIDDetail
+    {
+        /// <summary>
+        /// 雪花ID
+        /// </summary>
+        public long SnowflakeID;
+
+        /// <summary>
+        /// 时间
+        /// </summary>
+        public DateTime DateTime;
+
+        /// <summary>
+        /// 数据中心ID(0~31)
+        /// </summary>
+        public long DataCenterID;
+
+        /// <summary>
+        /// 工作机器ID(0~31)
+        /// </summary>
+        public long WorkerID;
+
+        /// <summary>
+        /// 毫秒内序列(0~4095)
+        /// </summary>
+        public long Sequence;
+
+        public override string ToString()
+        {
+            StringBuilder sb = new StringBuilder();
+            sb.Append(DateTime.ToString("yyyy-MM-dd HH:mm:ss.fff"));
+            sb.Append(", ");
+            sb.Append(DataCenterID);
+            sb.Append(", ");
+            sb.Append(WorkerID);
+            sb.Append(", ");
+            sb.Append(Sequence);
+            return sb.ToString();
+        }
+    }
+}