简化 ASP.NET Core 依赖注入（DI）注册-Scrutor

简化 ASP.NET Core 依赖注入（DI）注册-Scrutor

Scrutor 是一个开源库，旨在简化 ASP.NET Core 应用程序中依赖注入（DI）的注册过程。通过自动扫描程序集中的类型并根据提供的规则自动注册服务。

基本使用

使用 NuGet 包管理器安装：

dotnet add package Scrutor 

步骤

• 选择器（Selector）：指定要注册的服务实现。
• 注册策略（Registration Strategy）：处理重复服务的策略。
• 服务（Services）：指定服务的具体实现。
• 生命周期（Lifetime）：服务的生命周期，如 Singleton、Scoped、Transient。

1. 选择程序集：指定从哪个程序集中扫描类型。

services.Scan(scan => scan  .FromAssemblyOf<MyClass>(); // 从包含MyClass的程序集中扫描 

2. 添加类：过滤需要注册的类。

services.Scan(scan => scan  .FromAssemblyOf<MyClass>()  .AddClasses(classes => classes.Where(t => t.Name.EndsWith("Service"))); // 只注册以Service结尾的类 

3. 指定注册方式：指定类应该注册为哪些接口。

services.Scan(scan => scan  .FromAssemblyOf<MyClass>()  .AddClasses(classes => classes.Where(t => t.Name.EndsWith("Service")))  .AsImplementedInterfaces(); // 注册为实现的所有接口 

4. 设置生命周期：为注册的服务设置生命周期。

services.Scan(scan => scan  .FromAssemblyOf<MyClass>()  .AddClasses(classes => classes.Where(t => t.Name.EndsWith("Service")))  .AsImplementedInterfaces()  .WithScopedLifetime(); // 设置为Scoped生命周期 

进阶使用

进行服务扫描（Scanning）

• FromAssemblyOf()从包含指定类型 T 的程序集中扫描服务。
• FromAssembliesOf(params Type[] types)可以指定多个类型，Scrutor 将扫描包含这些类型的所有程序集。
• FromCallingAssembly()扫描调用 Scan 方法的程序集。
• FromExecutingAssembly()扫描正在执行 Scan 方法的程序集。
• FromEntryAssembly()扫描应用程序的入口程序集（通常是包含 Main 方法的程序集）。
• 等等...

进行服务装饰（Decoration）

服务装饰是一种在不改变现有服务实现的情况下，动态地为服务添加额外功能的技术。

使用案例

装饰器模式，允许你在不修改现有类的情况下为服务添加行为。例如，为 IMessageSender 接口添加一个记录日志的装饰器：

public interface IMessageSender {  void SendMessage(string message); }  public class EmailMessageSender : IMessageSender {  public void SendMessage(string message)  {   Console.WriteLine($"Sending email: {message}");  } }  public class LoggingMessageSender : IMessageSender {  private readonly IMessageSender _inner;  public LoggingMessageSender(IMessageSender inner)  {   _inner = inner;  }  public void SendMessage(string message)  {   Console.WriteLine("Starting to send message...");   _inner.SendMessage(message);   Console.WriteLine("Message sent successfully.");  } }  // 使用 Scrutor 注册服务和装饰器 services.Scan(scan => scan  .FromAssemblyOf<IMessageSender>()  .AddClasses(classes => classes.AssignableTo<IMessageSender>())  .AsImplementedInterfaces()  .WithTransientLifetime()); services.Decorate<IMessageSender, LoggingMessageSender>(); 

生命周期管理

想要为特定服务设置不同的生命周期，可以链式调用不同的生命周期设置

services.Scan(scan => scan     .FromAssemblyOf<CombinedService>()     .AddClasses(classes => classes.AssignableTo<ICombinedService>()) // 过滤服务     .AsSelfWithInterfaces() // 注册为接口     .WithSingletonLifetime()) // 设置为 Singleton 生命周期  // 对于其他服务，设置 Scoped 生命周期 .AddClasses(x => x.AssignableTo(typeof(IOpenGeneric<>))) // 可以关闭泛型类型     .AsMatchingInterface()     .WithScopedLifetime(); // 设置为 Scoped 生命周期 

多重过滤

services.Scan(scan => scan     .FromAssemblyOf<MyService>()     .AddClasses()     .UsingRegistrationStrategy(RegistrationStrategy.Skip) // 如果服务已存在，则跳过注册     .AsSelf()     .WithTransientLifetime()); 

链式注册

Scrutor 允许你将多个扫描整合成一个调用链，为不同的类应用不同的规则子集：

services.Scan(scan => scan  .FromAssemblyOf<Startup>()  .AddClasses(classes => classes.Where(t => t.Name.EndsWith("Repository")))   .AsImplementedInterfaces()   .WithTransientLifetime()  .AddClasses(classes => classes.Where(t => t.Name.EndsWith("Service")))   .AsImplementedInterfaces()   .WithScopedLifetime()); 

总结

Scrutor 在实际项目中简化依赖注入的配置工作，特别是在大型项目中，提供了灵活的扫描和注册机制，使得服务注册更加简洁和可维护。

欢迎关注我的公众号“Net分享”，技术文章第一时间推送，随缘更新 , 分享一些你可能注意不到的细节。

仓库地址：https://github.com/khellang/Scrutor