.NET CORE 依赖注入实践总结

时间 2020-05-28 标签 core 依赖注入实践总结

知识点回顾

依赖包。 Microsoft.Extensions.DependencyInjection.Abstractions
核心对象和方法。
- IServiceCollection。注入对象的容器。注意它只存储对象的元数据，并不保存实例对象。
- IServiceProvider。注入对象的提供者。它负责提供具体的对象实例。在架构中，IServiceProvider有2种身份，一种是Root ServiceProvider，由service.BuildServiceProvider()建立，生命周期贯穿整个应用程序，AddSingleton对象保存在这里。另一种则是普通IServiceProvider，由IServiceScope建立，生命周期即为AddScoped的生命周期。AddScope 的对象保存在这里。普通ServiceProvider由Root ServiceProvider建立的IServiceScope建立。
- IServiceScope。表某一个生命周期范围。由ServiceProvider.CreateScope()建立。
- 注入方式，知识点一。
  - 注入功能默认在Startup类中的ConfigureServices方法中。
- 注入方式，知识点二。支持如下三种方式
  - AddScoped。生命周期为Scoped类型。例如在web框架中，即表示一次Request请求范围内。
  - AddSingleton。单例，应用程序全局使用同一个实例。
  - AddTransient。即时的，即对象每次使用都会从新实例化。　　
- 注入方式，知识点三。提供多种注入技巧，以Transient为例
  - 实例注入。AddTransient<TService>(this IServiceCollection services)。
  - 泛型注入。AddTransient<TService, TImplementation>(this IServiceCollection services)。
  - 工厂注入。AddTransient<TService>(this IServiceCollection services, Func<IServiceProvider, TService> implementationFactory)。
  - TryAddXXX。仅当XXX还没有注册实现时，注册该服务。此方法用来避免在容器中注册一个实例的两个副本。
- 获取实例的方法 GetService和GetRequiredService的区别，前置若是service不存在会返回NULL，后者会直接抛出异常。根据须要选择GetRequiredService，可能会让你的代码变得简洁一点。

WHY 依赖注入

这里只谈益处。web

使用接口或基类抽象化依赖关系实现，明确各个类之间的依赖关系。
生命周期的统一管理，尤为对于某些类被多处依赖，关系会变得分散难以管理，依赖注入容器能够解决这点。
很是利于单元测试。

最佳实践

部分来自官方文档的一些建议安全

对于须要注入为单例的实例，不要依赖Scoped实例。会触发 .NET CORE做用域验证失败。
不要从Root IServiceProvider解析有做用域的实例，这样会致使该做用域的实例变成单一实例。一样会触发做用域验证失败。
对于Asp.Net Core，尽可能经过构造函数而不是HttpContext.RequestServices获取实例，这样更易于单元测试。
须要对某个组件服务或是一些服务集合（包括其依赖注入时），使用约定的 Add{SERVICE_NAME} 扩展方法来注册该服务所需的全部服务。
若必需要从IServiceProvider中解析实例（如在单元测试中），请经过using (var scope = ServiceProvider.CreateScope()){ }方式建立做用域来获取实例。
代码中避免设计有状态的、静态类和成员。能够考虑设计注入为单一实例。
代码中避免在服务中直接实例化以来类。尽可能采用依赖注入的方式

注意如下两种方式注入的区别，后者的实例化不是服务容器建立的，全部容器不会处理实例的Dispose !!

public class Service1 : IDisposable {}
public class Service2 : IDisposable {}

//方式一
public void ConfigureServices(IServiceCollection services)
{
    services.AddSingleton<Service1>();
    services.AddSingleton<IService2>(sp => new Service2());
}

//方式二
public void ConfigureServices(IServiceCollection services)
{
    services.AddSingleton<Service1>(new Service1());
    services.AddSingleton(new Service2());
}

延伸上一点，对于复杂对象的建立，尽可能采用提供的工厂注入方式。注意工厂注入的参数是IServiceProvider，能够经过它获取你须要的实例对象。
继续延伸上一点，不要在ConfigureServices方法中经过collection.BuildServiceProvider()来获取IServiceProvider。这个建立的是一个Root IServiceProvider。单例会实例化一次，而后ConfigureServices方法结束后框架会再次调用collection.BuildServiceProvider()，单例又会从新实例化一次。
不支持基于async/await和Task的服务解析。C# 不支持异步构造函数；所以建议模式是在同步解析服务后使用异步方法
避免在容器中直接存储数据和配置。配置应使用NET CORE的选项模型。
避免使用服务定位器模式。例如直接注入IServiceProvider来获取多个须要的服务。PS，若是你的服务依赖项过多，应该考虑分割成几个小功能服务了。

引入第三方IOC框架

.NET CORE 3.x版本后，引入第三方IOC框架的方式变动了，这里再也不贴出2.x的方式。以Autofac框架为例。架构

Program.cs框架

        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .UseServiceProviderFactory(new AutofacServiceProviderFactory())
                .ConfigureWebHostDefaults(webBuilder =>
                {
                    webBuilder.UseStartup<Startup>()
                            .ConfigureLogging((hostingContext, logging) =>
                            {
                                logging.ClearProviders();
                                logging.AddConsole();
                                logging.AddNLog();
                            });
                });

Startup.cs异步

　　　　 
　　　　 //原来的 ConfigureServices保留，也可使用原来的框架继续注入

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();
            services.AddMemoryCache();
            services.Configure<List<string>>(Configuration.GetSection("BlackPhoneList"));
            services.Configure<Dictionary<string, string>>(Configuration.GetSection("BusinessMessages"));
        }
        //增长ConfigureContainer(ContainerBuilder builder) 方式，使用Autofac框架注入
        public void ConfigureContainer(ContainerBuilder builder)
        {
            builder.RegisterType<PhoneBlackListValidator>().Named<IPhoneValidator>("PHONE_BLACKLIST").SingleInstance();
            builder.RegisterType<PhonePerDayCountValidator>().Named<IPhoneValidator>("PHONE_PERDAYCOUNT").SingleInstance();
            builder.RegisterType<UniqueIdPerDayCountValidator>().Named<IUniqueIdValidator>("UNIQUEID_PERDAYCOUNT").SingleInstance();

            //可遍历类型注入，注意 只支持IEnumerable\IList\ICollection 类型
            builder.RegisterType<MessageSendValidator>().As<IMessageSendValidator>().SingleInstance();
        }

3.x 主要是在IServiceCollection和IServiceProvider之间增长了一个 ContainerBuilder 容器适配，使得第三方IOC框架引入更加合理了。具体实现原理能够网上源码查找。async

特别关注-线程安全