Core官方DI解析(2)-ServiceProvider

public sealed class ServiceProvider : IServiceProvider, IDisposable, IServiceProviderEngineCallback

{}

`ServiceProvider`这个类型其实挺简单,从下面代码中\*\*GetService()\*\*方法可以看出它只是代理了一个`IServiceProviderEngine`实现类型,

`ServiceProvider`的实例化方式在上一章已经说过,利用`ServiceDescriptor`集合和`ServiceProviderOptions`进行实例化,可以看到,在构造方法中首先通过\*\*ValidateScopes\*\*属性来进行实例化`CallSiteValidator`和将当前对象赋值给`IServiceProviderEngineCallback`类型变量

然后通过\*\*ServiceProviderMode\*\*这个枚举进行判断实例化的具体引擎对象,四个枚举对应四种引擎对象,前面已经说过目前DI只使用了\*\*Dynamic\*\*这一种,下面说\*\*IServiceProviderEngineCallback\*\*时也只说这一种

public sealed class ServiceProvider : IServiceProvider, IDisposable, IServiceProviderEngineCallback

{

    //        ServiceProvider工作引擎接口    

    //        这个接口是一个核心接口   

    //        使用这个接口的子类进行调用缓存各种注册服务和调用访问者对象进行获取实例对象

     private readonly IServiceProviderEngine \_engine;

     

     ///         此属性缓存当前注册类型,当ServiceProviderOptions.ValidateScopes为true进行验证

     private readonly CallSiteValidator \_callSiteValidator;



     internal ServiceProvider(IEnumerable<ServiceDescriptor> serviceDescriptors, ServiceProviderOptions options)

     {

          IServiceProviderEngineCallback callback = null;

          if (options.ValidateScopes)

          {

               callback = this;

               \_callSiteValidator = new CallSiteValidator();

          }

          //        根据ServiceProviderMode进行实例化对应的工作引擎类型

          switch (options.Mode)

          {

               case ServiceProviderMode.Dynamic:

                    //      实例化 DynamicServiceProviderEngine

                    \_engine = new DynamicServiceProviderEngine(serviceDescriptors, callback);

                    break;

               case ServiceProviderMode.Runtime:

                    \_engine = new RuntimeServiceProviderEngine(serviceDescriptors, callback);

                    break;

                    case ServiceProviderMode.ILEmit:

                    \_engine = new ILEmitServiceProviderEngine(serviceDescriptors, callback);

               break;

                    case ServiceProviderMode.Expressions:

                    \_engine = new ExpressionsServiceProviderEngine(serviceDescriptors, callback);

                    break;

               default:

                   throw new NotSupportedException(nameof(options.Mode));

          }

     }



     /// 获取指定类型的服务对象

     public object GetService(Type serviceType) => \_engine.GetService(serviceType);



     public void Dispose() => \_engine.Dispose();



    void IServiceProviderEngineCallback.OnCreate(ServiceCallSite callSite)

       =>\_callSiteValidator.ValidateCallSite(callSite);



     void IServiceProviderEngineCallback.OnResolve(Type serviceType, IServiceScope scope)

      =>\_callSiteValidator.ValidateResolution(serviceType, scope, \_engine.RootScope);

}

前面说过这个类是`ServiceProvider`的扩展类型,提供了更佳便捷,下面就来看看这个这个扩展类提供的方法

在这个扩展类中就扩展了\*\*GetRequiredService()\*\*,\*\*GetServices()\*\*和\*\*CreateScope()\*\*三个方法,前两个也是获取服务实例,第三个获取一个子`IServiceProvider`,也就是说获取一个子容器

\*\*GetRequiredService()\*\*方法是如果获取的当前类型并没有被注册,那么就会抛出`InvalidOperationException`异常,从下面代码可以看出,\*\*GetRequiredService()\*\*方法首先判断当前`ServicePrivider`是否是`ISupportRequiredService`的实现类,如果是,则就返回自身的\*\*GetRequiredService()\*\*方法,如果不是,就直接调用\*\*GetService()\*\*,如果返回服务实例为\*\*NULL\*\*,就抛出异常.

\*\*GetServices()\*\*方法是获取当前类型的所有服务实例,可以看到这个方法无非是调用的\*\*GetRequiredService()\*\*,只不过参数是一个\*\*IEnumerable<T>\*\*集合,在内部使用\*\*IEnumerable<T>\*\*参数获取服务实例是一个特殊处理,这个在后面就可以看到

\*\*CreateScope()\*\*方法是一个获取子类容器的,获取方式从下面代码看的也是通过服务注册的方式获取服务实例,也就是说内部进行了注册,这个注册是在`ServiceProviderEngine`类中

public static class ServiceProviderServiceExtensions

{

    //        泛型重载    

     public static T GetService<T>(this IServiceProvider provider)

          => (T)provider.GetService(typeof(T));

     

     //        如果当前服务并未注册,则会抛出异常

     public static object GetRequiredService(this IServiceProvider provider, Type serviceType)

     {

          //      如果当前ServiceProvider实现了 ISupportRequiredService 

          //      则直接调用当前ServiceProvier的GetRequiredService获取服务实例

          var requiredServiceSupportingProvider = provider as ISupportRequiredService;

          if (requiredServiceSupportingProvider != null)

             return requiredServiceSupportingProvider.GetRequiredService(serviceType);

          //      如果当前ServiceProvider未实现ISupportRequiredService

          //      就直接调用GetService获取服务实例,但是如果服务实例为空,则抛出异常

          var service = provider.GetService(serviceType);

          if (service == null)

              throw new InvalidOperationException(Resources.FormatNoServiceRegistered(serviceType));

          return service;

     }

     

    //        泛型版本

     public static T GetRequiredService<T>(this IServiceProvider provider)

          => (T)provider.GetRequiredService(typeof(T));



     //        获取指定注册类型<T>的所有服务实例

     public static IEnumerable<T> GetServices<T>(this IServiceProvider provider)

          => provider.GetRequiredService<IEnumerable<T>>();



     //        同上,

     public static IEnumerable<object> GetServices(this IServiceProvider provider, Type serviceType)

     {

          //      制造一个serviceType类型的IEnumberable<>集合,serviceTypele类型作为当前集合的泛型参数

          var genericEnumerable = typeof(IEnumerable<>).MakeGenericType(serviceType);

          return (IEnumerable<object>)provider.GetRequiredService(genericEnumerable);

     }



     //        创建一个子IServiceProvider实例

     //        内部其实将IServiceScopeFactory接口和一个ServiceScopeFactoryCallSite进行了注册

     //        这个是在IServiceProviderEngine的实现类ServiceProviderEngine中的,以后在详细介绍

     public static IServiceScope CreateScope(this IServiceProvider provider)

          => provider.GetRequiredService<IServiceScopeFactory>().CreateScope();

}