SuperAPI AI 工具集

dotnet-backend-patterns

编程与开发

查看项目

更新于 10-16 07:30

技能介绍

用途

dotnet-backend-patterns 面向 C#/.NET 后端开发者,帮助掌握构建生产级 API、MCP 服务器和企业后端的现代模式与最佳实践(2024/2025)。可用于开发新的 .NET Web API 或 MCP 服务器、审查 C# 代码的质量与性能、设计基于依赖注入的服务架构、实现 Redis 缓存策略、编写单元与集成测试、使用 EF Core 或 Dapper 优化数据库访问、通过 IOptions 模式配置应用,以及处理错误与实现弹性模式。

主要能力

1. 项目结构(清洁架构)

技能给出分层目录结构:

  • Domain:核心业务逻辑(无依赖),含 Entities、Interfaces、Exceptions、ValueObjects。
  • Application:用例、DTO、验证,含 Services、DTOs、Validators、Interfaces。
  • Infrastructure:外部实现,含 Data(EF Core、Dapper 仓储)、Caching(Redis、内存缓存)、External(HTTP 客户端、第三方 API)、DependencyInjection(服务注册)。
  • Api:入口点,含 Controllers(或 MinimalAPI 端点)、Middleware、Filters、Program.cs。

2. 依赖注入模式

通过 ServiceCollectionExtensions 展示按生命周期注册服务:Scoped(每次 HTTP 请求一个实例)、Singleton(应用生命周期一个实例)、Transient(每次获取新实例);Options 模式读取配置;工厂模式进行条件创建;.NET 8+ 键控服务(AddKeyedScoped)及通过 [FromKeyedServices] 注入。

3. 异步/await 模式

给出正确与错误示例对比:正确的全链路异步、使用 Task.WhenAll 并行执行、库中使用 ConfigureAwait(false)、缓存热路径使用 ValueTask;错误做法包括阻塞异步(.Result、GetAwaiter().GetResult())、async void(事件处理器除外)、对已是异步的代码无谓使用 Task.Run。

4. IOptions 配置

定义配置类(如 CatalogOptions、RedisOptions),提供 appsettings.json 示例,并展示 IOptions(单例,启动时读取一次)、IOptionsSnapshot(作用域,每请求重读)、IOptionsMonitor(单例,变更时通知)的用法。

5. Result 模式

提供泛型 Result 类,含 IsSuccess、Value、Error、ErrorCode,以及 Success、Failure、Map、MapAsync 方法;在服务中用于验证、业务规则检查和创建订单;在控制器/端点中根据结果返回 Created 或 BadRequest。

数据访问模式

EF Core:DbContext 配置(ApplyConfigurationsFromAssembly、全局查询过滤器)、实体配置(表名、主键、字段长度、精度、索引、关系)、仓储实现(AsNoTracking、条件查询、分页)。

Dapper:用于性能场景,提供 GetByIdAsync、带动态 SQL 的 SearchAsync、多映射 GetOrderWithItemsAsync 示例。

缓存模式

多级缓存:L1 内存缓存(进程内,最快,1 分钟)、L2 分布式缓存 Redis(15 分钟),包含缓存键命名、命中日志与回填 L1 的逻辑。

使用方式

技能提供的是模式与代码示例,供开发者在编写或审查 .NET 后端代码时参考。具体安装方式、调用命令等使用步骤暂未提供。

适用场景

新建 .NET Web API 或 MCP 服务器;审查 C# 代码质量与性能;设计依赖注入服务架构;实现 Redis 缓存;编写单元与集成测试;优化 EF Core 或 Dapper 数据库访问;配置 IOptions;实现错误处理与弹性模式。

限制

资料未提供该技能的具体安装方式、运行命令、支持的框架版本范围、收费模式或性能基准等事实,这些内容暂未提供。