开源地址:
https://gitee.com/masuit/Masuit.Tools
包含一些常用的操作类,大都是静态类,加密解密,反射操作,动态编译,权重随机筛选算法,简繁转换,分布式短id,表达式树,linq扩展,文件压缩,多线程下载和FTP客户端,硬件信息,字符串扩展方法,日期时间扩展操作,中国农历,大文件拷贝,图像裁剪,验证码,断点续传,实体映射、集合扩展等常用封装。
建议开发环境
操作系统:Windows 10 1903及以上版本
开发工具:VisualStudio2019 v16.5及以上版本
SDK:.Net Core 3.1.0及以上版本
安装程序包
.NET Framework ≥4.6.1
PM> Install-Package Masuit.Tools.Net
.NET Core 2.x/3.x
PM> Install-Package Masuit.Tools.Core
为工具库注册配置
工具库需要用到外部配置节:
EmailDomainWhiteList,邮箱校验需要用到的白名单域名,英文逗号分隔,每个元素支持正则表达式,若未配置,则不启用邮箱校验白名单
EmailDomainBlockList,邮箱校验需要用到的黑名单域名,英文逗号分隔,每个元素支持正则表达式,且黑名单优先级高于白名单,若未配置,则不启用邮箱校验黑白名单
BaiduAK,获取IP/地理位置相关百度云APIKey,若未配置,则无法调用GetIPLocation以及GetPhysicalAddress相关方法
publicStartup(IConfigurationconfiguration)
{
configuration.AddToMasuitTools();// 若未调用,则默认自动尝试加载appsettings.json
}
特色功能示例代码
1.检验字符串是否是Email、手机号、URL、IP地址、身份证号
boolisEmail="[email protected]".MatchEmail();// 可在appsetting.json中添加EmailDomainWhiteList和EmailDomainBlockList配置邮箱域名黑白名单,逗号分隔,如"EmailDomainBlockList": "^\\w{1,5}@qq.com,^\\w{1,5}@163.com,^\\w{1,5}@gmail.com,^\\w{1,5}@outlook.com",
boolisInetAddress="114.114.114.114".MatchInetAddress();
boolisUrl="http://masuit.com".MatchUrl();
boolisPhoneNumber="15205201520".MatchPhoneNumber();
boolisIdentifyCard="312000199502230660".MatchIdentifyCard();// 校验中国大陆身份证号
boolisCNPatentNumber="200410018477.9".MatchCNPatentNumber();// 校验中国专利申请号或专利号,是否带校验位,校验位前是否带“.”,都可以校验,待校验的号码前不要带CN、ZL字样的前缀
2.硬件监测(仅支持Windows)
floatload=SystemInfo.CpuLoad;// 获取CPU占用率
longphysicalMemory=SystemInfo.PhysicalMemory;// 获取物理内存总数
longmemoryAvailable=SystemInfo.MemoryAvailable;// 获取物理内存可用率
doublefreePhysicalMemory=SystemInfo.GetFreePhysicalMemory();// 获取可用物理内存
Dictionary
Dictionary
Dictionary
doubletemperature=SystemInfo.GetCPUTemperature();// 获取CPU温度
intcpuCount=SystemInfo.GetCpuCount();// 获取CPU核心数
IList
stringlocalUsedIp=SystemInfo.GetLocalUsedIP();// 获取本机当前正在使用的IP地址
IList
stringosVersion=SystemInfo.GetOsVersion();// 获取操作系统版本
RamInforamInfo=SystemInfo.GetRamInfo();// 获取内存信息
3.大文件操作
FileStreamfs=newFileStream(@"D:\boot.vmdk",FileMode.OpenOrCreate,FileAccess.ReadWrite);
{
//fs.CopyToFile(@"D:\1.bak");//同步复制大文件
fs.CopyToFileAsync(@"D:\1.bak");//异步复制大文件
stringmd5=fs.GetFileMD5Async().Result;//异步获取文件的MD5
}
4.html的防XSS处理:
stringhtml=@"
strings=html.HtmlSantinizerStandard();//清理后:
5.整理操作系统的内存:
Windows.ClearMemorySilent();
6.任意进制转换
可用于生成短id,短hash等操作,纯数学运算。
NumberFormaternf=newNumberFormater(36);//内置2-62进制的转换
//NumberFormater nf = new NumberFormater("0123456789abcdefghijklmnopqrstuvwxyz");// 自定义进制字符,可用于生成验证码
strings36=nf.ToString(12345678);
longnum=nf.FromString("7clzi");
Console.WriteLine("12345678的36进制是:"+s36);// 7clzi
Console.WriteLine("36进制的7clzi是:"+num);// 12345678
//扩展方法形式调用
varbin=12345678.ToBinary(36);//7clzi
varnum="7clzi".FromBinary(36);//12345678
//超大数字的进制转换
varnum="E6186159D38CD50E0463A55E596336BD".FromBinaryBig(16);
Console.WriteLine(num);// 十进制:305849028665645097422198928560410015421
Console.WriteLine(num.ToBinary(64));// 64进制:3C665pQUPl3whzFlVpoPqZ,22位长度
Console.WriteLine(num.ToBinary(36));// 36进制:dmed4dkd5bhcg4qdktklun0zh,25位长度
7.纳秒级性能计时器
HiPerfTimertimer=HiPerfTimer.StartNew();
for(inti=0;i<100000;i++)
{
//todo
}
timer.Stop();
Console.WriteLine("执行for循环100000次耗时"+timer.Duration+"s");
doubletime=HiPerfTimer.Execute(()=>
{
for(inti=0;i<100000;i++)
{
//todo
}
});
Console.WriteLine("执行for循环100000次耗时"+time+"s");
8.单机产生唯一有序的短id
vartoken=Stopwatch.GetTimestamp().ToBinary(36);
varset=newHashSet
doubletime=HiPerfTimer.Execute(()=>
{
for(inti=0;i<1000000;i++)
{
set.Add(Stopwatch.GetTimestamp().ToBinary(36));
}
});
Console.WriteLine(set.Count==1000000);//True
Console.WriteLine("产生100w个id耗时"+time+"s");//1.6639039s
9.产生分布式唯一有序短id
varsf=SnowFlake.GetInstance();
stringtoken=sf.GetUniqueId();// rcofqodori0w
stringshortId=sf.GetUniqueShortId(8);// qodw9728
varset=newHashSet
doubletime=HiPerfTimer.Execute(()=>
{
for(inti=0;i<1000000;i++)
{
set.Add(SnowFlake.GetInstance().GetUniqueId());
}
});
Console.WriteLine(set.Count==1000000);//True
Console.WriteLine("产生100w个id耗时"+time+"s");//2.6891495s
10.农历转换
ChineseCalendar.CustomHolidays.Add(DateTime.Parse("2018-12-31"),"元旦节");//自定义节假日
ChineseCalendartoday=newChineseCalendar(DateTime.Parse("2018-12-31"));
Console.WriteLine(today.ChineseDateString);// 二零一八年十一月廿五
Console.WriteLine(today.AnimalString);// 生肖:狗
Console.WriteLine(today.GanZhiDateString);// 干支:戊戌年甲子月丁酉日
Console.WriteLine(today.DateHoliday);// 获取按公历计算的节假日
...
11.Linq表达式树扩展
Expression
Expression
Func
boolb=func("abcd12345678");//true
Expression
Expression
Func
boolb=func("abc");// true
12.模版引擎
vartmp=newTemplate("{{name}},你好!");
tmp.Set("name","万金油");
strings=tmp.Render();//万金油,你好!
vartmp=newTemplate("{{one}},{{two}},{{three}}");
strings=tmp.Set("one","1").Set("two","2").Set("three","3").Render();// 1,2,3
vartmp=newTemplate("{{name}},{{greet}}!");
tmp.Set("name","万金油");
strings=tmp.Render();// throw 模版变量{{greet}}未被使用
13.List转Datatable
varlist=newList
{
newMyClass()
{
Name="张三",
Age=22
},
newMyClass()
{
Name="李四",
Age=21
},
newMyClass()
{
Name="王五",
Age=28
}
};
vartable=list.Select(c=>new{姓名=c.Name,年龄=c.Age}).ToList().ToDataTable();// 将自动填充列姓名和年龄
14.文件压缩解压
.NET Framework
MemoryStreamms=SevenZipCompressor.ZipStream(newList
{
@"D:\1.txt",
"http://ww3.sinaimg.cn/large/87c01ec7gy1fsq6rywto2j20je0d3td0.jpg",
});//压缩成内存流
SevenZipCompressor.Zip(newList
{
@"D:\1.txt",
"http://ww3.sinaimg.cn/large/87c01ec7gy1fsq6rywto2j20je0d3td0.jpg",
},zip);//压缩成zip
SevenZipCompressor.UnRar(@"D:\Download\test.rar",@"D:\Download\");//解压rar
SevenZipCompressor.Decompress(@"D:\Download\test.tar",@"D:\Download\");//自动识别解压压缩包
SevenZipCompressor.Decompress(@"D:\Download\test.7z",@"D:\Download\");
ASP.NET Core
Startup.cs
services.AddSevenZipCompressor();
构造函数注入ISevenZipCompressor
privatereadonlyISevenZipCompressor_sevenZipCompressor;
publicTest(ISevenZipCompressorsevenZipCompressor)
{
_sevenZipCompressor=sevenZipCompressor;
}
使用方式同.NET Framework版本
15.日志组件
LogManager.LogDirectory=AppDomain.CurrentDomain.BaseDirectory+"/logs";
LogManager.Event+=info=>
{
//todo:注册一些事件操作
};
LogManager.Info("记录一次消息");
LogManager.Error(newException("异常消息"));
16.FTP客户端
FtpClientftpClient=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
...
17.多线程后台下载
varmtd=newMultiThreadDownloader("https://attachments-cdn.shimo.im/yXwC4kphjVQu06rH/KeyShot_Pro_7.3.37.7z",Environment.GetEnvironmentVariable("temp"),"E:\\Downloads\\KeyShot_Pro_7.3.37.7z",8);
mtd.Configure(req=>
{
req.Referer="https://masuit.com";
req.Headers.Add("Origin","https://baidu.com");
});
mtd.TotalProgressChanged+=(sender,e)=>
{
vardownloader=senderasMultiThreadDownloader;
Console.WriteLine("下载进度:"+downloader.TotalProgress+"%");
Console.WriteLine("下载速度:"+downloader.TotalSpeedInBytes/1024/1024+"MBps");
};
mtd.FileMergeProgressChanged+=(sender,e)=>
{
Console.WriteLine("下载完成");
};
mtd.Start();//开始下载
//mtd.Pause(); // 暂停下载
//mtd.Resume(); // 继续下载
18.Socket客户端操作类
vartcpClient=newTcpClient(AddressFamily.InterNetwork);
Socketsocket=tcpClient.ConnectSocket(IPAddress.Any,5000);
socket.SendFile("D:\\test\\1.txt",false,i=>
{
Console.WriteLine("已发送"+i+"%");
});
19.加密解密
varenc="123456".MDString();// MD5加密
varenc="123456".MDString("abc");// MD5加盐加密
varenc="123456".MDString2();// MD5两次加密
varenc="123456".MDString2("abc");// MD5两次加盐加密
varenc="123456".MDString3();// MD5三次加密
varenc="123456".MDString3("abc");// MD5三次加盐加密
stringaes="123456".AESEncrypt();// AES加密为密文
strings=aes.AESDecrypt();//AES解密为明文
stringaes="123456".AESEncrypt("abc");// AES密钥加密为密文
strings=aes.AESDecrypt("abc");//AES密钥解密为明文
stringenc="123456".DesEncrypt();// DES加密为密文
strings=enc.DesDecrypt();//DES解密为明文
stringenc="123456".DesEncrypt("abcdefgh");// DES密钥加密为密文
strings=enc.DesDecrypt("abcdefgh");//DES密钥解密为明文
RsaKeyrsaKey=RsaCrypt.GenerateRsaKeys();// 生成RSA密钥对
stringencrypt="123456".RSAEncrypt(rsaKey.PublicKey);// 公钥加密
strings=encrypt.RSADecrypt(rsaKey.PrivateKey);// 私钥解密
strings="123".Crc32();// 生成crc32摘要
strings="123".Crc64();// 生成crc64摘要
20.实体校验
publicclassMyClass
{
[IsEmail]//可在appsetting.json中添加EmailDomainWhiteList配置邮箱域名白名单,逗号分隔
publicstringEmail{get;set;}
[IsPhone]
publicstringPhoneNumber{get;set;}
[IsIPAddress]
publicstringIP{get;set;}
[MinValue(0,ErrorMessage="年龄最小为0岁"),MaxValue(100,ErrorMessage="年龄最大100岁")]
publicintAge{get;set;}
[ComplexPassword]//密码复杂度校验
publicstringPassword{get;set;}
}
21.HTML操作
List
varimgTags="html".MatchImgTags();//获取html字符串里的所有的img标签
varstr="html".RemoveHtmlTag();// 去除html标签
...
22.DateTime扩展
doublemilliseconds=DateTime.Now.GetTotalMilliseconds();// 获取毫秒级时间戳
doublemicroseconds=DateTime.Now.GetTotalMicroseconds();// 获取微秒级时间戳
doublenanoseconds=DateTime.Now.GetTotalNanoseconds();// 获取纳秒级时间戳
doubleseconds=DateTime.Now.GetTotalSeconds();// 获取秒级时间戳
doubleminutes=DateTime.Now.GetTotalMinutes();// 获取分钟级时间戳
...
23.IP地址和URL
boolinRange="192.168.2.2".IpAddressInRange("192.168.1.1","192.168.3.255");// 判断IP地址是否在这个地址段里
boolisPrivateIp="172.16.23.25".IsPrivateIP();// 判断是否是私有地址
boolisExternalAddress="http://baidu.com".IsExternalAddress();// 判断是否是外网的URL
//以下需要配置baiduAK
stringisp="114.114.114.114".GetISP();// 获取ISP运营商信息
PhysicsAddressphysicsAddress="114.114.114.114".GetPhysicsAddressInfo().Result;// 获取详细地理信息对象
Tuple
24.元素去重
varlist=newList
{
newMyClass()
{
Email="[email protected]"
},
newMyClass()
{
Email="[email protected]"
},
newMyClass()
{
Email="[email protected]"
}
};
List
Console.WriteLine(classes.Count==1);//True
25.枚举扩展
publicenumMyEnum
{
[Display(Name="读")]
[Description("读")]
Read,
[Display(Name="写")]
[Description("写")]
Write
}
Dictionary
vardic2=typeof(MyEnum).GetDescriptionAndValue();// 获取字符串表示和枚举值的字典映射
stringdesc=MyEnum.Read.GetDescription();// 获取Description标签
stringdisplay=MyEnum.Read.GetDisplay();// 获取Display标签的Name属性
varvalue=typeof(MyEnum).GetValue("Read");//获取字符串表示值对应的枚举值
stringenumString=0.ToEnumString(typeof(MyEnum));// 获取枚举值对应的字符串表示
26.定长队列实现
LimitedQueue
ConcurrentLimitedQueue
27.反射操作
MyClassmyClass=newMyClass();
PropertyInfo[]properties=myClass.GetProperties();// 获取属性列表
myClass.SetProperty("Email","[email protected]");//给对象设置值
28.获取线程内唯一对象
CallContext
CallContext
29.asp.net core 获取静态的HttpContext对象
Startup.cs
publicvoidConfigureServices(IServiceCollectionservices)
{
// ...
services.AddStaticHttpContext();
// ...
}
publicvoidConfigure(IApplicationBuilderapp,IHostingEnvironmentenv)
{
// ...
app.UseStaticHttpContext();
// ...
}
publicasyncTask
{
HttpContextcontext=HttpContext2.Current;
}
30.邮件发送
newEmail()
{
SmtpServer="smtp.masuit.com",// SMTP服务器
SmtpPort=25,// SMTP服务器端口
EnableSsl=true,//使用SSL
Username="[email protected]",// 邮箱用户名
Password="123456",// 邮箱密码
Tos="[email protected],[email protected]",//收件人
Subject="测试邮件",//邮件标题
Body="你好啊",//邮件内容
}.SendAsync(s=>
{
Console.WriteLine(s);// 发送成功后的回调
});// 异步发送邮件
31.图像的简单处理
ImageUtilities.CompressImage(@"F:\src\1.jpg",@"F:\dest\2.jpg");//无损压缩图片
"base64".SaveDataUriAsImageFile();// 将Base64编码转换成图片
Imageimage=Image.FromFile(@"D:\1.jpg");
image.MakeThumbnail(@"D:\2.jpg",120,80,ThumbnailCutMode.LockWidth);//生成缩略图
Bitmapbmp=newBitmap(@"D:\1.jpg");
BitmapnewBmp=bmp.BWPic(bmp.Width,bmp.Height);//转换成黑白
BitmapnewBmp=bmp.CutAndResize(newRectangle(0,0,1600,900),160,90);//裁剪并缩放
bmp.RevPicLR(bmp.Width,bmp.Height);//左右镜像
bmp.RevPicUD(bmp.Width,bmp.Height);//上下镜像
32.随机数
Randomrnd=newRandom();
intnum=rnd.StrictNext();//产生真随机数
doublegauss=rnd.NextGauss(20,5);//产生正态分布的随机数
33.权重筛选功能
vardata=newList
{
newWeightedItem
newWeightedItem
newWeightedItem
newWeightedItem
};
varitem=data.WeightedItem();//按权重选出1个元素
varlist=data.WeightedItems(2);//按权重选出2个元素
varselector=newWeightedSelector
{
newWeightedItem
newWeightedItem
newWeightedItem
newWeightedItem
});
varitem=selector.Select();//按权重选出1个元素
varlist=selector.SelectMultiple(3);//按权重选出3个元素
34.EF Core支持AddOrUpdate方法
///
/// 按Id添加或更新文章实体
///
publicoverridePostSavePost(Postt)
{
DataContext.Set
returnt;
}
35.敏感信息掩码
"13123456789".Mask();// 131****5678
"[email protected]".MaskEmail();// a****[email protected]
36.集合扩展
varlist=newList
{
"1","3","3","3"
};
list.AddRangeIf(s=>s.Length>1,"1","11");// 将被添加元素中的长度大于1的元素添加到list
list.AddRangeIfNotContains("1","11");// 将被添加元素中不包含的元素添加到list
list.RemoveWhere(s=>s.Length<1);// 将集合中长度小于1的元素移除
list.InsertAfter(0,"2");// 在第一个元素之后插入
list.InsertAfter(s=>s=="1","2");// 在元素"1"后插入
vardic=list.ToDictionarySafety(s=>s);// 安全的转换成字典类型,当键重复时只添加一个键
vardic=list.ToConcurrentDictionary(s=>s);// 转换成并发字典类型,当键重复时只添加一个键
vardic=list.ToDictionarySafety(s=>s,s=>s.GetHashCode());// 安全的转换成字典类型,当键重复时只添加一个键
dic.AddOrUpdate("4",4);// 添加或更新键值对
dic.AddOrUpdate(newDictionary
{
["5"]=5,["55"]=555
});// 批量添加或更新键值对
dic.AddOrUpdate("5",6,(s,i)=>66);// 如果是添加,则值为6,若更新则值为66
dic.AddOrUpdate("5",6,666);// 如果是添加,则值为6,若更新则值为666
dic.AsConcurrentDictionary();// 普通字典转换成并发字典集合
vartable=list.ToDataTable();// 转换成DataTable类型
table.AddIdentityColumn();//给DataTable增加一个自增列
table.HasRows();// 检查DataTable 是否有数据行
table.ToList
varset=list.ToHashSet(s=>s.Name);// 转HashSet
37.Mime类型
varmimeMapper=newMimeMapper();
varmime=mimeMapper.GetExtensionFromMime("image/jpeg");// .jpg
varext=mimeMapper.GetMimeFromExtension(".jpg");// image/jpeg
38.日期时间扩展
DateTime.Now.GetTotalSeconds();// 获取该时间相对于1970-01-01 00:00:00的秒数
DateTime.Now.GetTotalMilliseconds();// 获取该时间相对于1970-01-01 00:00:00的毫秒数
DateTime.Now.GetTotalMicroseconds();// 获取该时间相对于1970-01-01 00:00:00的微秒数
DateTime.Now.GetTotalNanoseconds();// 获取该时间相对于1970-01-01 00:00:00的纳秒数
varindate=DateTime.Parse("2020-8-3").In(DateTime.Parse("2020-8-2"),DateTime.Parse("2020-8-4"));//true
//时间段计算工具
varrange=newDateTimeRange(DateTime.Parse("2020-8-3"),DateTime.Parse("2020-8-5"));
range.Union(DateTime.Parse("2020-8-4"),DateTime.Parse("2020-8-6"));//连接两个时间段,结果:2020-8-3~2020-8-6
range.In(DateTime.Parse("2020-8-3"),DateTime.Parse("2020-8-6"));//判断是否在某个时间段内,true
var(intersected,range2)=range.Intersect(DateTime.Parse("2020-8-4"),DateTime.Parse("2020-8-6"));//两个时间段是否相交,(true,2020-8-3~2020-8-4)
range.Contains(DateTime.Parse("2020-8-3"),DateTime.Parse("2020-8-4"));//判断是否包含某个时间段,true
...
39.流转换
stream.SaveAsMemoryStream();// 任意流转换成内存流
stream.ToArray();// 任意流转换成二进制数组
40.数值转换
1.2345678901.Digits8();// 将小数截断为8位
1.23.To
1.23.To
41.简繁转换
varstr="个体".ToTraditional();// 转繁体
varstr="個體".ToSimplified();// 转简体
Asp.Net MVC和Asp.Net Core的支持断点续传和多线程下载的ResumeFileResult
在ASP.NET Core中通过MVC/WebAPI应用程序传输文件数据时使用断点续传以及多线程下载支持。
它提供了ETag标头以及Last-Modified标头。它还支持以下前置条件标头:If-Match,If-None-Match,If-Modified-Since,If-Unmodified-Since,If-Range。
支持 ASP.NET Core 2.0+
从.NET Core2.0开始,ASP.NET Core内部支持断点续传。因此只是对FileResult做了一些扩展。只留下了“Content-Disposition” Inline的一部分。所有代码都依赖于基础.NET类。
如何使用
.NET Framework
在你的控制器中,你可以像在FileResult一样的方式使用它。
usingMasuit.Tools.Mvc;
usingMasuit.Tools.Mvc.ResumeFileResult;
privatereadonlyMimeMappermimeMapper=newMimeMapper();// 推荐使用依赖注入
publicActionResultResumeFileResult()
{
varpath=Server.MapPath("~/Content/test.mp4");
returnnewResumeFileResult(path,mimeMapper.GetMimeFromPath(path),Request);
}
publicActionResultResumeFile()
{
returnthis.ResumeFile("~/Content/test.mp4",mimeMapper.GetMimeFromPath(path),"test.mp4");
}
publicActionResultResumePhysicalFile()
{
returnthis.ResumePhysicalFile(@"D:/test.mp4",mimeMapper.GetMimeFromPath(@"D:/test.mp4"),"test.mp4");
}
Asp.Net Core
要使用ResumeFileResults,必须在Startup.cs的ConfigureServices方法调用中配置服务:
usingMasuit.Tools.AspNetCore.ResumeFileResults.Extensions;
publicvoidConfigureServices(IServiceCollectionservices)
{
services.AddResumeFileResult();
}
然后在你的控制器中,你可以像在FileResult一样的方式使用它。