目录
- 写在前面
- 什么是依赖注入?
- 依赖注入的目的是为了什么?
- 怎么使用依赖注入?一、在Startup类型的构造函数中注入二、在Startup类型的Configure方法中注入三、在中间件类型构造函数中注入四、在中间件类型的Invoke/InvokeAsync方法中注入五、在Controller类型的构造函数中注入六、在Controller的Action方法中注入七、在视图中注入
- 写在后面
回到顶部
写在前面
上一篇大家已经粗略接触了解到.NET Core中间件的使用:ASP .Net Core 中间件的使用(一):搭建静态文件服务器/访问指定文件,
.NET Core框架中很多核心对象都是通过依赖注入的方式提供的,那什么是依赖注入?
这也是个老生常谈的问题,到底依赖注入是什么? 为什么要用它? 初学者特别容易对控制反转IOC(Iversion of Control),DI等概念搞晕。
回到顶部
什么是依赖注入?
提到依赖注入,大家一定会想到控制反转,怎么了解,控制反转是一种设计原则(Inversion of Control,缩写为IoC),而依赖注入((Dependency Injection,简称DI))是它的一种实现方式。
当一个类需要另一个类协作来完成工作的时候就产生了依赖。比如我们在AccountController这个控制器需要完成和用户相关的注册、登录 等事情。
这里有一个设计原则:依赖于抽象,而不是具体的实现,当一个类依赖于具体依赖时,它被认为与该类紧密耦合。
回到顶部
依赖注入的目的是为了什么?
控制反转用于解耦,将接口和实现的耦合降低,有一个好处就是,一个接口,可以进行不同的实现,这样提高扩展性,确保代码的可维护性和扩展性。
通俗的讲,就是对象在被使用前,我们需要New一下对象,创建一个实例对象,然后在进行其他操作。
回到顶部
怎么使用依赖注入?
.NET Core 自带了依赖注入的框架,我们可以归纳为这几个使用方式,当然还有很多使用方法(常规,泛型,工厂),就不一一举例了:
- 构造函数注入;
- 方法注入;
- 属性注入;
这么归纳是不是感觉不太好理解?没关系,我们进一步细化为如下使用方式:
- 在Startup类型的构造函数中注入;
- 在Startup类型的Configure方法中注入;
- 在中间件类型构造函数中注入;
- 在中间件类型的Invoke/InvokeAsync方法中注入;
- 在Controller类型的构造函数中注入;
- 在Controller的Action方法中注入;
一、在Startup类型的构造函数中注入
配置的IConfiguration对象和表示承载环境的IHostEnvironment对象可以直接注入Startup构造函数中。
当然也可以通过注入IWebHostEnvironment对象的方式得到当前承载环境相关的信息,
这是因为ASP.NET Core应用中的承载环境通过IWebHostEnvironment接口表示,IWebHostEnvironment接口派生于IHostEnvironment接口)。
我们可以通过一个简单的实例来验证针对Startup的构造函数注入。
如下面的代码片段所示,我们在调用IWebHostBuilder接口的Startup方法时注册了自定义的Startup类型。
在定义Startup类型时,我们在其构造函数中注入上述3个对象,提供的调试断言不仅证明了3个对象不为Null,还表明采用IHostEnvironment接口和IWebHostEnvironment接口得到的其实是同一个实例。
![18d6955c1092d6e01f30bc277144ba5d.gif](https://i-blog.csdnimg.cn/blog_migrate/0a11ac2aa12dd5616ddcc37750e20c1c.gif)
class Program{ static void Main() { Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder.UseStartup()) .Build() .Run(); }}public class Startup{ public Startup(IConfiguration configuration, IHostEnvironment hostingEnvironment,IWebHostEnvironment webHostEnvironment) { Debug.Assert(configuration != null); Debug.Assert(hostingEnvironment != null); Debug.Assert(webHostEnvironment != null); Debug.Assert(ReferenceEquals(hostingEnvironment, webHostEnvironment)); } public void Configure(IApplicationBuilder app) { }}
![60612cb8f8e55ad39ddc570069140606.gif](https://i-blog.csdnimg.cn/blog_migrate/119da3f794ef5c50c6d1a5a679a6150f.gif)
二、在Startup类型的Configure方法中注入
这种注入方式也叫管道注入,这种是使用比较多的一种注入方式,因为.NET Core创建项目的时候已经在Startup.cs类里面生成框架了(管道注入),
如果构造函数注入还可以对注入的服务有所选择,那么对于Configure方法来说,通过任意方式注册的服务都可以注入其中,包括通过调用
IHostBuilder、IWebHostBuilder和Startup自身的ConfigureServices方法注册的服务,还包括框架自行注册的所有服务。
如下面的代码代码片段所示,我们分别调用IWebHostBuilder和Startup的ConfigureServices方法注册了针对IStudent接口和ISchool接口的服务,这两个服务直接注入Startup的Configure方法中。另外,Configure方法要求提供一个用来注册中间件的IApplicationBuilder对象作为参数,但是对该参数出现的位置并未做任何限制。
![287bb69d72a66c3bead6511c18a863af.gif](https://i-blog.csdnimg.cn/blog_migrate/4579fe283fc652795089e594d928b13a.gif)
class Program{ static void Main() { Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder .UseStartup() .ConfigureServices(svcs => svcs.AddSingleton())) .Build() .Run(); }}public class Startup{ public void ConfigureServices(IServiceCollection services) => services.AddSingleton(); public void Configure(IApplicationBuilder app, IStudent student, ISchool school) { Debug.Assert(student != null); Debug.Assert(school!= null); }}
![23b1e3a713a4e9a3135b20cff60f6a5b.gif](https://i-blog.csdnimg.cn/blog_migrate/dc7d3025285785860687b364bf337f77.gif)
三、在中间件类型构造函数中注入
ASP.NET Core请求处理管道最重要的对象是用来真正处理请求的中间件。
由于ASP.NET Core在创建中间件对象并利用它们构建整个请求处理管道时,所有的服务都已经注册完毕,所以任何一个注册的服务都可以注入中间件类型的构造函数中。
如下所示的代码片段体现了针对中间件类型的构造函数注入。
![fe87c09a6d89d23f33bd928fb330fdb7.gif](https://i-blog.csdnimg.cn/blog_migrate/4b772dedbf095e1fcfffee8ab5b883c5.gif)
class Program{ static void Main() { Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder .ConfigureServices(svcs => svcs .AddSingleton() .AddSingleton() .AddSingleton()) .Configure(app => app.UseMiddleware())) .Build() .Run(); }}public class studentschoolMiddleware : IMiddleware{ public studentschoolMiddleware(IStudent student, ISchool school) { Debug.Assert(student != null); Debug.Assert(school != null); } public Task InvokeAsync(HttpContext context, RequestDelegate next) { Debug.Assert(next != null); return Task.CompletedTask; }}
![6c3a002b6eafc5e05f852796b9616366.gif](https://i-blog.csdnimg.cn/blog_migrate/440b700e328bfb910d9546d101fc2e28.gif)
四、在中间件类型的Invoke/InvokeAsync方法中注入
如果采用基于约定的中间件类型定义方式,注册的服务还可以直接注入真正用于处理请求的InvokeAsync方法或者Invoke方法中。
另外,将方法命名为InvokeAsync更符合TAP(Task-based Asynchronous Pattern)编程模式,之所以保留Invoke方法命名,主要是出于版本兼容的目的。
如下所示的代码片段展示了针对InvokeAsync方法的服务注入。
![5a2abc42faa520b8bee1420093df79e1.gif](https://i-blog.csdnimg.cn/blog_migrate/5f419b2a74ea8a0d6c32096abab96eef.gif)
class Program{ static void Main() { Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder .ConfigureServices(svcs => svcs .AddSingleton() .AddSingleton()) .Configure(app => app.UseMiddleware())) .Build() .Run(); }}public class studentschoolMiddleware{ private readonly RequestDelegate _next; public studentschoolMiddleware(RequestDelegate next) => _next = next; public Task InvokeAsync(HttpContext context, IStudent student, ISchool school) { Debug.Assert(context != null); Debug.Assert(student != null); Debug.Assert(school != null); return _next(context); }}
![6af5259dd4d4a4434edc2a363444de69.gif](https://i-blog.csdnimg.cn/blog_migrate/b3e570bc85cd8d4341302b8d6ef38d2b.gif)
对于基于约定的中间件,构造函数注入与方法注入存在一个本质区别。
由于中间件被注册为一个Singleton对象,所以我们不应该在它的构造函数中注入Scoped服务。
Scoped服务只能注入中间件类型的InvokeAsync方法中,因为依赖服务是在针对当前请求的服务范围中提供的,所以能够确保Scoped服务在当前请求处理结束之后被释放。
五、在Controller类型的构造函数中注入
在一个ASP.NET Core MVC应用中,我们可以在定义的Controller中以构造函数注入的方式注入所需的服务。
在如下所示的代码片段中,我们将IStudentschool服务注入到HomeController的构造函数中。
![f43c619bcad0c750e6152367a928b869.gif](https://i-blog.csdnimg.cn/blog_migrate/c1eaedde5ddadbc6b9c36ae38e3bb202.gif)
class Program{ static void Main() { Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder .ConfigureServices(svcs => svcs .AddSingleton() .AddSingleton() .AddControllersWithViews()) .Configure(app => app .UseRouting() .UseEndpoints(endpoints => endpoints.MapControllers()))) .Build() .Run(); }}public class HomeController : Controller{ public HomeController(IStudentschool studentschool) => Debug.Assert(studentschool!= null);}
![a11c47b14636f01e23c83cdeeac605cf.gif](https://i-blog.csdnimg.cn/blog_migrate/d81bb1b6fe2f14c93eedf7b2c18bbb92.gif)
六、在Controller的Action方法中注入
借助于ASP.NET Core MVC基于模型绑定的参数绑定机制,我们可以将注册的服务绑定到目标Action方法的参数上,进而实现针对Action方法的依赖注入。
在采用这种类型的注入方式时,我们需要在注入参数上按照如下的方式标注FromServicesAttribute特性,用以确定参数绑定的来源是注册的服务。
在如下所示的代码片段
![eb1de8bb0dd1024f48780c3576a8caa4.gif](https://i-blog.csdnimg.cn/blog_migrate/518f44100dcf0ad21416449dd6109212.gif)
class Program{ static void Main() { Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder .ConfigureServices(svcs => svcs .AddSingleton() .AddControllersWithViews()) .Configure(app => app .UseRouting() .UseEndpoints(endpoints => endpoints.MapControllers()))) .Build() .Run(); }}public class HomeController: Controller{ [HttpGet("/")] public void Index([FromServices]IStudentschool studentschool) { Debug.Assert(Studentschool!= null); }}
![4dbe718b1bff89e3daf3cb49c05580b1.gif](https://i-blog.csdnimg.cn/blog_migrate/5fa5e469bf6a36a8dbd8a29b9b5902b4.gif)
七、在视图中注入
在ASP.NET Core MVC应用中,我们还可以将服务注册到现的View中。
假设我们定义了如下这个简单的MVC程序,并定义了一个简单的HomeController。
如下代码片段
![d3e17967499dc76b1e067da14241a316.gif](https://i-blog.csdnimg.cn/blog_migrate/8294d654de1a7539c0683406c304fb8b.gif)
class Program{ static void Main() { Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder .ConfigureServices(svcs => svcs .AddSingleton() .AddControllersWithViews()) .Configure(app => app .UseRouting() .UseEndpoints(endpoints => endpoints.MapControllers()))) .Build() .Run(); }}public class HomeController: Controller{ [HttpGet("/")] public IActionResult Index() => View();}
![7611e8fc482aa0b2cbdac3a88db97896.gif](https://i-blog.csdnimg.cn/blog_migrate/eb7e38338a0abde3d1a5a57ac085fc41.gif)
我们为HomeController定义了一个路由指向根路径(“/”)的Action方法Index,该方法在调用View方法呈现默认的View之前,
将注入的IStudentschool服务以ViewBag的形式传递到View中。
如下所示的代码片段是这个Action方法对应View(/Views/Home/Index.cshtml)的定义,我们通过@inject指令注入了IStudentschool服务,并
将属性名设置为Studentschool,这意味着当前View对象将添加一个Studentschool属性来引用注入的服务。
@inject IStudentschool Studentschool@{ Debug.Assert(Studentschool!= null);}
回到顶部
写在后面
到这里就简单介绍了.NET Core依赖注入的使用方式,更多的使用方式还有待探索,一些使用过程当中的注意事项也需要探索,如:
- 有效地设计服务及其依赖关系;
- 防止多线程问题;
- 防止内存泄漏;
- 防止潜在的错误;
- 如果使用了服务注入,还要考虑服务生命周期(服务不能依赖于生命周期小于其自身的服务。);