[Asp.net 5] DependencyInjection项目代码分析
最近在研究开源代码,正好发现Asp.net5的源码,下载地址:https://github.com/aspnet。
今天主要讲的是DependencyInjection这部分,抛砖引玉,供大家参考,也欢迎莅临斧正。闲话不多说,下面就代码进行简单分析
项目架构如下:
一共包含DependencyInjection、DependencyInjection.Abstractions、DependencyInjection.Autofac、DependencyInjection.Ninject以及DependencyInjection.Tests五个工程。
- DependencyInjection.Abstractions 基础的接口和类,使用时对外暴露的基本信息。
- DependencyInjection 微软自己实现的DI接口
- DependencyInjection.Autofac 使用Autofac(该组件不知道是否是开源的)实现的DI
- DependencyInjection.Ninject 使用Ninject(该组件也不知道是否开源)实现的DI
- DependencyInjection.Tests 对于上面四个工程的测试代码,该部分可以不看,但是对于DI的使用还是有参考价值的。
DependencyInjection.Abstractions
该工程包含基本的接口以及一些基础的类/枚举。对于面向接口编程,使用者不需要知道实现的细节,只需要了解相应的接口便可。另外三个工程(DependencyInjection、DependencyInjection.Autofac、DependencyInjection.Ninject)就是对于该工程的相关接口的实现;使用中可以选择其中一个实现即可,也就是说使用微软这个DI,DependencyInjection.Abstractions是必须引用的类库,另外三个工程(如上所指),引入一个即可。
DependencyInjection.Abstractions 这个工程中包含的文件不是很多,下面我就将该工程文件截图:
该工程中缺少一个关键接口——IServiceProvider,该接口位于System下,有如下定义:
public interface IServiceProvider { object GetService(Type serviceType); }
该接口的作用是根据传入的类型,并把它转化为相应的实例,该接口是DI的核心,是最终干活的类/接口。
但是该接口的定义存在缺陷,返回值类型是object类型的,用户使用的时候还需要进行强制类型转换,所以就对该接口进行了扩展(ServiceProviderExtensions),扩展的定义如下(省略了具体实现):
public static class ServiceProviderExtensions { public static T GetService<T>([NotNull] this IServiceProvider provider); public static object GetRequiredService([NotNull] this IServiceProvider provider, [NotNull] Type serviceType); public static T GetRequiredService<T>([NotNull] this IServiceProvider provider); public static IEnumerable<T> GetRequiredServices<T>([NotNull] this IServiceProvider provider); public static IEnumerable<object> GetRequiredServices([NotNull] this IServiceProvider provider, [NotNull] Type serviceType); }
使用ServiceProvidoer创建出来的实例实际是有相应的生命周期的,框架中使用枚举ServiceLifetime表示,定义如下:
public enum ServiceLifetime { Singleton,//全局唯一 Scoped,//一定范围的 Transient//瞬间 }
一共分为三种,三种的时间长短是Transient<Scoped<Singleton。Transient代表仅当前实例(每次都创建一个新的),Scoped代表当前范围(会在ServiceScope中定义),Singleton代表全家唯一(类似于单例)。
IServiceScopeFactory和IServiceScope,这俩个接口很简单,故名思义IServiceScopeFactory是Scope的一个工厂类,产生一个ServiceScope对象。IServiceScope对象会生成一个IServiceProvidoer对象,一般来说通过IServiceScope就是枚举Scoped所代表的范围。这俩个接口定义如下:
public interface IServiceScopeFactory { IServiceScope CreateScope(); } public interface IServiceScope : IDisposable { IServiceProvider ServiceProvider { get; } }
对于注册成Scoped范围的接口/类,可以通过不同的Scope拿到不同的IServiceProvidoer,之后创建不同的范围的实例,下面我将Tests工程下的一段测试代码拿出来,略作修改(将var 替换成实际的接口,阅读方便)
//services.AddScoped<IFakeScopedService, FakeService>(); public void NestedScopedServiceCanBeResolved() { IServiceProvider container = CreateContainer(); IServiceScopeFactory outerScopeFactory = container.GetService<IServiceScopeFactory>(); using (IServiceScope outerScope = outerScopeFactory.CreateScope()) { IServiceScopeFactory innerScopeFactory = outerScope.ServiceProvider.GetService<IServiceScopeFactory>(); using (IServiceScope innerScope = innerScopeFactory.CreateScope()) { IFakeScopedService outerScopedService = outerScope.ServiceProvider.GetService<IFakeScopedService>(); IFakeScopedService innerScopedService = innerScope.ServiceProvider.GetService<IFakeScopedService>(); Assert.NotEqual(outerScopedService, innerScopedService); } } }
上面几个类的关系大概如下图所示:
ServiceDescriptor类:该类是一个描述类,描述DI的映射关系。该类的属性主要有3个(并不恰当),注入的源类,注入的生成类,注入的范围(ServiceLifetime)。而对于注入的生成类又分为三种:生成类的类型、生成类的实例、生成类的工厂。所以ServiceDescriptor的定义如下所示:
public class ServiceDescriptor { public ServiceLifetime Lifetime { get; } public Type ServiceType { get; } public Type ImplementationType { get; } public object ImplementationInstance { get; } public Func<IServiceProvider, object> ImplementationFactory { get; } }
IServiceCollection接口比较简单就是 IList<ServiceDescriptor>。ServiceCollectionExtensions是对IServiceCollection接口的扩展方法集合。
这几个类的关系如下图所示:
剩余俩个类:ActivatorUtilities、ObjectFactory(其实是个代理/delegate)是用于反射创建实例。
整个工程我对接口、类、代理、枚举重新划分了下文件夹如下图所示:
将在下一篇文章中对DependencyInjection.Autofac、DependencyInjection.Ninject进行分析,最后再对微软自己的DI实现进行分析。
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· go语言实现终端里的倒计时
· 如何编写易于单元测试的代码
· 10年+ .NET Coder 心语,封装的思维:从隐藏、稳定开始理解其本质意义
· .NET Core 中如何实现缓存的预热?
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· 周边上新:园子的第一款马克杯温暖上架
· Open-Sora 2.0 重磅开源!
· 分享 3 个 .NET 开源的文件压缩处理库,助力快速实现文件压缩解压功能!
· Ollama——大语言模型本地部署的极速利器
· DeepSeek如何颠覆传统软件测试?测试工程师会被淘汰吗?