本文介紹一個.NET開源工具類庫項目，包含一些常用的操作類，大都是靜態類，加密解密，反射操作，硬件信息，字符串擴展方法，日期時間擴展操作，大文件拷貝，圖像裁剪，驗證碼等常用封裝。
1項目起因
這是我的同事【懶得勤快】從入坑編程多年來的代碼積累，他把一些編程中常用的一些代碼進行了封裝，在后續的任何開發當中使用上它，避免重復地去造一些輪子，把重心轉移到項目的推進，幾乎可以做任何的事情。
他說現在項目中沒了它，寫邏輯代碼還真有點困難。由于C#語言有個其他語言不可替代的特性：擴展方法，所以項目的實現90%以上都是通過擴展方法實現的，方便直接調用。
因此，我們可以看出，雖然他的網名叫【懶得勤快】，實際上，他比大多數人都勤快的多。另外，我司.NET Core項目中的核心工具類庫也主要是引用了眾多這個類庫中的通用方法，很多騷操作都是從這個項目中直接復用的。
2項目簡介
項目包含了日常編程多數的常用封裝，可以說是一個萬能框架，能夠用于任何基于.NET平臺（包括.NET Core）的項目當中。
功能主要覆蓋：
數據庫操作：內存表操作、關系實體映射等；
日期時間常用操作：農歷操作、時間戳操作，時分秒轉換等；
文件操作：大文件操作、文件壓縮與解壓、ini配置文件操作；
硬件操作：獲取電腦各個硬件的性能指標；
html操作：利用C#對html字符串進行“dom”操作，html的XSS凈化、html標簽操作；
日志組件：高并發可用的高性能日志記錄；
多媒體文件操作：圖片的各種處理；
網絡操作：獲取線程內唯一對象、Session和Cookie的擴展、獲取IP地址詳細信息、緩存操作；
NoSQL：僅封裝了redis的常用操作，mongodb的操作類客戶端獨立分開了；
反射操作：各種對對象的字段屬性和方法的快捷方式；
加密安全：對字符串進行的擴展，包含AES、DES、MD5、hash、SHA1、加鹽等；
字符串擴展：包含驗證碼生成、各種與字符串相關的擴展；
Win32API：包含于windows系統接口相關的操作封裝；
全局擴展：包含字符串擴展，類型轉換，委托、循環操作、異步操作、正則等。
項目源代碼托管于github，程序包發布于nuget，目前已有745個star以及30000余次下載，由此也可以說明大伙也挺喜歡這個工具組件的。
github地址（這里僅展示我司的開源社區倉庫地址，他的個人倉庫中的這個項目star數目有745個）：https://github.com/XiLife-OSPC/Masuit.Tools
值得一提的是，這個項目加入了反996的許可，即任何性質的外包公司或996公司需要使用本類庫，請聯系作者進行商業授權！其他企業或個人可隨意使用不受限。
3安裝程序包
.NET Framework ≥4.6.1
PM> Install-Package Masuit.Tools.Net
.NET Core 3.x
PM> Install-Package Masuit.Tools.Core
4特色功能示例
1、檢驗字符串是否是Email、手機號、URL、IP地址、身份證號
bool isEmail="3444764617@qq.com".MatchEmail();bool isInetAddress = "114.114.114.114".MatchInetAddress();bool isUrl = "http://masuit.com".MatchUrl();bool isPhoneNumber = "15205201520".MatchPhoneNumber();bool isIdentifyCard = "312000199502230660".MatchIdentifyCard();// 校驗中國大陸身份證號
2、硬件檢測（僅支持Windows平臺）
float load = SystemInfo.CpuLoad;// 獲取CPU占用率long physicalMemory = SystemInfo.PhysicalMemory;// 獲取物理內存總數long memoryAvailable = SystemInfo.MemoryAvailable;// 獲取物理內存可用率double freePhysicalMemory = SystemInfo.GetFreePhysicalMemory();// 獲取可用物理內存Dictionary<string, string> diskFree = SystemInfo.DiskFree();// 獲取磁盤每個分區可用空間Dictionary<string, string> diskTotalSpace = SystemInfo.DiskTotalSpace();// 獲取磁盤每個分區總大小Dictionary<string, double> diskUsage = SystemInfo.DiskUsage();// 獲取磁盤每個分區使用率double temperature = SystemInfo.GetCPUTemperature();// 獲取CPU溫度int cpuCount = SystemInfo.GetCpuCount();// 獲取CPU核心數IList<string> ipAddress = SystemInfo.GetIPAddress();// 獲取本機所有IP地址string localUsedIp = SystemInfo.GetLocalUsedIP();// 獲取本機當前正在使用的IP地址IList<string> macAddress = SystemInfo.GetMacAddress();// 獲取本機所有網卡mac地址string osVersion = SystemInfo.GetOsVersion();// 獲取操作系統版本RamInfo ramInfo = SystemInfo.GetRamInfo();// 獲取內存信息
3、大文件操作
FileStream fs = new FileStream(@"D:boot.vmdk", FileMode.OpenOrCreate, FileAccess.ReadWrite);{ //fs.CopyToFile(@"D:1.bak");//同步復制大文件 fs.CopyToFileAsync(@"D:1.bak");//異步復制大文件 string md5 = fs.GetFileMD5Async().Result;//異步獲取文件的MD5}
4、HTML的防XSS處理
string html = @"<link href='/Content/font-awesome/css' rel='stylesheet'/> <!--[if IE 7]> <link href='/Content/font-awesome-ie7.min.css' rel='stylesheet'/> <![endif]--> <script src='/Scripts/modernizr'></script> <div id='searchBox' role='search'> <form action='/packages' method='get'> <span class='user-actions'><a href='/users/account/LogOff'>退出</a></span> <input name='q' id='searchBoxInput'/> <input id='searchBoxSubmit' type='submit' value='Submit' /> </form> </div>";string s = html.HtmlSantinizerStandard();//清理后：<div><span><a href="/users/account/LogOff">退出</a></span></div>
5、整理操作系統內存（僅支持Windows）
Windows.ClearMemorySilent();
6、任意禁止轉換
NumberFormater nf = new NumberFormater(36);//內置2-62進制的轉換//NumberFormater nf = new NumberFormater("0123456789abcdefghijklmnopqrstuvwxyz");// 自定義進制字符，可用于生成驗證碼string s36 = nf.ToString(12345678);long num = nf.FromString("7clzi");Console.WriteLine("12345678的36進制是：" + s36); // 7clziConsole.WriteLine("36進制的7clzi是：" + num); // 12345678var bin=12345678.ToBinary(36);//7clzi
7、納秒級性能計數器
HiPerfTimer timer = HiPerfTimer.StartNew();for (int i = 0; i < 100000; i++){ //todo}timer.Stop();Console.WriteLine("執行for循環100000次耗時"+timer.Duration+"s");
double time = HiPerfTimer.Execute(() =>{ for (int i = 0; i < 100000; i++) { //todo }});Console.WriteLine("執行for循環100000次耗時"+time+"s");
8、單機產生唯一有序的短ID
var token=Stopwatch.GetTimestamp().ToBinary(36);var set = new HashSet<string>();double time = HiPerfTimer.Execute(() =>{ for (int i = 0; i < 1000000; i++) { set.Add(Stopwatch.GetTimestamp().ToBinary(36)); }});Console.WriteLine(set.Count==1000000);//TrueConsole.WriteLine("產生100w個id耗時"+time+"s");//1.6639039s
9、產生分布式唯一有序的短ID
var sf = SnowFlake.GetInstance();string token = sf.GetUniqueId();// rcofqodori0wstring shortId = sf.GetUniqueShortId(8);// qodw9728var set = new HashSet<string>();double time = HiPerfTimer.Execute(() =>{ for (int i = 0; i < 1000000; i++) { set.Add(SnowFlake.GetInstance().GetUniqueId()); }});Console.WriteLine(set.Count == 1000000); //TrueConsole.WriteLine("產生100w個id耗時" + time + "s"); //2.6891495s
10、農歷轉換
ChineseCalendar.CustomHolidays.Add(DateTime.Parse("2018-12-31"),"元旦節");//自定義節假日ChineseCalendar today = new ChineseCalendar(DateTime.Parse("2018-12-31"));Console.WriteLine(today.ChineseDateString);// 二零一八年十一月廿五Console.WriteLine(today.AnimalString);// 生肖：狗Console.WriteLine(today.GanZhiDateString);// 干支：戊戌年甲子月丁酉日Console.WriteLine(today.DateHoliday);// 獲取按公歷計算的節假日...
11、LINQ表達式樹擴展
Expression<Func<string, bool>> where1 = s => s.StartsWith("a");Expression<Func<string, bool>> where2 = s => s.Length > 10;Func<string, bool> func = where1.And(where2).Compile();bool b=func("abcd12345678");//trueExpression<Func<string, bool>> where1 = s => s.StartsWith("a");Expression<Func<string, bool>> where2 = s => s.Length > 10;Func<string, bool> func = where1.Or(where2).Compile();bool b=func("abc");// true
12、模板引擎
var tmp = new Template("{{name}}，你好！");tmp.Set("name", "萬金油");string s = tmp.Render();//萬金油，你好！var tmp = new Template("{{one}},{{two}},{{three}}");string s = tmp.Set("one", "1").Set("two", "2").Set("three", "3").Render();// 1,2,3var tmp = new Template("{{name}}，{{greet}}！");tmp.Set("name", "萬金油");string s = tmp.Render();// throw 模版變量{{greet}}未被使用
13、List轉DataTable
var list = new List<MyClass>(){ new MyClass() { Name = "張三", Age = 22 }, new MyClass() { Name = "李四", Age = 21 }, new MyClass() { Name = "王五", Age = 28 }};var table = list.Select(c => new{姓名=c.Name,年齡=c.Age}).ToList().ToDataTable();// 將自動填充列姓名和年齡
14、文件壓縮與解壓
基于.NET Framework
MemoryStream ms = SevenZipCompressor.ZipStream(new List<string>(){ @"D:1.txt", "http://ww3.sinaimg.cn/large/87c01ec7gy1fsq6rywto2j20je0d3td0.jpg",});//壓縮成內存流SevenZipCompressor.Zip(new List<string>(){ @"D:1.txt", "http://ww3.sinaimg.cn/large/87c01ec7gy1fsq6rywto2j20je0d3td0.jpg",}, zip);//壓縮成zipSevenZipCompressor.UnRar(@"D:Downloadtest.rar", @"D:Download");//解壓rarSevenZipCompressor.Decompress(@"D:Downloadtest.tar", @"D:Download");//自動識別解壓壓縮包SevenZipCompressor.Decompress(@"D:Downloadtest.7z", @"D:Download");
基于.NET Core
首先是注入
services.AddSevenZipCompressor(); // Startup.cs中注入Compressor// 構造函數注入private readonly ISevenZipCompressor _sevenZipCompressor;public Test(ISevenZipCompressor sevenZipCompressor){ _sevenZipCompressor = sevenZipCompressor;}
其次使用方式同.NET Framework版
15、FTP客戶端
FtpClient ftpClient = FtpClient.GetAnonymousClient("192.168.2.2");//創建一個匿名訪問的客戶端//FtpClient ftpClient = FtpClient.GetClient("192.168.2.3","admin","123456");// 創建一個帶用戶名密碼的客戶端ftpClient.Delete("/1.txt");// 刪除文件ftpClient.Download("/test/2.txt","D:\test\2.txt");// 下載文件ftpClient.UploadFile("/test/22.txt","D:\test\22.txt",(sum, progress) =>{ Console.WriteLine("已上傳："+progress*1.0/sum);});//上傳文件并檢測進度List<string> files = ftpClient.GetFiles("/");//列出ftp服務端文件列表...
16、加密解密
var enc="123456".MDString();// MD5加密var enc="123456".MDString("abc");// MD5加鹽加密var enc="123456".MDString2();// MD5兩次加密var enc="123456".MDString2("abc");// MD5兩次加鹽加密var enc="123456".MDString3();// MD5三次加密var enc="123456".MDString3("abc");// MD5三次加鹽加密string aes = "123456".AESEncrypt();// AES加密為密文string s = aes.AESDecrypt(); //AES解密為明文string aes = "123456".AESEncrypt("abc");// AES密鑰加密為密文string s = aes.AESDecrypt("abc"); //AES密鑰解密為明文string enc = "123456".DesEncrypt();// DES加密為密文string s = enc.DesDecrypt(); //DES解密為明文string enc = "123456".DesEncrypt("abcdefgh");// DES密鑰加密為密文string s = enc.DesDecrypt("abcdefgh"); //DES密鑰解密為明文RsaKey rsaKey = RsaCrypt.GenerateRsaKeys();// 生成RSA密鑰對string encrypt = "123456".RSAEncrypt(rsaKey.PublicKey);// 公鑰加密string s = encrypt.RSADecrypt(rsaKey.PrivateKey);// 私鑰解密
17、實體校驗
public class MyClass{ [IsEmail] public string Email { get; set; } [IsPhone] public string PhoneNumber { get; set; } [IsIPAddress] public string IP { get; set; } [MinValue(0, ErrorMessage = "年齡最小為0歲"), MaxValue(100, ErrorMessage = "年齡最大100歲")] public int Age { get; set; } [ComplexPassword]//密碼復雜度校驗 public string Password { get; set; }}
18、郵件發送
new Email(){ SmtpServer = "smtp.masuit.com",// SMTP服務器 SmtpPort = 25, // SMTP服務器端口 EnableSsl = true,//使用SSL Username = "admin@masuit.com",// 郵箱用戶名 Password = "123456",// 郵箱密碼 Tos = "10000@qq.com,10001@qq.com", //收件人 Subject = "測試郵件",//郵件標題 Body = "你好啊",//郵件內容}.SendAsync(s =>{ Console.WriteLine(s);// 發送成功后的回調});// 異步發送郵件
19、敏感信息掩碼
"13123456789".Mask(); // 131****5678"admin@masuit.com".MaskEmail(); // a****n@masuit.com
20、更多請點擊本文底部“閱讀原文”了解更多通用工具方法接口，解鎖Masuit.Tools的各類騷操作！
