摘要:Scrutor 是一个开源库,旨在简化 ASP.NET Core 应用程序中依赖注入(DI)的注册过程。通过自动扫描程序集中的类型并根据提供的规则自动注册服务。
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的程序集中扫描
2. 添加类:过滤需要注册的类。
services.Scan(scan => scan.FromAssemblyOf
.AddClasses(classes => classes.Where(t => t.Name.EndsWith("Service"))); // 只注册以Service结尾的类
3. 指定注册方式:指定类应该注册为哪些接口。
services.Scan(scan => scan.FromAssemblyOf
.AddClasses(classes => classes.Where(t => t.Name.EndsWith("Service")))
.AsImplementedinterfaces; // 注册为实现的所有接口
4. 设置生命周期:为注册的服务设置生命周期。
services.Scan(scan => scan.FromAssemblyOf
.AddClasses(classes => classes.Where(t => t.Name.EndsWith("Service")))
.AsImplementedInterfaces
.WithScopedLifetime; // 设置为Scoped生命周期进阶使用进行服务扫描(Scanning)
• **FromAssemblyOfT的程序集中扫描服务。
• **FromAssembliesOf(params Type types)**可以指定多个类型,Scrutor 将扫描包含这些类型的所有程序集。
• **FromCallingAssembly**扫描调用 Scan方法的程序集。
• **FromExecutingAssembly**扫描正在执行 Scan方法的程序集。
• **FromEntryAssembly**扫描应用程序的入口程序集(通常是包含 Main方法的程序集)。
• 等等...
进行服务装饰(Decoration)服务装饰是一种在不改变现有服务实现的情况下,动态地为服务添加额外功能的技术。
使用案例装饰器模式,允许你在不修改现有类的情况下为服务添加行为。例如,为IMessageSender接口添加一个记录日志的装饰器:publicinterfaceIMessageSender{
voidSendMessage(string message);
}
publicclassEmailMessageSender : IMessageSender
{
publicvoidSendMessage(string message)
{
Console.WriteLine($"Sending email: {message}");
}
}
publicclassLoggingMessageSender : IMessageSender
{
privatereadonlyIMessageSender _inner;
publicLoggingMessageSender(IMessageSender inner)
{
_inner = inner;
}
publicvoidSendMessage(string message)
{
Console.WriteLine("Starting to send message...");
_inner.SendMessage(message);
Console.WriteLine("Message sent successfully.");
}
}
// 使用 Scrutor 注册服务和装饰器
services.Scan(scan => scan
.FromAssemblyOf
.AddClasses(classes => classes.AssignableTo)
.AsImplementedInterfaces
.WithTransientLifetime);
services.Decorate;生命周期管理
想要为特定服务设置不同的生命周期,可以链式调用不同的生命周期设置
services.Scan(scan => scan.FromAssemblyOf
.AddClasses(classes => classes.AssignableTo) // 过滤服务
.AsSelfWithInterfaces // 注册为接口
.WithSingletonLifetime) // 设置为 Singleton 生命周期
// 对于其他服务,设置 Scoped 生命周期
.AddClasses(x => x.AssignableTo(typeof(IOpenGeneric))) // 可以关闭泛型类型
.AsMatchingInterface
.WithScopedLifetime; // 设置为 Scoped 生命周期多重过滤services.Scan(scan => scan
.FromAssemblyOf
.AddClasses
.UsingRegistrationStrategy(RegistrationStrategy.Skip) // 如果服务已存在,则跳过注册
.AsSelf
.WithTransientLifetime);链式注册
Scrutor 允许你将多个扫描整合成一个调用链,为不同的类应用不同的规则子集:
services.Scan(scan => scan.FromAssemblyOf
.AddClasses(classes => classes.Where(t => t.Name.EndsWith("Repository")))
.AsImplementedInterfaces
.WithTransientLifetime
.AddClasses(classes => classes.Where(t => t.Name.EndsWith("Service")))
.WithScopedLifetime);
Scrutor 在实际项目中简化依赖注入的配置工作,特别是在大型项目中,提供了灵活的扫描和注册机制,使得服务注册更加简洁和可维护。
仓库地址:https://github.com/khellang/Scrutor
来源:opendotnet