# Utility **Repository Path**: Sean-Lu/Utility ## Basic Information - **Project Name**: Utility - **Description**: Library of utility methods. - **Primary Language**: C# - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2023-01-18 - **Last Updated**: 2025-10-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: Security, utility, Snowflake ## README ## 简介 > `Ctrl + C`, `Ctrl + V` ??? 没必要重复搬砖，做点更加有意义的事情吧！！！ ## Packages | Package | NuGet Stable | NuGet Pre-release | Downloads | | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | [Sean.Utility](https://www.nuget.org/packages/Sean.Utility/) | [![Sean.Utility](https://img.shields.io/nuget/v/Sean.Utility.svg)](https://www.nuget.org/packages/Sean.Utility/) | [![Sean.Utility](https://img.shields.io/nuget/vpre/Sean.Utility.svg)](https://www.nuget.org/packages/Sean.Utility/) | [![Sean.Utility](https://img.shields.io/nuget/dt/Sean.Utility.svg)](https://www.nuget.org/packages/Sean.Utility/) | ## Sean.Utility | Class | 说明 | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Sean.Utility.Impls.Log.SimpleLocalLogger` | **`日志`**，支持输出格式：
1. Console：控制台输出
2. 本地文件：`SimpleLocalLoggerBase.LogFilePath`
3. 自定义输出：`SimpleLocalLoggerBase.CustomOutputLog` | | `Sean.Utility.Impls.Queue.SimpleQueue` | **`队列`**，仅支持本地队列，无中间件 | | `Sean.Utility.Impls.Queue.SimpleLocalMQ` | 线程安全的 **`本地消息队列`**：
1. 支持多线程下的生产者\消费者模式
2. 支持多生产者、多消费者 | | `Sean.Utility.Serialize.JsonSerializer` | json序列化\反序列化 | | `Sean.Utility.Serialize.XmlSerializer` | XML序列化\反序列化 | | `Sean.Utility.Serialize.BinarySerializer` | 二进制序列化\反序列化 | | `Sean.Utility.IO.XmlHelper` | XML文件操作 | | `Sean.Utility.CmdHelper` | 1. 执行指定的cmd命令
2. 应用程序分配或附加控制台 | | `Sean.Utility.Net.FileShareHelper` | 访问网络共享文件夹（基于磁盘映射） | - Nuget包从 `2.1.0` 版本开始，去除了对第三方Nuget包 `Newtonsoft.Json` 的依赖： ``` 内置 `JsonSerializer` （基于 `DataContractJsonSerializer` 实现）。 引用第三方Nuget包后，可自定义实现 `IJsonSerializer` 接口。 使用示例1：依赖注入 services.AddTransient(); services.AddTransient(); 使用示例2：JsonHelper JsonHelper.Serializer = NewJsonSerializer.Instance; JsonHelper.Serialize(obj); ``` - [Json.NET vs .NET Serializers](https://www.newtonsoft.com/json/help/html/jsonnetvsdotnetserializers.htm) - `Json.NET`：`Newtonsoft.Json` - `DataContractJsonSerializer`：`System.Runtime.Serialization.Json` - `JavaScriptSerializer`：`System.Web.Script.Serialization` ### Security > 支持常见的加解密：Base64、Hex、Hash、AES、DES、TripleDES、RC2、RC4、RSA | Class | 描述 | | ------------------------- | ----------------------------------------------------------------------- | | `Base64CryptoProvider` | 编码\解码：`Base64` | | `HexCryptoProvider` | 编码\解码：`16进制` | | `HashCryptoProvider` | 单向散列算法(**`哈希`**)：`MD5`、`SHA1`、`SHA256`、`SHA384`、`SHA512` | | `AESCryptoProvider` | 对称加密算法：`AES` | | `DESCryptoProvider` | 对称加密算法：`DES` | | `TripleDESCryptoProvider` | 对称加密算法：`TripleDES`(3DES) | | `RC2CryptoProvider` | 对称加密算法：`RC2` | | `RC4CryptoProvider` | 对称加密算法：`RC4` | | `RSACryptoProvider` | 非对称加密算法：`RSA` | - `Base64`是一种基于 64 个可打印字符来表示二进制数据的编码方法。 - `AES`(Advanced Encryption Standard， 高级加密标准)，是目前对称密钥加密中比较通用的一种加密方式。速度快，安全级别高，支持 128、192、256、512 位密钥的加密。 - `RSA`签名算法是一种非对称算法，`RSA`密钥包括公钥和私钥两部分，公钥是公开信息，私钥是保密信息。私钥用于签名，公钥用于验签。 - `RSACryptoProvider`： ``` 支持2种密钥类型：Xml、OpenSSL 支持跨平台：Windows, Linux, Mac, ...，但需要注意： 1. 如果使用 .NET Framework 的版本小于4.6，默认使用 System.Security.Cryptography.RSACryptoServiceProvider，这个类并不支持跨平台，在 Windows 上运行正常，但是在 Linux 下运行就会报错（编译不会报错）。 2. 如果在非 Windows 平台下使用 RSACryptoProvider ，建议升级 .NET Framework 的版本（>=4.6），或使用 .NET Core 。 3. 在`Windows`平台下没有以上问题。 ``` ### SnowFlake > `SnowFlake`(雪花算法)是`Twitter`开源的分布式ID生成算法。其核心思想就是：使用一个64位的long类型的数字作为全局唯一id。 > > 使用场景：主要用于分布式系统中，生成全局唯一的id，如：订单号等。 1. 自增ID：对于数据敏感场景不宜使用，且不适合于分布式场景。 2. GUID：采用无意义字符串，数据量增大时造成访问过慢，且不宜排序。 3. SnowFlake： ![snowflake](https://github.com/Sean-Lu/Utility/blob/master/docs/images/snowflake.png) ``` 0 - 41位时间戳 - 5位数据中心标识 - 5位机器标识 - 12位序列号 最高位是符号位，始终为0，不可用。 41位的时间戳（精确到毫秒，41位的长度可使用69年） 10位的机器ID（10位长度最多支持1024个服务器节点部署） 12位的计数序列号（序列号即一系列的自增id，可以支持同一节点同一毫秒生成多个ID序号，12位支持每节点每毫秒最多生成4096个序列号） ``` - 优点： ``` 1. 生成的ID整体上按照时间自增排序，并且整个分布式系统内不会产生ID碰撞（由datacenterId和workerId作区分）。 2. 基于二进制运算，生成效率较高（据说：snowflake每秒能够产生26万个ID）。 3. 算法实现简单，还可根据实际业务场景对算法做微调（位数）。 ``` - 缺点： ``` 1. 强依赖时钟，如果主机时间回拨，则可能会造成重复ID（需要主动抛出异常）。 2. ID虽然有序，但是不连续（只要没有强迫症，似乎不是什么问题，毕竟保证ID全局唯一才是重点）。 snowflake现在有较好的改良方案，比如美团点评开源的分布式ID框架：leaf，通过使用ZooKeeper解决了时钟依赖问题。 ``` ### Job | Class | 描述 | | ------------------------- | -------------------------- | | `SimpleJobScheduler` | 简单定时任务 | | `CronJobScheduler` | 支持`Cron`表达式的定时任务 | ## Sean.Utility.Web ## Sean.Utility.WindowsForms