# 工具类管理库ExUtil **Repository Path**: starry123/ruovea-extend ## Basic Information - **Project Name**: 工具类管理库ExUtil - **Description**: ruovea.extend.package 是一系列扩展工具类库的集合，旨在简化开发流程，提高代码的可维护性和可读性。这些工具类库涵盖了从自动服务注入到日志记录、从加密解密到文件操作等多个方面的功能，为开发者提供了全面的解决方案。 - **Primary Language**: C# - **License**: Apache-2.0 - **Default Branch**: NetCore - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 3 - **Created**: 2021-09-28 - **Last Updated**: 2026-03-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: NetCore ## README 组件分类总结和关键分析： ------ ### **一、核心架构组件** | 组件名称 | 核心功能 | 技术亮点 | | :----------------------- | :----------------------------------- | :------------------------------------------------------- | | [**RuoVea.Autowired**](/NetCore/RuoVea.Autowired/RuoVea.Autowired/README.md ':include:type=md') | 自动依赖注入 | 简化DI配置，减少手动注册代码 | | [**RuoVea.DynamicWebApi**](/NetCore/RuoVea.DynamicWebApi/RuoVea.DynamicWebApi/README.md ':include:type=md') | 动态生成RESTful API | 支持DDD架构，无Controller层直接暴露服务，完美集成Swagger | | [**RuoVea.ExEvenBus**](/NetCore/RuoVea.ExEvenBus/RuoVea.ExEvenBus/README.md ':include:type=md') | 事件总线（单机版） | 事件驱动架构，可扩展为分布式（参考CAP） | | [**RuoVea.ExFilter**](/NetCore/RuoVea.ExFilter/RuoVea.ExFilter/README.md ':include:type=md') | 全局拦截器（异常/操作日志/参数验证） | AOP思想统一处理横切关注点 | ------ ### **二、安全与认证** | 组件名称 | 安全功能 | 特色 | | :--------------------- | :------------------------------------------- | :-------------------------------------------------- | | [**RuoVea.ExCrypt**](/NetCore/RuoVea.ExCrypt/RuoVea.ExCrypt/README.md ':include:type=md') | 多算法加密（AES/RSA/SM2-SM4/MD5等） | 支持国密算法，多语言敏感数据处理 | | [**RuoVea.ExPws**](/NetCore/RuoVea.ExPws/RuoVea.ExPws/README.md ':include:type=md') | 增强版加密服务（含国密SM系列） | 覆盖PBKDF2.Key等工业级算法，支持粤语/日语等特殊场景 | | [**RuoVea.ExJwtBearer**](/NetCore/RuoVea.ExJwtBearer/RuoVea.ExJwtBearer/README.md ':include:type=md') | 多模式认证（JWT/Basic Auth/IdentityServer4） | 开箱即用的OAuth2.0集成 | | [**RuoVea.ExWeb**](/NetCore/RuoVea.ExWeb/RuoVea.ExWeb/README.md ':include:type=md') | IP白名单/CORS/JWT配置 | 安全策略集中管理 | ------ ### **三、基础设施工具** | 组件名称 | 功能 | 典型场景 | | :------------------ | :----------------------------- | :------------------------------- | | [**RuoVea.ExIdGen**](/NetCore/RuoVea.ExIdGen/RuoVea.ExIdGen/README.md ':include:type=md') | 分布式ID生成（雪花漂移算法） | 高并发订单号生成，支持数据中心ID | | [**RuoVea.ExCache**](/NetCore/RuoVea.ExCache/RuoVea.ExCache/README.md ':include:type=md') | 统一缓存操作接口 | 多级缓存策略抽象 | | [**RuoVea.ExFile**](/NetCore/RuoVea.ExFile/RuoVea.ExFile/README.md ':include:type=md') | 文件/压缩包操作（ZipHelper等） | 批量文件处理与二进制流管理 | | [**RuoVea.ExConfig**](/NetCore/RuoVea.ExConfig/RuoVea.ExConfig/README.md ':include:type=md') | 动态配置读取 | 强类型配置绑定 | ------ ### **四、开发效率增强** | 组件名称 | 价值点 | 示例 | | :------------------- | :--------------------------------------- | :------------------------------------------------ | | [**RuoVea.ExUtil**](/NetCore/RuoVea.ExUtil/RuoVea.ExUtil/README.md ':include:type=md') | 全能工具集（验证/类型转换/树结构构建等） | 包含SQL注入检测、汉字拼音转换、Linq扩展等300+方法 | | [**RuoVea.ExSwagger**](/NetCore/RuoVea.ExSwagger/RuoVea.ExSwagger/README.md ':include:type=md') | Swagger自动化配置 | 零配置API文档生成 | | [**RuoVea.ExDto**](/NetCore/RuoVea.ExDto/RuoVea.ExDto/README.md ':include:type=md') | 通用DTO/枚举/接口定义 | 标准化团队协作契约 | | [**RuoVea.ExLog**](/NetCore/RuoVea.ExLog/RuoVea.ExLog/README.md ':include:type=md') | 可扩展日志框架 | 支持多日志格式和跨版本兼容 | ------ ### **五、特殊场景解决方案** | 组件名称 | 解决痛点 | 技术细节 | | :------------------- | :----------------------------------- | :------------------------------------------ | | [**RuoVea.ExCaptcha**](/NetCore/RuoVea.ExCaptcha/RuoVea.ExCaptcha/README.md ':include:type=md') | 图形验证码生成 | 基于.Net Standard 2.0，支持高复杂度扭曲文本 | | [**RuoVea.ExHtml**](/NetCore/RuoVea.ExHtml/RuoVea.ExHtml/README.md ':include:type=md') | HTML解析与远程下载 | 网页内容抓取与DOM操作 | | [**RuoVea.ExGlobal**](/NetCore/RuoVea.ExGlobal/RuoVea.ExGlobal/README.md ':include:type=md') | 全局错误日志追踪 | 生产环境故障诊断 | | [**RuoVea.ExApp**](/NetCore/RuoVea.ExApp/RuoVea.ExApp/README.md ':include:type=md') | 上下文快捷访问（HttpContext/User等） | 解决ASP.NET Core中上下文获取繁琐问题 | ------ ### **六、数据库支持** | 组件名称 | 数据库相关功能 | 优势 | | :-------------------- | :--------------- | :---------------------------- | | [**RuoVea.ExSqlSugar**](/NetCore/RuoVea.ExSqlSugar/RuoVea.ExSqlSugar/README.md ':include:type=md') | SqlSugar ORM扩展 | 增强的Sugar查询能力和事务管理 | ------ ### **关键洞察** 1. 1.**模块化设计**：每个功能独立成包，避免"全家桶"式依赖，开发者可按需引用。 2. 2.**企业级安全**：同时支持国际标准算法（AES/RSA）和国密算法（SM2/SM4），符合国内安全合规要求。 3. 3.**DDD友好**：DynamicWebApi直接映射领域层为API，完美契合领域驱动设计架构。 4. 4.**本土化适配**：中文拼音处理、身份证/手机号验证等针对国内业务场景的专用工具。 ------ ### **推荐学习路径** 1. 1.**基础必备**：先掌握 `ExUtil`（核心工具）、`ExCrypt`（安全基础）、`DynamicWebApi`（架构革新） 2. 2.**进阶扩展**：深入研究 `ExEvenBus`（事件驱动）、`ExFilter`（AOP实践）、`ExIdGen`（分布式ID） 3. 3.**场景化选择**：根据项目需求选用 `ExCaptcha`（人机验证）或 `ExSqlSugar`（数据库加速） 这个库堪称.NET Core开发者的"瑞士军刀"，尤其是对国内开发者而言，其本土化功能填补了官方库的空白。建议通过实际项目实践来深入理解各组件的最佳组合方式。 ## 安装教程 所有扩展工具类库均可通过 NuGet 直接引用： ```c# PM> Install-Package RuoVea.Autowired PM> Install-Package RuoVea.DynamicWebApi PM> Install-Package RuoVea.ExEvenBus PM> Install-Package RuoVea.ExApp PM> Install-Package RuoVea.ExCache PM> Install-Package RuoVea.ExCaptcha PM> Install-Package RuoVea.ExConfig PM> Install-Package RuoVea.ExCrypt PM> Install-Package RuoVea.ExDto PM> Install-Package RuoVea.ExFile PM> Install-Package RuoVea.ExFilter PM> Install-Package RuoVea.ExGlobal PM> Install-Package RuoVea.ExHtml PM> Install-Package RuoVea.ExIdGen PM> Install-Package RuoVea.ExJwtBearer PM> Install-Package RuoVea.ExLog PM> Install-Package RuoVea.ExSwagger PM> Install-Package RuoVea.ExSwagger PM> Install-Package RuoVea.ExUtil PM> Install-Package RuoVea.ExWeb ``` 通过这些工具类库，开发者可以更加高效地构建和维护应用程序，减少重复代码，提高代码质量。每个工具类库都提供了详细的文档，帮助开发者快速上手和深入使用。