ASP.NET Core中的依赖注入,5: ServiceProvider实现揭秘 【解读ServiceCallSite 】

通过上一篇的介绍我们应该对实现在ServiceProvider的总体设计有了一个大致的了解,但是我们刻意回避一个重要的话题,即服务实例最终究竟是采用何种方式提供出来的。ServiceProvider最终采用何种方式提供我们所需的服务实例取决于最终选择了怎样的ServiceCallSite,而服务注册是采用的ServiceDescriptor有决定了ServiceCallSite类型的选择。我们将众多不同类型的ServiceCallSite大体分成两组,一组用来创建最终的服务实例,另一类则与生命周期的管理有关。

服务实例的创建方式主要有三种,分别对应ServiceDescriptor如下三个只读属性。简单来说,如果ImplementationInstance属性返回一个具体的对象,该对象将直接作为提供的服务实例。如果属性ImplementationFactory返回一个具体的委托对象,该委托将会作为提供服务实例的工厂。除此之外,ServiceProvider将会利用ImplementationType属性返回的真是服务类型定位某一个最佳的构造函数来创建最终提供的服务实例。

class ServiceDescriptor
   2: {
public Type                               ImplementationType {  get; }
object                             ImplementationInstance {  get; }
object>     ImplementationFactory {  get; }      
   6: }

服务实例的这三种不同的创建方式最终由三种对应的ServiceCallSite类型来完成,我们将它们的类型分别命名为InstanceCallSite、FactoryCallSite和ConstructorCallSite。如下面的代码片段所示,前两种ServiceCallSite(InstanceCallSite和FactoryCallSite)的实现非常简单,所以我们在这里就不对它们多做介绍了。

class InstanceCallSite : IServiceCallSite
   2: {
private set; }
   4:  
object instance)
   6:     {
this.Instance = instance;
   8:     }
public Expression Build(Expression provider)
  10:     {
this.Instance);
  12:     }
object Invoke(ServiceProvider provider)
  14:     {
return Instance;
  16:     }
  17: }
  18:  
class FactoryCallSite : IServiceCallSite
  20: {
private set; }
object> factory)
  23:     {
this.Factory = factory;
  25:     }
public Expression Build(Expression provider)
  27:     {
this.Factory(p);
return Expression.Invoke(factory, provider);
  30:     }
object Invoke(ServiceProvider provider)
  32:     {
this.Factory(provider);
  34:     }
  35: }

以执行指定构造函数创建服务实例的ConstructorCallSite稍微复杂一点。如下面的代码片段所示,我们在创建一个ConstructorCallSite对象的时候除了指定一个代表构造函数的ConstructorInfo对象之外,还需要指定一组用于初始化对应参数列表的ServiceCallSite。

class ConstructorCallSite : IServiceCallSite
   2: {
private set; }
private set; }
   5:  
public ConstructorCallSite(ConstructorInfo constructorInfo, IServiceCallSite[] parameters)
   7:     {
this.ConstructorInfo = constructorInfo;
this.Parameters = parameters;
  10:     }
  11:  
public Expression Build(Expression provider)
  13:     {
this.ConstructorInfo.GetParameters();
this.Parameters.Select((p, index) => Expression.Convert(p.Build(provider), 
  16:             parameters[index].ParameterType)).ToArray());
  17:     }
  18:  
object Invoke(ServiceProvider provider)
  20:     {
this.Parameters.Select(p => p.Invoke(provider)).ToArray());
  22:     }
  23: }

虽然ConstructorCallSite自身创建服务实例的逻辑很简单,但是如何创建ConstructorCallSite对象本身相对麻烦一些,因为这涉及到如何选择一个最终构造函数的问题。我们在上面专门介绍过这个问题,并且总结出选择构造函数采用的两条基本的策略:

  • ServiceProvider能够提供构造函数的所有参数。
  • 目标构造函数的参数类型集合是所有有效构造函数参数类型集合的超级。

我们将ConstructorCallSite的创建定义在Service类的CreateConstructorCallSite方法中,它具有额外两个辅助方法GetConstructor和GetParameterCallSites,前者用于选择正确的构造函数,后者则为指定的构造函数创建用于初始化参数的ServiceCallSite列表。

class Service : IService
   2: {
private ConstructorCallSite CreateConstructorCallSite(ServiceProvider provider, ISet<Type> callSiteChain)
   4:     {
this.GetConstructor(provider, callSiteChain);
null == constructor)
   7:         {
);
   9:         }
new ConstructorCallSite(constructor, constructor.GetParameters().Select(p => provider.GetServiceCallSite(p.ParameterType, callSiteChain)).ToArray());                                              
  11: }
  12:  
private ConstructorInfo GetConstructor(ServiceProvider provider, ISet<Type> callSiteChain)
  14:     {
this.ServiceDescriptor.ImplementationType.GetConstructors()
this.GetParameterCallSites(c, provider, callSiteChain))).ToArray();
  17:  
  18:         Type[] allParameterTypes = constructors.SelectMany(
  19:             c => c.GetParameters().Select(p => p.ParameterType)).Distinct().ToArray();
  20:  
return constructors.FirstOrDefault(
new HashSet<Type>(c.GetParameters().Select(p => p.ParameterType)).IsSupersetOf(allParameterTypes));
  23:     }
  24:  
private IServiceCallSite[] GetParameterCallSites(ConstructorInfo constructor,ServiceProvider provider,ISet<Type> callSiteChain)
  26:     {
  27:         ParameterInfo[] parameters = constructor.GetParameters();
new IServiceCallSite[parameters.Length];
  29:  
int index = 0; index < serviceCallSites.Length; index++)
  31:         {
  32:             ParameterInfo parameter = parameters[index];
  33:             IServiceCallSite serviceCallSite = provider.GetServiceCallSite(
  34:                 parameter.ParameterType, callSiteChain);
null == serviceCallSite && parameter.HasDefaultValue)
  36:             {
new InstanceCallSite(parameter.DefaultValue);
  38:             }
null == serviceCallSite)
  40:             {
null;
  42:             }
  43:             serviceCallSites[index] = serviceCallSite;
  44:         }
return serviceCallSites;
  46:     }
//其他成员
  48: }



二、用于管理生命周期的ServiceCallSite

服务实例最终采用何种提供方式还与服务注册时采用的生命周期管理模式有关,三种不同的生命周期管理模式(Transient、Scoped和Singleton)分别对应着三种不同的ServiceCallSite类型,我们分别将其命名为TransienCallSite、ScopedCallSite和SingletonCallSite。

对于TransientCallSite来说,它提供服务实例的方式非常直接,那就是直接创建一个新的对象。在此之外还需要考虑一个关于服务回收的问题,那就是如果服务实例对应的类型实现了IDisposable接口,需要将它添加到ServiceProvider的TransientDisposableServices属性中。TransientCallSite具有如下的定义,只读属性ServiceCallSite表示真正用于创建服务实例的ServiceCallSite。

class TransientCallSite : IServiceCallSite
   2: {
private set; }
public TransientCallSite(IServiceCallSite serviceCallSite)
   5:     {
this.ServiceCallSite = serviceCallSite;
   7:     }
   8:  
public  Expression Build(Expression provider)
  10:     {
this.ServiceCallSite.Build(provider));
  12:     }
  13:  
object Invoke(ServiceProvider provider)
  15:     {
this.ServiceCallSite.Invoke(provider));
  17:     }
  18: }
  19:  
class ServiceProvider : IServiceProvider, IDisposable
  21: {
  22:     
object instance)
  24:     {
as IDisposable;
null != disposable)
  27:         {
this.TransientDisposableServices.Add(disposable);
  29:         }
return instance;
  31:     }
//其他成员
  33: }

ScopedCallSite在提供服务实例的时候需要考虑当前ServiceProvider的ResolvedServices属性中是否已经存在已经提供的服务实例,如果已经存在它就无需重复创建。新创建的服务实例需要添加到当前ServiceProvider的ResolvedServices属性中。ScopedCallSite定义如下,ServiceCallSite属性依然表示的是真正用于创建服务实力的ServiceCallSite,Service属性则用来获取保存在当前ServiceProvider的ResolvedServices属性中的服务实例。

class ScopedCallSite : IServiceCallSite
   2: {
private set; }
private set; }
   5:  
public ScopedCallSite(IService service, IServiceCallSite serviceCallSite)
   7:     {
this.Service = service;
this.ServiceCallSite = serviceCallSite;
  10:     }
  11:  
virtual Expression Build(Expression provider)
  13:     {
this.Service);
);
);
null, service, instance);
new Expression[] { service});
this.ServiceCallSite.Build(provider));
  20:  
new[] { instance },Expression.IfThen(Expression.Not(tryGetValue),assign),index);
  22:     }
  23:  
object Invoke(ServiceProvider provider)
  25:     {
object instance;
out instance)
  28:             ? instance
this.ServiceCallSite.Invoke(provider);
  30:     }
  31: }

其实Singleton和Scope这两种模式本质上是等同的,它们表示在某个ServiceScope中的“单例”模式,它们之间的不同之处在于前者的ServiceScope是针对作为根的ServiceProvider,后者则是针对当前ServiceProvider。所以SingletonCallSite是ScopedCallSite的派生类,具体定义如下所示。

class SingletonCallSite : ScopedCallSite
   2: {
public SingletonCallSite(IService service, IServiceCallSite serviceCallSite) : 
base(service, serviceCallSite)
   5:     { }
   6:  
override Expression Build(Expression provider)
   8:     {
));
  10:     }
  11:  
object Invoke(ServiceProvider provider)
  13:     {
base.Invoke(provider.Root);
  15:     }
  16: }



三、创建ServiceCallSite

ServiceCallSite的创建体现在IService接口的CreateServiceSite方法中,在我们的Service类这个方法是如何实现的呢?如下面的代码片段所示,真正用于创建服务实例的ServiceCallSite先根据当前的ServiceDescriptor创建出来,然后再根据采用生命周期管理模式创建出与之匹配的ServiceCallSite。

class Service : IService
   2: {
public IServiceCallSite CreateCallSite(ServiceProvider provider, ISet<Type> callSiteChain)
   4:     {
   5:         IServiceCallSite serviceCallSite = 
this.ServiceDescriptor.ImplementationInstance)
this.ServiceDescriptor.ImplementationInstance)
null;
   9:  
  10:         serviceCallSite = serviceCallSite?? 
this.ServiceDescriptor.ImplementationFactory)
this.ServiceDescriptor.ImplementationFactory)
null);
  14:  
this.CreateConstructorCallSite(provider, callSiteChain);
  16:  
this.Lifetime)
  18:         {
new TransientCallSite(serviceCallSite);
this, serviceCallSite);
this, serviceCallSite);
  22:         }
  23:     }
//其他成员    
  25: }

ASP.NET Core中的依赖注入(1):控制反转(IoC)

ASP.NET Core中的依赖注入(2):依赖注入(DI)

ASP.NET Core中的依赖注入(3):服务注册与提取

ASP.NET Core中的依赖注入(4):构造函数的选择与生命周期管理

ASP.NET Core中的依赖注入(5):ServicePrvider实现揭秘【总体设计】

ASP.NET Core中的依赖注入(5):ServicePrvider实现揭秘【解读ServiceCallSite】

ASP.NET Core中的依赖注入(5):ServicePrvider实现揭秘【补充漏掉的细节】

www.weibo.com/artech

如果你想及时得到个人撰写文章以及著作的消息推送,或者想看看个人推荐的技术资料,可以扫描左边二维码(或者长按识别二维码)关注个人公众号)。

本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。

服务实例的创建方式主要有三种,分别对应ServiceDescriptor如下三个只读属性。简单来说,如果ImplementationInstance属性返回一个具体的对象,该对象将直接作为提供的服务实例。如果属性ImplementationFactory返回一个具体的委托对象,该委托将会作为提供服务实例的工厂。除此之外,ServiceProvider将会利用ImplementationType属性返回的真是服务类型定位某一个最佳的构造函数来创建最终提供的服务实例。

class ServiceDescriptor
   2: {
public Type                               ImplementationType {  get; }
object                             ImplementationInstance {  get; }
object>     ImplementationFactory {  get; }      
   6: }

服务实例的这三种不同的创建方式最终由三种对应的ServiceCallSite类型来完成,我们将它们的类型分别命名为InstanceCallSite、FactoryCallSite和ConstructorCallSite。如下面的代码片段所示,前两种ServiceCallSite(InstanceCallSite和FactoryCallSite)的实现非常简单,所以我们在这里就不对它们多做介绍了。

class InstanceCallSite : IServiceCallSite
   2: {
private set; }
   4:  
object instance)
   6:     {
this.Instance = instance;
   8:     }
public Expression Build(Expression provider)
  10:     {
this.Instance);
  12:     }
object Invoke(ServiceProvider provider)
  14:     {
return Instance;
  16:     }
  17: }
  18:  
class FactoryCallSite : IServiceCallSite
  20: {
private set; }
object> factory)
  23:     {
this.Factory = factory;
  25:     }
public Expression Build(Expression provider)
  27:     {
this.Factory(p);
return Expression.Invoke(factory, provider);
  30:     }
object Invoke(ServiceProvider provider)
  32:     {
this.Factory(provider);
  34:     }
  35: }

以执行指定构造函数创建服务实例的ConstructorCallSite稍微复杂一点。如下面的代码片段所示,我们在创建一个ConstructorCallSite对象的时候除了指定一个代表构造函数的ConstructorInfo对象之外,还需要指定一组用于初始化对应参数列表的ServiceCallSite。

class ConstructorCallSite : IServiceCallSite
   2: {
private set; }
private set; }
   5:  
public ConstructorCallSite(ConstructorInfo constructorInfo, IServiceCallSite[] parameters)
   7:     {
this.ConstructorInfo = constructorInfo;
this.Parameters = parameters;
  10:     }
  11:  
public Expression Build(Expression provider)
  13:     {
this.ConstructorInfo.GetParameters();
this.Parameters.Select((p, index) => Expression.Convert(p.Build(provider), 
  16:             parameters[index].ParameterType)).ToArray());
  17:     }
  18:  
object Invoke(ServiceProvider provider)
  20:     {
this.Parameters.Select(p => p.Invoke(provider)).ToArray());
  22:     }
  23: }

虽然ConstructorCallSite自身创建服务实例的逻辑很简单,但是如何创建ConstructorCallSite对象本身相对麻烦一些,因为这涉及到如何选择一个最终构造函数的问题。我们在上面专门介绍过这个问题,并且总结出选择构造函数采用的两条基本的策略:

  • ServiceProvider能够提供构造函数的所有参数。
  • 目标构造函数的参数类型集合是所有有效构造函数参数类型集合的超级。

我们将ConstructorCallSite的创建定义在Service类的CreateConstructorCallSite方法中,它具有额外两个辅助方法GetConstructor和GetParameterCallSites,前者用于选择正确的构造函数,后者则为指定的构造函数创建用于初始化参数的ServiceCallSite列表。

class Service : IService
   2: {
private ConstructorCallSite CreateConstructorCallSite(ServiceProvider provider, ISet<Type> callSiteChain)
   4:     {
this.GetConstructor(provider, callSiteChain);
null == constructor)
   7:         {
);
   9:         }
new ConstructorCallSite(constructor, constructor.GetParameters().Select(p => provider.GetServiceCallSite(p.ParameterType, callSiteChain)).ToArray());                                              
  11: }
  12:  
private ConstructorInfo GetConstructor(ServiceProvider provider, ISet<Type> callSiteChain)
  14:     {
this.ServiceDescriptor.ImplementationType.GetConstructors()
this.GetParameterCallSites(c, provider, callSiteChain))).ToArray();
  17:  
  18:         Type[] allParameterTypes = constructors.SelectMany(
  19:             c => c.GetParameters().Select(p => p.ParameterType)).Distinct().ToArray();
  20:  
return constructors.FirstOrDefault(
new HashSet<Type>(c.GetParameters().Select(p => p.ParameterType)).IsSupersetOf(allParameterTypes));
  23:     }
  24:  
private IServiceCallSite[] GetParameterCallSites(ConstructorInfo constructor,ServiceProvider provider,ISet<Type> callSiteChain)
  26:     {
  27:         ParameterInfo[] parameters = constructor.GetParameters();
new IServiceCallSite[parameters.Length];
  29:  
int index = 0; index < serviceCallSites.Length; index++)
  31:         {
  32:             ParameterInfo parameter = parameters[index];
  33:             IServiceCallSite serviceCallSite = provider.GetServiceCallSite(
  34:                 parameter.ParameterType, callSiteChain);
null == serviceCallSite && parameter.HasDefaultValue)
  36:             {
new InstanceCallSite(parameter.DefaultValue);
  38:             }
null == serviceCallSite)
  40:             {
null;
  42:             }
  43:             serviceCallSites[index] = serviceCallSite;
  44:         }
return serviceCallSites;
  46:     }
//其他成员
  48: }



二、用于管理生命周期的ServiceCallSite

服务实例最终采用何种提供方式还与服务注册时采用的生命周期管理模式有关,三种不同的生命周期管理模式(Transient、Scoped和Singleton)分别对应着三种不同的ServiceCallSite类型,我们分别将其命名为TransienCallSite、ScopedCallSite和SingletonCallSite。

对于TransientCallSite来说,它提供服务实例的方式非常直接,那就是直接创建一个新的对象。在此之外还需要考虑一个关于服务回收的问题,那就是如果服务实例对应的类型实现了IDisposable接口,需要将它添加到ServiceProvider的TransientDisposableServices属性中。TransientCallSite具有如下的定义,只读属性ServiceCallSite表示真正用于创建服务实例的ServiceCallSite。

class TransientCallSite : IServiceCallSite
   2: {
private set; }
public TransientCallSite(IServiceCallSite serviceCallSite)
   5:     {
this.ServiceCallSite = serviceCallSite;
   7:     }
   8:  
public  Expression Build(Expression provider)
  10:     {
this.ServiceCallSite.Build(provider));
  12:     }
  13:  
object Invoke(ServiceProvider provider)
  15:     {
this.ServiceCallSite.Invoke(provider));
  17:     }
  18: }
  19:  
class ServiceProvider : IServiceProvider, IDisposable
  21: {
  22:     
object instance)
  24:     {
as IDisposable;
null != disposable)
  27:         {
this.TransientDisposableServices.Add(disposable);
  29:         }
return instance;
  31:     }
//其他成员
  33: }

ScopedCallSite在提供服务实例的时候需要考虑当前ServiceProvider的ResolvedServices属性中是否已经存在已经提供的服务实例,如果已经存在它就无需重复创建。新创建的服务实例需要添加到当前ServiceProvider的ResolvedServices属性中。ScopedCallSite定义如下,ServiceCallSite属性依然表示的是真正用于创建服务实力的ServiceCallSite,Service属性则用来获取保存在当前ServiceProvider的ResolvedServices属性中的服务实例。

class ScopedCallSite : IServiceCallSite
   2: {
private set; }
private set; }
   5:  
public ScopedCallSite(IService service, IServiceCallSite serviceCallSite)
   7:     {
this.Service = service;
this.ServiceCallSite = serviceCallSite;
  10:     }
  11:  
virtual Expression Build(Expression provider)
  13:     {
this.Service);
);
);
null, service, instance);
new Expression[] { service});
this.ServiceCallSite.Build(provider));
  20:  
new[] { instance },Expression.IfThen(Expression.Not(tryGetValue),assign),index);
  22:     }
  23:  
object Invoke(ServiceProvider provider)
  25:     {
object instance;
out instance)
  28:             ? instance
this.ServiceCallSite.Invoke(provider);
  30:     }
  31: }

其实Singleton和Scope这两种模式本质上是等同的,它们表示在某个ServiceScope中的“单例”模式,它们之间的不同之处在于前者的ServiceScope是针对作为根的ServiceProvider,后者则是针对当前ServiceProvider。所以SingletonCallSite是ScopedCallSite的派生类,具体定义如下所示。

class SingletonCallSite : ScopedCallSite
   2: {
public SingletonCallSite(IService service, IServiceCallSite serviceCallSite) : 
base(service, serviceCallSite)
   5:     { }
   6:  
override Expression Build(Expression provider)
   8:     {
));
  10:     }
  11:  
object Invoke(ServiceProvider provider)
  13:     {
base.Invoke(provider.Root);
  15:     }
  16: }



三、创建ServiceCallSite

ServiceCallSite的创建体现在IService接口的CreateServiceSite方法中,在我们的Service类这个方法是如何实现的呢?如下面的代码片段所示,真正用于创建服务实例的ServiceCallSite先根据当前的ServiceDescriptor创建出来,然后再根据采用生命周期管理模式创建出与之匹配的ServiceCallSite。

class Service : IService
   2: {
public IServiceCallSite CreateCallSite(ServiceProvider provider, ISet<Type> callSiteChain)
   4:     {
   5:         IServiceCallSite serviceCallSite = 
this.ServiceDescriptor.ImplementationInstance)
this.ServiceDescriptor.ImplementationInstance)
null;
   9:  
  10:         serviceCallSite = serviceCallSite?? 
this.ServiceDescriptor.ImplementationFactory)
this.ServiceDescriptor.ImplementationFactory)
null);
  14:  
this.CreateConstructorCallSite(provider, callSiteChain);
  16:  
this.Lifetime)
  18:         {
new TransientCallSite(serviceCallSite);
this, serviceCallSite);
this, serviceCallSite);
  22:         }
  23:     }
//其他成员    
  25: }

ASP.NET Core中的依赖注入(1):控制反转(IoC)

ASP.NET Core中的依赖注入(2):依赖注入(DI)

ASP.NET Core中的依赖注入(3):服务注册与提取

ASP.NET Core中的依赖注入(4):构造函数的选择与生命周期管理

ASP.NET Core中的依赖注入(5):ServicePrvider实现揭秘【总体设计】

ASP.NET Core中的依赖注入(5):ServicePrvider实现揭秘【解读ServiceCallSite】

ASP.NET Core中的依赖注入(5):ServicePrvider实现揭秘【补充漏掉的细节】