ASP.NETCoreWeb开发之OptionsPattern
这节我们来讲一下,在ASP.NET Core Web开发中,读取配置文件信息的新方式:Options。
前言 /
在ASP.NET Web框架中,我们读取配置文件中的数据,在不使用第三方框架的情况下,可能需要通过ConfigurationManager这个类去读取配置文件中的信息,并且,如果我们人为更改了配置文件,需要重启系统才能使新的配置数据生效。这种方式并不能称得上优雅和高效。
所以,在ASP.NET Core Web框架中,微软为我们提供了读取配置信息的新方式——将配置信息映射到数据类中,并且配合IOC,可以通过依赖注入的方式拿到这个类,读取我们想要的信息,下面就来了解一下它。
如何配置?/
首先,我们需要如下前置信息:
- 在appsettings.json中配置要读取的信息
![](https://pic3.zhimg.com/80/v2-5f30dc2c322c30582c3a056f55631226_720w.jpg)
- 对应的编写一个数据类
![](https://pic3.zhimg.com/80/v2-cd7935e2bd30ab69dc4f9f3d7d739e66_720w.jpg)
然后,我们就可以选择在Startup.cs中,编写配置相关代码(在Program.cs文件中也可以指定配置,具体大家可以参考官网文档),请看下图:
![](https://pic1.zhimg.com/80/v2-c3987fa4fe3bec9f1d5da1e791bff530_720w.jpg)
在ConfigureServices方法中,我们可以配置Options。方式有很多种,此处仅演示比较简单的几种。通过使用services的Configure/AddOptions泛型方法,其泛型类型为要映射的类,然后指定要读取的区域(即Section),即可完成配置。默认如果不指定SectionName,则自动使用类名进行匹配,如果读取SectionName跟映射的类名不一致,则使用其重载方法,传入SectionName即可。
IOptions<T> /
在完成配置以后,就可以使用依赖注入的方式,在需要的地方获取到配置信息,注入的形式之一是IOptions<T>接口,泛型T则指定为映射的配置类,请看下图:
![](https://pic2.zhimg.com/80/v2-0957d69032c87bf19e26f18c95605b0d_720w.jpg)
使用IOptions<T>注入的配置对象,不具有动态性,也就是说系统运行时修改配置文件,是不会自动更新的。所以可以在类中直接声明配置类对象,在构造方法中直接从IOptions的Value属性中取到。
让我们打印出来看一下:
这样的形式,是优雅的,面向对象的,但是在系统的整个运行过程中,使用IOptions<T>注入的配置对象,是不会随配置信息的改变而变化的,也就说,还是要重启才能看到配置信息的更改。
IOptionsSnapshot<T> /
当然,除了IOptions<T>,我们还可以使用IOptionsSnapshot<T>去注入配置对象:
IOptionsSnapshot接口,提供了对配置信息的更新功能,但是并不是实时的,在同一个域或者本次请求中如果出现配置信息更改,配置对象中的数据是不会变化的,也就是保证整个上下文中的配置信息不会改变。为此,上述代码中我与IOptions做出对比,第一次请求数据两者相同,为初始值:
//第 1 次请求 IOptions:name:Charles,age:18,profession:.NET Developer IOptionsSnapshot:name:Charles,age:18,profession:.NET Developer
然后我修改配置文件,进行第二次请求,IOptionsSnapshot重新读取了配置信息:
![](https://pic2.zhimg.com/80/v2-e71fcf44c0db483a32945c6edb920831_720w.jpg)
//第 2 次请求 IOptions:name:Charles,age:18,profession:.NET Developer IOptionsSnapshot:name:宿春磊,age:19,profession:.NET 开发者
IOptionsMonitor<T> /
最后,除了IOptionsSnapshot,微软还提供了IOptionsMonitor,这位则是提供“全天候”的配置监控服务,配置文件一改,它就立刻更新,请看下图:
我将三者做一对比,在读取前就通过代码更新配置文件,因为OptionsPattern是延迟读取的,所以在改之前使IOptionsSnapshot读取一遍值,这样才能体现出三者的不同:
//第 1 次请求 IOptions:name:宿春磊,age:19,profession:.NET 开发者 IOptionsSnapshot:name:宿春磊,age:19,profession:.NET 开发者 IOptionsMonitor:name:宿春磊Charles,age:19,profession:.NET 开发者
第二次请求的时候,IOptionsSnapshot才取到新值。
//第 2 次请求 IOptions:name:宿春磊,age:19,profession:.NET 开发者 IOptionsSnapshot:name:宿春磊Charles,age:19,profession:.NET 开发者 IOptionsMonitor:name:宿春磊Charles,age:19,profession:.NET 开发者
本节到此结束...