ASP.NET Core依赖注入系统学习教程:ServiceDescriptor(服务注册描述类型)

依赖注入容器之所以能够提供应用程序所需的服务对象,是因为服务注册为容器提供了创建服务对象的描述信息,而这个服务注册的描述信息是被封装在一个由ServiceDescriptor类型表示的对象中,该对象主要存储在IServiceCollection类型的集合中,其中每个ServiceDescriptor对象主要描述了:服务的类型、提供服务对象的方式以及服务对象的生命周期模式。

所以可以换句话说,我们进行服务注册实际上就是创建一个ServiceDescriptor类型的对象,并添加到IServiceCollection类型的集合中。基于这种本质也代表了,实际上我们进行服务注册并非要调用注册方法来完成,我们还可以直接创建一个ServiceDescriptor的对象,将其添加到IServiceCollection集合中,用这样的方式同样可以实现服务注册。通过运行下面的代码示例就可以证明这一点。

 1 using Microsoft.Extensions.DependencyInjection;
 2 using System;
 3 using System.Diagnostics;
 4 
 5 namespace ConsoleApp1
 6 { 
 7     public interface IFooBar { void SayHi(); }
 8     public class FooBar : IFooBar
 9     {
10         public void SayHi() { Console.WriteLine("你好"); }
11     }
12 
13     internal class Program
14     {
15         static void Main(string[] args)
16         {
17             //创建服务注册信息集合
18             var collection = new ServiceCollection();
19 
20             //创建服务注册信息对象,并添加到集合
21             ServiceDescriptor descriptor = new ServiceDescriptor(typeof(IFooBar), typeof(FooBar), ServiceLifetime.Singleton);
22             collection.Insert(collection.Count, descriptor);
23 
24             //构建容器对象
25             var  provider= collection.BuildServiceProvider();
26 
27             //获取对象并调用方法
28             var fooBar =provider.GetService<IFooBar>();
29             fooBar.SayHi();
30         } // END Main()
31 
32     }
33 }

上面的示例中创建ServiceDescriptor对象其实就是通过构造函数传入了几个关键的属性,下面通过代码的形式罗列出ServiceDescriptor类型中的几个关键属性,其中对属性的描述体现在注释上:

 1  public class ServiceDescriptor
 2     {
 3         /// <summary>
 4         /// 服务的生命周期模式
 5         /// </summary>
 6         public ServiceLifetime Lifetime { get; }
 7 
 8         /// <summary>
 9         /// 服务的类型,通常会指定一个接口或者基类
10         /// </summary>
11         public Type ServiceType { get; }
12 
13         /// <summary>
14         /// 服务的实现
15         /// </summary>
16         public Type ImplementationType { get; }
17 
18         /// <summary>
19         /// 服务实例,直接提供一个实例对象,容器提供时就无需创建
20         /// </summary>
21         public object ImplementationInstance { get; }
22 
23         /// <summary>
24         /// 用于创建服务实例的工厂方法
25         /// </summary>
26         public Func<IServiceProvider, object> ImplementationFactory { get; }
27 
28     }

在以上的关键属性中除了ServiceType(服务类型)是必须的,其他的几个可以根据不同的创建形式使用的不同构造函数来决定。以下是创建ServiceDescriptor类型对象的3个构造函数:

1 public ServiceDescriptor(Type serviceType, object instance);
2 public ServiceDescriptor(Type serviceType, Type implementationType, ServiceLifetime lifetime);
3 public ServiceDescriptor(Type serviceType, Func<IServiceProvider, object> factory, ServiceLifetime lifetime)

ServiceDescriptor类型中的3个构造函数主要体现出了服务实例的3种提供方式,并且这3种提供方式和我们进行服务注册时主要使用的几种形式相得益彰。下面我对这3种服务实例的提供方式进行概况说明:

  1. 根据指定的服务类型,直接使用一个现成的对象进行提供;
  2. 根据指定的服务类型,使用对应的实现类型结合指定的生命周期模式进行提供;
  3. 根据指定的服务类型,使用一个委托对象作为工厂方法,结合指定的生命周期模式进行提供;

第一种方式而言并没有指定生命周期模式,是因为它默认采用了Singleton的模式,所以无需指定生命周期。

除了上面介绍的3个构造函数来创建ServiceDescriptor对象,在ServiceDescriptor类型中还提供了一些列的静态方法用来创建对象。如果想要更加详细的了解ServiceDescriptor类型其中的每一项,可以访问官方文档进行查阅:https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.extensions.dependencyinjection.servicedescriptor?view=dotnet-plat-ext-6.0

总结

服务注册的本质,实际上就是将创建服务对象所使用到的关键信息:服务类型、服务实现类型、提供方式、生命周期,封装到ServiceDescriptor类型的对象中,并添加到IServiceCollection集合,以便作为容器为应用程序提供服务对象的根据。

posted @ 2022-08-10 11:33  姜承轩  阅读(790)  评论(0编辑  收藏  举报