ASP.NETCore依赖关系注入
1.前言
面向对象设计(OOD)里有一个重要的思想就是依赖倒置原则(DIP),并由该原则牵引出依赖注入(DI)、控制反转(IOC)及其容器等老生常谈的概念,初学者很容易被这些概念搞晕(包括我在内),在学习Core依赖注入服务之前,下面让我们先了解下依赖倒置原则(DIP)、依赖注入(DI)、控制反转(IOC)等概念,然后再深入学习Core依赖注入服务。
2.依赖倒置原则(DIP)
高层模块不依赖于低层模块的实现,而低层模块依赖于高层模块定义的接口。通俗来讲,就是高层模块定义接口,低层模块负责实现。
2.依赖注入(DI)
2.1依赖(D)
当一个类需要另一个类协作来完成工作的时候就产生了依赖。
示例1:
public class MyDependency
{
public MyDependency()
{
}
public Task WriteMessage(string message)
{
Console.WriteLine($"MyDependency.WriteMessage called. Message: {message}");
return Task.FromResult(0);
}
}
public class IndexModel : PageModel
{
MyDependency _dependency = new MyDependency();
public void OnGet()
{
_dependency.WriteMessage("IndexModel.OnGet created this message.");
}
}
由上述代码可以看到IndexModel模块输出消息必须要实例化MyDependency模块,也就是说IndexModel模块业务的实现必须依赖于MyDependency模块,这就是依赖。
2.2 注入(I)
根据DIP设计原则:高层模块不依赖于低层模块的实现,而低层模块依赖于高层模块定义的接口,所以我们在这里定义一个接口供高层模块调用,底层模块负责实现。
示例2:
public interface IMyDependency
{
Task WriteMessage(string message);
}
public class MyDependency: IMyDependency
{
public MyDependency()
{
}
public Task WriteMessage(string message)
{
Console.WriteLine($"MyDependency.WriteMessage called. Message: {message}");
return Task.FromResult(0);
}
}
public class IndexModel : PageModel
{
IMyDependency _dependency = new MyDependency();
public void OnGet()
{
_dependency.WriteMessage("IndexModel.OnGet created this message.");
}
}
从上述代码可以看到当我们调用IndexModel模块OnGetAsync方法的时候,是通过IMyDependency接口实例化MyDependency类去实现其方法内容的,这叫控制正转。但是Master说,我们不应该创建MyDependency类,而是让调用者给你传递,于是你通过构造函数让外界把这两个依赖给你。
示例3:
public interface IMyDependency
{
Task WriteMessage(string message);
}
public class MyDependency : IMyDependency
{
private readonly ILogger<MyDependency> _logger;
public MyDependency(ILogger<MyDependency> logger)
{
_logger = logger;
}
public Task WriteMessage(string message)
{
_logger.LogInformation(
"MyDependency.WriteMessage called. Message: {MESSAGE}",
message);
return Task.FromResult(0);
}
}
public class IndexModel : PageModel
{
private readonly IMyDependency _dependency;
public IndexModel(IMyDependency dependency)
{
_dependency = dependency;
}
public void OnGet()
{
_dependency.WriteMessage("IndexModel.OnGet created this message.");
}
}
从上述代码可以看到把依赖的创建丢给第三方系统(例:Autofac,Unity容器),也叫控制反转(IOC)容器。自己只负责使用,其它人丢给你依赖的这个过程理解为注入。也叫控制反转(IOC)。注意,框架内部ILogger接口已注入,无需手动再重新注入。
2.3 IOC容器
IOC容器可以看作是负责统一管理依赖关系的地方。常见有Autofac,Unity。
容器只要负责两件事情:
●绑定服务与实例之间的关系
●获取实例,并对实例进行管理(创建与销毁)
3.依赖倒置原则(DIP)与控制反转(IOC)的区别
DIP是一种软件设计原则,它仅仅告诉你高低层模块之间应该如何依赖,但是它并没有告诉我们如何解除相互依赖模块的耦合。而IOC则是一种软件设计模式,它告诉我们该如何解除模块的耦合,它为相互依赖的组件提供抽象,将依赖(低层模块)对象的获得交给第三方系统(例:Autofac,Unity容器)来控制,即依赖对象不在被依赖模块的类中直接通过new来获取。
4.NET Core依赖注入(DI)服务
经过上面描述,大家应该应该对依赖倒置原则(DIP)、依赖注入(DI)、控制反转(IOC)这几个概念有一定了解对吧。在.NET Core中DI的核心分为两个组件:IServiceCollection和 IServiceProvider。
- IServiceCollection负责注册
- IServiceProvider负责提供实例
下面让我们来学习下NET Core是怎么依赖注入(DI)服务。
第一步:使用接口来实现依赖反转。定义 IMyDependency 服务。
public interface IMyDependency
{
Task WriteMessage(string message);
}
第二步:定义IMyDependency 服务的实现类MyDependency。
public class MyDependency : IMyDependency
{
private readonly ILogger<MyDependency> _logger;
public MyDependency(ILogger<MyDependency> logger)
{
_logger = logger;
}
public Task WriteMessage(string message)
{
_logger.LogInformation(
"MyDependency.WriteMessage called. Message: {MESSAGE}",
message);
return Task.FromResult(0);
}
}
第三步:把IMyDependency 服务注册到服务容器中。
public void ConfigureServices(IServiceCollection services)
{
//注册将服务生命期的范围限定为单个请求的生命期,下节再来聊服务生命期
services.AddScoped<IMyDependency, MyDependency>();
}
第四步:把服务注入到使用它的类的构造函数中。在HomeController里面调用IndexModel.OnGet方法输出WriteMessage消息。
public class IndexModel : PageModel
{
private readonly IMyDependency _dependency;
public IndexModel(IMyDependency dependency)
{
_dependency = dependency;
}
public void OnGet()
{
_dependency.WriteMessage("IndexModel.OnGet created this message.");
}
}
private readonly IMyDependency _iMyDependency;
public HomeController(IMyDependency iMyDependency)
{
_iMyDependency = iMyDependency;
}
public IActionResult Index()
{
IndexModel _IndexModel = new IndexModel(_iMyDependency);
_IndexModel.OnGet();
return View();
}
WriteMessage日志消息如下:
5.默认服务容器替换
下面我们将来演示内置容器怎么替换为其他容器示例,比如替换第三方 Autofac容器,我们需要在Startup.ConfigureServices方法里面注册Autofac容器,具体代码如下:
public IServiceProvider ConfigureServices(IServiceCollection services)
{
// Add Autofac
var containerBuilder = new ContainerBuilder();
containerBuilder.RegisterModule<DefaultModule>();
containerBuilder.Populate(services);
var container = containerBuilder.Build();
return new AutofacServiceProvider(container);
}
这里需要注意的是如果需要使用第三方容器,Startup.ConfigureServices 必须返回 IServiceProvider。然后自定义一个模块类配置依赖关系,具体代码如下:
public class DefaultModule : Module
{
protected override void Load(ContainerBuilder builder)
{
builder.RegisterType<CharacterRepository>().As<ICharacterRepository>();
}
}
应用程序在运行时,使用 Autofac 来解析类型,并注入依赖关系。
到此这篇关于ASP.NET Core依赖关系注入的文章就介绍到这了。希望对大家的学习有所帮助,也希望大家多多支持编程网。
免责声明:
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341