阕阵闲 发表于 2025-5-29 10:57:43

一个功能丰富的 .NET 工具库 XiHan.Framework.Utils

概述

XiHan.Framework.Utils 是一个功能丰富的 .NET 工具库,涵盖了开发中常用的字符串处理、集合扩展、加密解密、分布式ID、文件IO、反射、缓存、线程、系统工具、国际化、网络、硬件信息、异常、数据过滤、Linq扩展等模块。 本库以高内聚、低耦合为设计理念,适用于各类 .NET 应用开发。
目录结构与模块说明

1. Verifications(验证工具)


[*]RegexHelper:正则表达式相关工具,支持常用正则校验。
[*]DataChecker:数据有效性检查工具,支持多种数据类型的校验。
2. Security(安全工具)


[*]Cryptography/ :加密解密工具(如AesHelper等)。
[*]OtpHelper:一次性密码生成。
[*]MaskHelper:敏感信息掩码。
[*]PasswordStrengthChecker:密码强度检测。
[*]TextWatermarkHelper:文本水印处理。
[*]ValidateCoder:验证码生成与校验。
3. Text(文本处理)


[*]StringHelper:字符串分割、组装、格式化、长度计算、HTML转文本等。
[*]StringExtensions:字符串扩展方法。
[*]EncodingExtensions:编码扩展。
[*]Json/Xml/Yaml/Template:JSON、XML、YAML、模板处理工具。
4. DistributedId(分布式ID生成)


[*]IDistributedIdGenerator:分布式ID生成接口。
[*]SnowflakeIdGenerator:雪花算法ID生成器。
[*]UuidGenerator:UUID生成。
[*]IdGeneratorFactory/Options:ID生成器工厂与配置。
5. Collections(集合扩展)


[*]List/Dictionary/Collection/Enumerable/TreeExtensions:集合、字典、树结构等扩展方法,支持树形结构转换、集合去重、查找等。
6. Timing(时间处理)


[*]DateTimeFormatExtensions:日期时间格式化扩展。
[*]DateTimeRange:时间区间处理。
7. Maths(数学工具)


[*]MathHelper:常用数学计算。
[*]MoneyFormatExtensions:金额格式化扩展。
8. Configuration(配置工具)


[*]DeepMergeHelper:对象深度合并工具,支持复杂配置合并。
9. Reflections(反射工具)


[*]Assembly/Field/Method/Member/PropertyInfoExtensions:反射相关扩展,支持类型、属性、方法等元数据操作。
[*]LockExtensions:锁相关扩展。
10. Caching(缓存工具)


[*]MemoryCache:内存缓存实现。
[*]CacheManager:缓存管理器。
11. Threading(线程工具)


[*]Async/AsyncLock/AsyncHelper/Debouncer/DisposeAction:异步锁、去抖动、异步辅助、资源释放等。
12. System(系统工具)


[*]Parse/Enum/Type/Object/GenericExtensions:类型转换、枚举、对象操作、泛型扩展等。
[*]RandomHelper:随机数工具。
[*]CheckHelper:通用检查工具。
[*]GuidHelper:GUID工具。
13. CommandLine(命令行工具)


[*]ScriptExecutor:脚本执行器。
[*]ShellHelper:Shell命令辅助。
14. Attributes(自定义特性)


[*]ThemeAttribute:主题特性。
15. IO(文件与流操作)


[*]File/Directory/Stream/CompressHelper:文件、目录、流、压缩等操作。
[*]FileFormatExtensions:文件格式扩展。
16. Logging(日志工具)


[*]ConsoleLogger:控制台日志输出。
17. Net(网络工具)


[*]PingHelper:Ping工具。
[*]IpFormatExtensions:IP格式化扩展。
[*]Sftp/Ssh/Http/Sse/WebSocket:网络协议相关工具。
18. I18n(国际化工具)


[*]Format/Language/TimeZone/CurrencyHelper:格式化、多语言、时区、货币等国际化支持。
19. Runtime(运行时工具)


[*]OSPlatformHelper:操作系统平台辅助。
20. HardwareInfos(硬件信息)


[*]Cpu/Disk/Network/Ram/Board/RunningTimeHelper:CPU、磁盘、网络、内存、主板、运行时间等硬件信息获取。
21. Exceptions(异常处理)


[*]CustomException:自定义异常类型。
22. DataFilter(数据过滤与分页)


[*]Paging:分页扩展、条件解析、排序、DTO、枚举等,支持复杂数据分页与过滤。
23. Linq(Linq扩展)


[*]Expressions:表达式树扩展、Queryable扩展。
典型用法示例

字符串处理

// 分割字符串为列表
var list = StringHelper.GetStrList("a,b,c", ',');
// 组装列表为字符串
var str = StringHelper.GetListStr(list, ',');集合扩展

// 树形结构转换
var tree = list.ToTree(x => x.Id, x => x.ParentId, x => x.Children);加密解密

// AES加密
string encrypted = AesHelper.Encrypt("明文", "密码");
// AES解密
string decrypted = AesHelper.Decrypt(encrypted, "密码");分布式ID

var generator = IdGeneratorFactory.CreateSnowflakeIdGenerator(new IdGeneratorOptions { WorkerId = 1 });
long id = generator.NextId();文件操作

FileHelper.WriteAllText("test.txt", "内容");
string content = FileHelper.ReadAllText("test.txt");缓存

MemoryCache.Set("key", value, TimeSpan.FromMinutes(5));
var value = MemoryCache.Get("key");异步锁

using (await asyncLock.LockAsync())
{
   // 线程安全操作
}国际化

string currency = CurrencyHelper.Format(100, "CNY");分页与数据过滤

var pageInfo = new PageInfoDto { PageIndex = 1, PageSize = 10 };
var pagedData = dataList.ToPagedList(pageInfo);安装

方式一:使用 Visual Studio 包管理器控制台

Install-Package XiHan.Framework.Utils方式二:使用 .NET CLI

dotnet add package XiHan.Framework.Utils方式三:通过 Visual Studio 图形界面


[*]右键点击你的项目,选择“管理NuGet程序包”。
[*]搜索 XiHan.Framework.Utils。
[*]点击“安装”。
源码

https://github.com/XiHanFun/XiHan.Framework/tree/main/framework/src/XiHan.Framework.Utils许可证

MIT License

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: 一个功能丰富的 .NET 工具库 XiHan.Framework.Utils