依赖注入[7]: .NET Core DI框架[服务注册]
包含服务注册信息的IServiceCollection对象最终被用来创建作为DI容器的IServiceProvider对象。服务注册就是创建出现相应的ServiceDescriptor对象并将其添加到指定IServiceCollection集合对象中的过程。
目录
一、ServiceDescriptor
二、IServiceCollection
Add
Add{Lifetime}
TryAdd
TryAdd{Lifetime}
TryAddEnumerable
RemoveAll & Replace
一、ServiceDescriptor
通过《依赖注入[6]: .NET Core DI编程体验》的实例演示我们知道作为DI容器的IServiceProvider对象是通过调用IServiceCollection接口的扩展方法BuildServiceProvider创建的,IServiceCollection对象是一个存放服务注册信息的集合。Cat中的服务注册是通过一个类型为ServiceRegistry的对象表示的,在IServiceCollection/IServiceProvider为核心的DI框架中,与之对应的类型为ServiceDescriptor。
DI框架将服务注册存储在一个通过IServiceCollection接口表示的集合之中。如下面的代码片段所示,一个IServiceCollection对象本质上就是一个元素类型为ServiceDescriptor的列表。在默认情况下我们使用的是实现该接口的ServiceCollection类型。
public class ServiceDescriptor { public Type ServiceType { get; } public ServiceLifetime Lifetime { get; } public Type ImplementationType { get; } public Func<IServiceProvider, object> ImplementationFactory { get; } public object ImplementationInstance { get; } public ServiceDescriptor(Type serviceType, object instance); public ServiceDescriptor(Type serviceType, Func<IServiceProvider, object> factory, ServiceLifetime lifetime); public ServiceDescriptor(Type serviceType, Type implementationType, ServiceLifetime lifetime); }
如果我们采用直接提供服务实例的形式来创建ServiceDescriptor对象,意味着服务注册默认采用Singleton生命周期模式。对于通过其他两个构造函数创建创建的ServiceDescriptor对象来说,则需要显式指定采用的生命周期模式。相较于ServiceDescriptor,我们在Cat框架中定义的ServiceRegistry显得更加精炼,因为我们直接提供了一个类型为Func<Cat,Type[], object>的属性来提供对应的服务实例。
除了调用上面介绍的三个构造函数来创建对应的ServiceDescriptor对象之外,我们还可以提供定义在ServiceDescriptor类型中一系列静态方法来创建该对象。如下面的代码片段所示,ServiceDescriptor提供了如下两个名为Describe的方法重载来创建对应的ServiceDescriptor对象。
public class ServiceDescriptor { public static ServiceDescriptor Describe(Type serviceType, Func<IServiceProvider, object> implementationFactory, ServiceLifetime lifetime); public static ServiceDescriptor Describe(Type serviceType, Type implementationType, ServiceLifetime lifetime); }
public class ServiceDescriptor { public static ServiceDescriptor Singleton<TService, TImplementation>() where TService: class where TImplementation: class, TService; public static ServiceDescriptor Singleton<TService, TImplementation>(Func<IServiceProvider, TImplementation> implementationFactory) where TService: class where TImplementation: class, TService; public static ServiceDescriptor Singleton<TService>(Func<IServiceProvider, TService> implementationFactory) where TService: class; public static ServiceDescriptor Singleton<TService>(TService implementationInstance) where TService: class; public static ServiceDescriptor Singleton(Type serviceType, Func<IServiceProvider, object> implementationFactory); public static ServiceDescriptor Singleton(Type serviceType, object implementationInstance); public static ServiceDescriptor Singleton(Type service, Type implementationType); }
二、IServiceCollection
DI框架将服务注册存储在一个通过IServiceCollection接口表示的集合之中。如下面的代码片段所示,一个IServiceCollection对象本质上就是一个元素类型为ServiceDescriptor的列表。在默认情况下我们使用的是实现该接口的ServiceCollection类型。
public interface IServiceCollection : IList<ServiceDescriptor> {} public class ServiceCollection : IServiceCollection {}
Add
我们在应用启动的时候所做的服务注册就是创建出现相应的ServiceDescriptor对象并将其添加到指定IServiceCollection集合对象中的过程。考虑到服务注册是一个高频调用的操作,所以DI框架为IServiceCollection接口定义了一系列扩展方法完成服务注册的工作,比如下面的这两个Add方法可以将指定的一个或者多个ServiceDescriptor对象添加到IServiceCollection集合中。
public static class ServiceCollectionDescriptorExtensions { public static IServiceCollection Add(this IServiceCollection collection, ServiceDescriptor descriptor); public static IServiceCollection Add(this IServiceCollection collection, IEnumerable<ServiceDescriptor> descriptors); }
Add{Lifetime}
DI框架还针对具体生命周期模式为IServiceCollection接口定义了一系列的扩展方法,它们会根据提供的输入创建出对应的ServiceDescriptor对象并将其添加到指定的IServiceCollection对象中。如下所示的是针对Singleton模式的AddSingleton方法重载的定义,针对其他两个生命周期模式的AddScoped和AddTransient方法具有类似的定义。
public static class ServiceCollectionServiceExtensions { public static IServiceCollection AddSingleton<TService>(this IServiceCollection services) where TService: class; public static IServiceCollection AddSingleton<TService, TImplementation>(this IServiceCollection services) where TService: class where TImplementation: class, TService; public static IServiceCollection AddSingleton<TService>(this IServiceCollection services, TService implementationInstance) where TService: class; public static IServiceCollection AddSingleton<TService, TImplementation>(this IServiceCollection services, Func<IServiceProvider, TImplementation> implementationFactory) where TService: class where TImplementation: class, TService; public static IServiceCollection AddSingleton<TService>(this IServiceCollection services, Func<IServiceProvider, TService> implementationFactory) where TService: class; public static IServiceCollection AddSingleton(this IServiceCollection services, Type serviceType); public static IServiceCollection AddSingleton(this IServiceCollection services, Type serviceType, Func<IServiceProvider, object> implementationFactory); public static IServiceCollection AddSingleton(this IServiceCollection services, Type serviceType, object implementationInstance); public static IServiceCollection AddSingleton(this IServiceCollection services, Type serviceType, Type implementationType); }
TryAdd
虽然针对同一个服务类型可以添加多个ServiceDescriptor,但这情况只有在应用需要使用到同一类型的多个服务实例的情况下才有意义,比如我们可以注册多个ServiceDescriptor来提供同一个主题的多个订阅者。如果我们总是根据指定的服务类型来提取单一的服务实例,这种情况下一个服务类型只需要一个ServiceDescriptor对象就够了。对于这种场景我们可能会使用如下两个名为TryAdd的扩展方法,该方法会根据指定ServiceDescriptor提供的服务类型判断对应的服务注册是否存在,只有不存在指定类型的服务注册情况下,我们提供的ServiceDescriptor才会被添加到指定的IServiceCollection对象中。
public static class ServiceCollectionDescriptorExtensions { public static void TryAdd(this IServiceCollection collection, ServiceDescriptor descriptor); public static void TryAdd(this IServiceCollection collection, IEnumerable<ServiceDescriptor> descriptors); }
TryAdd{Lifetime}
扩展方法TryAdd同样具有基于三种生命周期模式的版本,如下所示的针对Singleton模式的TryAddSingleton方法的定义。在指定服务类型对应的ServiceDescriptor不存在的情况下,它们会采用提供的实现类型、服务实例创建工厂以及服务实例来创建生命周期模式为Singleton的ServiceDescriptor对象并将其添加到指定的IServiceCollection对象中。针对其他两种生命周期模式的TryAddScoped和TryAddTransient方法具有类似的定义。
public static class ServiceCollectionDescriptorExtensions { public static void TryAddSingleton<TService>(this IServiceCollection collection) where TService: class; public static void TryAddSingleton<TService, TImplementation>(this IServiceCollection collection) where TService: class where TImplementation: class, TService; public static void TryAddSingleton(this IServiceCollection collection, Type service); public static void TryAddSingleton<TService>(this IServiceCollection collection, TService instance) where TService: class; public static void TryAddSingleton<TService>(this IServiceCollection services, Func<IServiceProvider, TService> implementationFactory) where TService: class; public static void TryAddSingleton(this IServiceCollection collection, Type service, Func<IServiceProvider, object> implementationFactory); public static void TryAddSingleton(this IServiceCollection collection, Type service, Type implementationType); }
TryAddEnumerable
除了上面介绍的扩展方法TryAdd和TryAdd{Lifetime}之外,IServiceCollection接口还具有如下两个名为TryAddEnumerable的扩展方法。当TryAddEnumerable方法在决定将指定的ServiceDescriptor添加到IServiceCollection对象之前,它也会做存在性检验。与TryAdd和TryAdd{Lifetime}方法不同的是,该方法在判断执行的ServiceDescriptor是否存在是会同时考虑服务类型和实现类型。
public static class ServiceCollectionDescriptorExtensions { public static void TryAddEnumerable(this IServiceCollection services, ServiceDescriptor descriptor); public static void TryAddEnumerable(this IServiceCollection services, IEnumerable<ServiceDescriptor> descriptors); }
被TryAddEnumerable方法用来判断存在性的实现类型不只是ServiceDescriptor的ImplementationType属性。如果ServiceDescriptor是通过一个指定的服务实例创建的,那么该实例的类型会作为用来判断存在与否的实现类型。如果ServiceDescriptor是通过提供的服务实例工厂来创建的,那么代表服务实例创建工厂的Func<in T, out TResult>对象的第二个参数类型将被用于判断ServiceDescriptor的存在性。扩张方法TryAddEnumerable的实现逻辑可言通过如下这段程序来验证。
var services = new ServiceCollection(); services.TryAddEnumerable(ServiceDescriptor.Singleton<IFoobarbazgux, Foo>()); Debug.Assert(services.Count == 1); services.TryAddEnumerable(ServiceDescriptor.Singleton<IFoobarbazgux, Foo>()); Debug.Assert(services.Count == 1); services.TryAddEnumerable(ServiceDescriptor.Singleton<IFoobarbazgux>(new Foo())); Debug.Assert(services.Count == 1); Func<IServiceProvider, Foo> factory4Foo = _ => new Foo(); services.TryAddEnumerable(ServiceDescriptor.Singleton<IFoobarbazgux>(factory4Foo)); Debug.Assert(services.Count == 1); services.TryAddEnumerable(ServiceDescriptor.Singleton<IFoobarbazgux, Bar>()); Debug.Assert(services.Count == 2); services.TryAddEnumerable(ServiceDescriptor.Singleton<IFoobarbazgux>(new Baz())); Debug.Assert(services.Count == 3); Func<IServiceProvider, Gux> factory4Gux = _ => new Gux(); services.TryAddEnumerable(ServiceDescriptor.Singleton<IFoobarbazgux>(factory4Gux)); Debug.Assert(services.Count == 4);
如果通过上述策略得到的实现类型为Object,那么TryAddEnumerable会因为实现类型不明确而抛出一个ArgumentException类型的异常。这种情况主要发生在提供的ServiceDescriptor对象是由服务实例工厂创建的情况,所以上面实例中用来创建ServiceDescriptor的工厂类型分别为Func<IServiceProvider, Foo>和Func<IServiceProvider, Gux>,而不是Func<IServiceProvider, object>。
var service = ServiceDescriptor.Singleton<IFoobarbazgux>(_ => new Foo()); new ServiceCollection().TryAddEnumerable(service);
假设我们采用如上所示的方式利用一个Lamda表达式来创建一个ServiceDescriptor对象,对于创建的ServiceDescriptor来说,其服务实例工厂是一个Func<IServiceProvider, object>对象,所以当我们将它作为参数调用TryAddEnumerable方法的会抛出如图1所示的ArgumentException异常,并提示“Implementation type cannot be 'App.IFoobarbazgux' because it is indistinguishable from other services registered for 'App.IFoobarbazgux'.”
RemoveAll & Replace
上面介绍的这些方法最终的目的都是添加新的ServiceDescriptor到指定的IServiceCollection对象中,有的时候我们还希望删除或者替换现有的某个ServiceDescriptor,这种情况下通常发生在需要对当前使用框架中由某个服务提供的功能进行定制的时候。由于IServiceCollection实现了IList<ServiceDescriptor>接口,所以我们可以调用其Clear、Remove和RemoveAt方法来清除或者删除现有的ServiceDescriptor。除此之外,我们还可以选择如下这些扩展方法。
public static class ServiceCollectionDescriptorExtensions { public static IServiceCollection RemoveAll<T>( this IServiceCollection collection); public static IServiceCollection RemoveAll(this IServiceCollection collection, Type serviceType); public static IServiceCollection Replace(this IServiceCollection collection, ServiceDescriptor descriptor); }
var services = new ServiceCollection(); services.Replace(ServiceDescriptor.Singleton<IFoobarbazgux, Foo>()); Debug.Assert(services.Any(it => it.ImplementationType == typeof(Foo))); services.AddSingleton<IFoobarbazgux, Bar>(); services.Replace(ServiceDescriptor.Singleton<IFoobarbazgux, Baz>()); Debug.Assert(!services.Any(it=>it.ImplementationType == typeof(Foo))); Debug.Assert(services.Any(it => it.ImplementationType == typeof(Bar))); Debug.Assert(services.Any(it => it.ImplementationType == typeof(Baz)));
依赖注入[1]: 控制反转
依赖注入[2]: 基于IoC的设计模式
依赖注入[3]: 依赖注入模式
依赖注入[4]: 创建一个简易版的DI框架[上篇]
依赖注入[5]: 创建一个简易版的DI框架[下篇]
依赖注入[6]: .NET Core DI框架[编程体验]
依赖注入[7]: .NET Core DI框架[服务注册]
依赖注入[8]: .NET Core DI框架[服务消费]
相关文章
- .net 温故知新:【7】IOC控制反转,DI依赖注入
- cmd net 命令
- .net 温故知新:【9】.NET日志记录 ILogger使用和原理
- 宝塔面板Linux系统通过Docker部署VB.NET Asp.Net Core WebAPI应用
- 使用SHA256WithRSA来签名和验签(.NET/C#)详解编程语言
- net掌握Linux环境下的.NET开发(linuxdot)
- .net安装 Linux 上的 ASP.NET 环境(linux安装asp)
- .NET访问MySQL:简单实用的方法(.net访问mysql)
- VB.NET构建多层数据库应用:使用MSSQL(vb.net mssql)
- Net不再压着 MSSql,语音变得前景无限(net mssql语音)
- 基于NET技术的Oracle信息服务(.net用oracle)
- NET与Oracle携手走向未来(.net 对oracle)
- NET 与 Oracle技术结合开启数据库新篇章(.net事物oracle)
- 网上解决Net环境下MySQL数据库的同步问题(.net 同步mysql)
- Redis集群实现高性能NET应用(redis集群 .net)
- 使用Oracle64位Net突破技术极限(oracle64位net)
- ASP.NET通过Remotingservice上传文件
- asp.net操作XML按指定格式写入XML数据WriteXml
- ASP.NET中使用后端代码注册脚本生成JQUERY-EASYUI的界面错位的解决方法
- ASP.NET用DataSet导出到Excel的方法
- .net一些无法catch的异常
- 注册页实现激活邮箱验证(asp.netc#)
- .NET操作Excel实例分享
- asp.net使用AJAX实现无刷新分页
- Win7旗舰版中的IIS7配置asp.net的运行环境
- ASP.NET入门之HTML服务器控件概述
- 安装SQLserver2005出现警告32位ASP.NET已经注册,需要注册64位的解决方法
- 服务器安全狗导致ASP.NET网站运行出错的一个案例