一, 前言
只是讲 ASP.NET core 3.x 通用主机的大致原理, 这些东西是通过查看源码以及自己根据经验总结得来的, 在文章中不会深入源码, 因为个人觉得懂原理就晓得扩展点, 后期碰到有需求的时候再仔细去研究源码也不迟.
阅读前你应该先去了解下(推荐博客园老 A 的博客):
ASP.NET core 中的依赖注入,
配置,
讲解的方式是:
概述
逐一介绍核心类及扩展方式
通常我们如何使用
总结
二, 概述
以前的控制台应用程序, winform 程序启动时 main 首先被执行, 后续都是我们自己的代码来实现框架和业务上的东东, 比如我们要使用配置就 ConfigurationManager.AppSettings... 若想使用依赖注入则需要引入第三方框架, 比如 autofact.ASP.NET framework 时代也类似
在. net core 3.0 之前的版本默认使用的是 IwebHost, 它内部定义了 IoC 容器(服务注册体现在 Startup.ConfigServices), 和各种配置源的设置(体现在 Program 配置主机时), 我们后续的 Controler,View, 包括业务代码可以很容易做依赖注入和获取配置信息(包括运用选项模式)
有时候我们希望写一个服务, 但是这个服务并不是用来做 API/Web, 处理 http 请求的, 比如想做一个物联网的后端采集服务, 一直等待远端硬件设备提交实时数据过来, 后端进行处理. 但是又希望使用 ASP.NET core 提供的 配置, 依赖注入, 日志 和其它功能. 后来微软就将 ASP.NET core 中的这套东西抽离出来了, 叫做通用主机, 用来承载任何服务, 这些自定义服务中就可以很方便地使用配置, 依赖注入, 日志, 和其它功能. 现在 ASP.NET core 只是由通用主机承载的其中一种服务.
2.1, 默认情况下主要的实现思路是:
2.1.1, 定义(微软定义好的):
定义 HOST, 它包含 IoC 根容器, 主机和应用程序的生命周期事件定定义, IHostedService 集合(一个实例就是一个服务或者叫应用, ASP.NET core 就是一个这样的实例)
允许调用方提供一堆委托来向 IoC 中注册服务, 和设置主机和应用的 "配置源"
提供向主机添加 IHostedService 的实现对象的方法
允许调用方注册主机和应用在启动和停止阶段触发的相应事件
2.1.2, 配置(我们的代码, 微软定义很多辅助方法):
创建 IHost 实例
向 Host 的 IoC 容器中注册各种服务
配置主机和应用程序的 " 配置源
向主机内部添加 IHostedService 实例(也就是我们最终的服务)
主机和应用的生命周期事件, 来实现一些特殊任务
2.1.3, 启动阶段(微软定义好的)
上面所谓的配置基本都是通过委托实现的(通常微软提供的各种扩展方法最终也是执行委托), 回调这些委托以设置 "配置源" 和注册服务
最后遍历启动 HostedService
在启动过程中还会回调相应的生命周期事件
2.2, 啥是应用?
上面提了几次 "应用", 现在对于主机来说 ASP.NET core 框架就是一个应用, 我们上面举例说的 "物联网后端服务" 是另一个应用. 从代码上来说就是一个 IHostedService 的实现.
主机和应用是一对多的关系, 多个应用可以共享主机的信息, 如: 主机的 IoC 容器, 主机的配置. 应用配置. 应用当然也可以自己去创建自己的 IoC 根容器和配置对象
主机配置和应用配置有关系? 这两个配置对象都存在于 Host 中, 主机配置是只跟主机相关的配置, 应用配置是主机中多个应用共享的配置, 如果主机中只有一个应用, 那么完全可以拿它做最终的应用配置. 另外应用配置包含主机配置
注意: 在理解时要记住我们现在的目的是讲解通用主机, 意思是可以承载你自己定义的服务的主机, 别去想什么 mvc controller action 路由之类的
三, 核心类
下面分别介绍下主机中的几个核心默认实现类, 几乎每个类都有对应的接口, 为了缩短篇幅, 便于理解就不讲接口了.
3.1,Host
它代表主机, 用来宿主 (承载) 我们应用(一个 IHostedService 的实现).
主要包含: 日志, 主机和应用的生命周期事件, IoC 根容器, 主机的选项对象, 启动停止 / 停止方法.
接口中只定义了: IoC 根容器 + Start + Stop 方法
它在 Program.Main 中被创建, 配置和启动
默认实现 Microsoft.Extensions.Hosting.Internal.Host, 它是一个 internal 的类, 这个主机将来被启动时:
触发主机的 WaitForStartAsync 事件
逐一启动主机内部的 hostedService
触发_applicationLifetime?.NotifyStarted(); 事件
停止时就反过来, 先逐一停止 hostedService, 触发响应事件, 最后停止主机
扩展:
因为默认 Host 是 internal 修饰的, 所以无法继承
自定义实现 IHost;(这不说了, 你可以随心所欲)
订阅主机和应用的生命周期事件(实现 IHostLifetime,IHostApplicationLifetime 并添加到 IoC 容器)
大部分情况下方式 2 实现起来更容易也更常见
提一嘴, ASP.NET core 3.x 现在也是使用的这个默认主机, 只是在上面做了根 Web 相关的配置, 将在下一篇讲解
3.2,HostBuilder
Host 的职责只是完成主机该有的功能, 那么它的创建及配置最好另外定义一个类 HostBuilder, 它是 Host 的创建器(工厂), 我们通常
在系统启动时 (Program.Man) 先创建 HostBuilder,
然后进行配置(向 IoC 容器注册服务, 设置主机和应用的 "配置源"),
最后调用 Build 方法生成我们最终的 Host
通过接口 IHostBuilder 源码可以初略看出它 (通过委托的方式) 提供以下功能
设置主机和应用的 "配置源"
配置 IoC 容器本身
想 IoC 容器添加服务
创建 Host
有个 Properties 属性, 是个字典类型, 可以在构建 Host 的多个步骤中传递数据
扩展:
对于我们使用者来说主要是通过它的方法向内部塞入各种委托, 以达到向 IoC 容器注册服务和设置主机和应用的 "配置源"
也可以但估计很少去实现主机的 IHostBuilder; 继承 HostBuilder 意义也不大, 因为它没有提供抽象和虚方法
默认 Build 流程
初始化主机配置对象 IConfiguration, 主要是回调, 主机没有做其它的
初始化主机环境对象_hostingEnvironment
应用程序名字从上一步的主机配置里来
环境名 (开发? 调试?) 从配置里来, 若没有则默认是生产模式 "Production"
内容根也从配置里来, 若没有则是当前程序路径
根据内容跟创建一个 ContentRootFileProvider 实现类是 PhysicalFileProvider
初始化 HostBuilderContext, 根据上面的配置和环境创建这个上下文(这里只是暂时用的主机配置, 下面会被替换成应用的配置)
初始化应用配置
以上面的内容根作为配置查找的根(若将来提供物理文件作为配置源时需要此属性)
将主机配置塞入这个应用配置, 所以应用配置 = 主机配置 + 回调后的配置
最后将 HostBuilderContext 的 Configuration 替换为此配置对象
创建 IoC 容器
创建 ServiceCollection, 并将上面的几个对象以单利模式放入进去
还要放入 IHostApplicationLifetime 和 IHostLifetime 和 Host
开启选项模式, 注册日志
回调 configureServicesAction
调用工厂_serviceProviderFactory 创建 ServiceProvider
回调_configureContainerActions
最后返回容器
调用容器解析并返回 Host
3.3,HostBuilder 的工厂方法 Host.CreateDefaultBuilder
上面有了 Host, 也有了对应的创建器 HostBuilder, 为啥还要再提供一个工厂方法呢?
因为职责分离原则, Host 只负责承载应用并提供容器和设置配置源; HostBuilder 只是负责配置并创建 Host, 尽可能提供一些默认值(前提时将来调用方未提供那些参数). 此时我们可以直接用 HostBuilder 来创建 Host 并启动它, 但别忘了. net core 是一个通用框架, 它应提供一个更简洁的方式来创建最终的 Host, 因此它提供了静态方法 Host.CreateDefaultBuilder, 它尽可能提供更多的默认值, 核心任务如下:
new HostBuilder
设置程序的当前目录为内容根
为主机配置 设置 环境变量作为配置源(只关注前缀 DOTNET_的环境变量)
为应用配置设置 以 "appsettings.json" 和 "appsettings.{env.EnvironmentName}.json" 作为配置源; 同时也将环境变量加入到应用的配置源; 最后将命令行参数加入到配置源
配置日志
若是开发模式, 还会配置依赖注入的范围验证
四, 从使用者的角度来说
通过自定义实现 IHostedService 的类来实现我们的服务, 我们的服务中的类可以
直接使用依赖注入,
也可以通过依赖注入获取主机配置和全局应用配置对象, 或者更方便的是进一步使用选项模式
我们也可以注入日志记录器
由于主机创建过程的相关数据几乎都放进了 IoC 容器中, 因此我们也可以通过依赖注入拿到
其它...
在 Program.man 调用 Host.CreateDefaultBuilder, 如果需要, 提供相应的委托来注册服务和设置主机和应用的 "配置源", 最好是通过相关扩展方法和自定义扩展方法. 重点是记得注入我们自己的服务实现类
五, 总结
.net core 为我们提供了新的承载应用 (包括但不仅限于 ASP.NET core) 的方式 -->通用主机, 通过它我们可以很容易的在自己的应用中使用依赖注入, 配置, 日志等, 你可以发挥想象实现很多牛 B 的框架.
ASP.NET core 3.x 开始默认也是使用它来承载的
核心的 Host,HostBuilder,Host.CreateDefaultBuilder 实现了通用主机, 并提供了扩展点
最后我想说如果在. net core 上提供一个默认的 aop 方案就更完美了.
下一篇试试说下 asp.netcore 是如何承载到通用主机上的
来源: https://www.cnblogs.com/jionsoft/p/12154519.html