Scrutor 开源项目教程

项目介绍

Scrutor 是一个用于 Microsoft.Extensions.DependencyInjection 的程序集扫描和装饰扩展库。它允许开发者通过简单的配置，自动发现和注册程序集中的服务，以及对已注册的服务进行装饰。Scrutor 支持多种 .NET 框架，包括 .NET 6.0、.NET Core 3.1、.NET Standard 2.0 和 .NET Framework 4.6.1。

项目快速启动

安装 Scrutor

首先，通过 NuGet 安装 Scrutor 包：

dotnet add package Scrutor

使用 Scrutor

以下是一个简单的示例，展示如何使用 Scrutor 进行程序集扫描和服务注册：

using Microsoft.Extensions.DependencyInjection;
using Scrutor;

var collection = new ServiceCollection();

collection.Scan(scan => scan
    .FromAssemblyOf<ITransientService>()
        .AddClasses(classes => classes.AssignableTo<ITransientService>())
            .AsImplementedInterfaces()
            .WithTransientLifetime());

var provider = collection.BuildServiceProvider();
var service = provider.GetRequiredService<ITransientService>();

在这个示例中，我们首先创建了一个 ServiceCollection，然后使用 Scrutor 的 Scan 方法从 ITransientService 所在的程序集中扫描所有可分配给 ITransientService 的类，并将它们注册为接口的实现，生命周期为 Transient。

应用案例和最佳实践

应用案例

假设我们有一个项目，其中包含多个服务接口和实现类。使用 Scrutor 可以简化服务注册的过程：

public interface IService { }
public class ServiceA : IService { }
public class ServiceB : IService { }

var collection = new ServiceCollection();

collection.Scan(scan => scan
    .FromAssemblyOf<IService>()
        .AddClasses(classes => classes.AssignableTo<IService>())
            .AsImplementedInterfaces()
            .WithTransientLifetime());

最佳实践

1. 按需扫描：只扫描必要的程序集，避免不必要的类型注册。
2. 明确生命周期：根据服务的需求明确设置服务的生命周期（Transient、Scoped、Singleton）。
3. 装饰服务：使用 Decorate 方法对已注册的服务进行装饰，以实现 AOP 等功能。

典型生态项目

Scrutor 通常与其他依赖注入框架和库一起使用，以增强其功能。以下是一些典型的生态项目：

1. Microsoft.Extensions.DependencyInjection：Scrutor 是基于此框架的扩展库。
2. Autofac：另一个流行的依赖注入框架，可以与 Scrutor 结合使用。
3. MediatR：一个简单、无依赖的库，用于实现中介者模式，常与 Scrutor 一起使用以自动注册处理程序。

通过结合这些生态项目，可以构建更加强大和灵活的应用程序。