SuperAPI AI 工具集

dependency-injection

通用与其它

查看项目

更新于 10-15 19:51

技能介绍

用途:为 .NET 10 项目提供依赖注入(DI)的实践规范与模式参考,帮助开发者正确注册与解析服务。

核心原则:默认使用构造函数注入(主构造函数更简洁),不使用服务定位器或属性注入;注册接口而非具体类型,如 services.AddScoped<IOrderService, OrderService>();生命周期必须匹配,单例不得依赖作用域或瞬态服务,这是最常见的 DI 缺陷。

主要能力与模式:

  1. 键控服务(.NET 8+):用 AddKeyedScoped 注册同一接口的多个实现,通过 [FromKeyedServices("email")] 特性或 IServiceProvider.GetRequiredKeyedService 解析,替代手写工厂。
  2. 装饰器模式:定义接口与基础实现后,用 LoggingOrderService 等装饰类包裹,配合 Scrutor 的 Decorate<IOrderService, LoggingOrderService>() 注册,用于日志等横切关注点。
  3. 约定注册(Scrutor):通过 Scan 按程序集与接口约定批量注册,并指定 Transient 或 Scoped 生命周期。
  4. 工厂模式:用 AddScoped 委托结合配置与 ActivatorUtilities.CreateInstance 在运行时选择实现。
  5. 选项注册:AddOptions<JwtOptions>().BindConfiguration("Jwt").ValidateDataAnnotations().ValidateOnStart(),以 IOptions<T> 注入。

反模式:单例中捕获作用域服务(如 DbContext)会导致内存泄漏与数据陈旧,应改用 IServiceScopeFactory 创建作用域;不要把所有服务都注册为单例,有可变状态或依赖 DbContext 的服务应使用 Scoped。

决策参考:无状态服务用 Scoped 或 Transient;配置与缓存用 Singleton;DbContext 用 Scoped;多实现用键控服务;横切行为用装饰器;约定注册用 Scrutor;运行时选择用工厂委托;强类型配置用 AddOptions<T>().BindConfiguration()。

限制:资料未提供具体版本兼容范围、性能数据或完整项目示例,实际使用需结合项目验证。