翼度科技»论坛 编程开发 .net 查看内容

ASP.NET Core - 选项系统之选项使用

7

主题

7

帖子

21

积分

新手上路

Rank: 1

积分
21
上一篇 ASP.NET Core - 选项系统之选项配置 中提到 IOptions、IOptionsMonitor 和 IOptionsSnapshot 三个接口,通过这三个接口都可以从依赖注入容器中解析出已经配置的选项类,在我们通过 Configure 方法配置选项时,这三个接口会被同时注册,但三个接口是有区别的,适用场景也有所不同。
1. IOptions


  • IOptions 对象的生命周期是 Singleton (单例),它可以在任意地方进行注入使用
  • 该接口对象在第一次使用的时候被实例化,并且选项类中的内容会一直保持不变,前面也提过选项类内容可以在配置来源修改之后更新,但是通过 IOption 解析的选项类不会随着更新而改变
  • IOptions 接口不支持命名选项模式,它是没有 get 方法的,也并不会默认读取第一个,它只能读取 String.Empty 默认命名的选项,如果没有配置默认选项的话,虽然也能解析出 Options 选项类对象,但是对象的属性都是相应类型的默认值(引用类型是 null,值类型是 0,其他的也都是相应类型的默认值)
  1. public class OptionController : ControllerBase
  2. {
  3.         private readonly BlogOptions _blogOptions;
  4.         public OptionController(IOptions<BlogOptions> options)
  5.         {
  6.                 // 通过 IOptions<TOptions> 接口的 Value 属性读取选项类
  7.                 // 选项类始终是程序启动时加载的值,不会改变
  8.                 _blogOptions = options.Value;
  9.         }
  10. }
复制代码
2. IOptionsMonitor


  • IOptionsMonitor 对象的生命周期是 Scoped(作用域),Scoped 生命周期的特点是不能注入到 Singleton 服务中
  • 在作用域中(最常见的一次Http请求),创建 IOptionsSnapshot 对象实例时,会从配置中读取最新选项值作为快照,并在当前作用域中始终使用该快照。也就是说一次请求中选项类内容保持不变,但是不同请求中可能因为配置来源的修改而不同
  • IOptionsMonitor 支持命名选项
  1. public class OptionController : ControllerBase
  2. {
  3.         private readonly BlogOptions _blogOptions;
  4.         public OptionController(IOptionsSnapshot<BlogOptions> optionsSnapshot)
  5.         {
  6.                 // IOptionsSnapshot<TOptions> 可以通过 Value 属性读取默认的命名的选项类, Options 对象实例创建时读取的配置快照
  7.                 _blogOptions = optionsSnapshot.Value;
  8.                 // 也可以通过 Get 方法获取某一个命名选项,没有指定命名时,默认命名为 string.Empty
  9.                 //_blogOptions = optionsSnapshot.Get(string.Empty);
  10.         }
  11. }
复制代码
3. IOptionsSnapshot


  • IOptionsSnapshot 对象的生命周期也是 Singleton (单例)
  • 通过 IOptionsSnapshot 接口注入的对象每次读取选项值时,都是从配置中读取最新选项值,能够实时获取配置来源的更改
  • 该接口支持命名选项模式
  • 除了可以查看 TOptions 的值,还可以监控 TOptions 配置的更改,支持重新加载配置(CurrentValue),并当配置发生更改时,进行通知(OnChange),支持缓存与缓存失效 (IOptionsMonitorCache),每次调用实例的 CurrentValue 时,会先检查缓存(IOptionsMonitorCache)是否有值,如果有值,则直接用,如果没有,则从配置中读取最新选项值,并记入缓存。当配置发生更改时,会将缓存清空。
  1. public class OptionController : ControllerBase
  2. {
  3.         private readonly BlogOptions _blogOptions;
  4.         public OptionController(IOptionsMonitor<BlogOptions> optionsMonitor)
  5.         {
  6.                 // IOptionsMonitor<TOptions> 接口没有 Value 属性,通过 CurrentValue 获取选项类对象,
  7.                 // 每次调用 CurrentValue都会实时读取配置源,始终是最新配置的值
  8.                 _blogOptions = optionsMonitor.CurrentValue;
  9.                 // 该接口也支持通过 Get 方法获取命名选项
  10.                 _blogOptions = optionsMonitor.Get(string.Empty);
  11.                 // 可以通过 OnChange 注册事件,当配置被加载时会触发事件
  12.                 optionsMonitor.OnChange(OnOptionsChange);
  13.         }
  14.         [HttpGet]
  15.         public Task<BlogOptions> Get()
  16.         {
  17.                 return Task.FromResult(_blogOptions);
  18.         }
  19.         private void OnOptionsChange(BlogOptions options)
  20.         {
  21.                 Console.WriteLine(JsonSerializer.Serialize(options));
  22.         }
  23. }
复制代码
启动应用,调用一次 Get 接口,在 Api 控制器构造函数中注册了配置加载触发事件,之后修改 appsettings.json 配置文件中选项类对于的配置节点内容,可以看到事件触发,控制台中输出了改变之后的选项类内容。

4. 三个接口的选项读取机制演示

三个接口解析的选项类的差别,可以通过以下测试清楚得看出:
配置文件中初始选项节点如下:
  1. "Blog": {
  2.     "Title": "ASP.NET Core Options11",
  3.     "Content": "This is a blog about Options System in ASP.NET Core Framework.",
  4.     "CreateTime": "2022-12-06"
  5. }
复制代码
这里为了方便看出 Scoped 生命周期 IOptionSnapeshoot 接口的变化,所有通过 Web Api 接口来测试
  1. public class OptionController : ControllerBase
  2. {
  3.         private readonly IOptions<BlogOptions> _blogOptions;
  4.         private readonly IOptionsSnapshot<BlogOptions> _blogSnapshotOptions;
  5.         private readonly IOptionsMonitor<BlogOptions> _blogMonitorOptions;
  6.         public OptionController(
  7.                  IOptions<BlogOptions> options,
  8.                 IOptionsSnapshot<BlogOptions> optionsSnapshot,
  9.                 IOptionsMonitor<BlogOptions> optionsMonitor
  10.                 )
  11.         {
  12. // 注意这里不能再把选项类对象先读取出来,否则选项类对象也不会再改变了
  13.                 _blogOptions = options;
  14.                 _blogSnapshotOptions = optionsSnapshot;
  15.                 _blogMonitorOptions = optionsMonitor;
  16.         }
  17.         [HttpGet]
  18.         public Task Get()
  19.         {
  20.                 Console.WriteLine("第一次读取配置:");
  21.                 Console.WriteLine("IOptions<TOptions>:" + JsonSerializer.Serialize(_blogOptions.Value));
  22.                 Console.WriteLine("IOptionsSnapshot<TOptions>:" + JsonSerializer.Serialize(_blogSnapshotOptions.Value));
  23.                 Console.WriteLine("IOptionsMonitor<TOptions>:" + JsonSerializer.Serialize(_blogMonitorOptions.CurrentValue));
  24.                 Console.WriteLine("请修改配置文件!");
  25.                 Console.ReadKey();
  26.                 Console.WriteLine("第二次读取配置:");
  27.                 Console.WriteLine("IOptions<TOptions>:" + JsonSerializer.Serialize(_blogOptions.Value));
  28.                 Console.WriteLine("IOptionsSnapshot<TOptions>:" + JsonSerializer.Serialize(_blogSnapshotOptions.Value));
  29.                 Console.WriteLine("IOptionsMonitor<TOptions>:" + JsonSerializer.Serialize(_blogMonitorOptions.CurrentValue));
  30.                 return Task.CompletedTask;
  31.         }
  32. }
复制代码
之后启动应用调用 Get 接口,并在过程中将配置文件内容修改为以下:
  1. "Blog": {
  2.     "Title": "ASP.NET Core Options222",
  3.     "Content": "This is a blog about Options System in ASP.NET Core Framework.",
  4.     "CreateTime": "2022-12-06"
  5. }
复制代码
可以看到控制台的输出中,第二次读取配置的时候,IOptionsMonitor 接口读取到的内容已经改变

之后不要关闭应用,再调一次 Get 接口,并在过程中再次修改配置如下:
  1. "Blog": {
  2.     "Title": "ASP.NET Core Options333",
  3.     "Content": "This is a blog about Options System in ASP.NET Core Framework.",
  4.     "CreateTime": "2022-12-06"
  5. }
复制代码
这一次的 Get 请求的输出结果如下:

可以看到 IOptionsMonitor 接口每次都能获取到配置文件的实时值,IOptionsSnapshot 接口相较于第一次调用 Get 接口的时候已经改变,获取到了之前修改的值,但是之后的修改它又获取不到了,因为它是 Scoped 生命周期,在一次请求内是保持一致的,而 IOptions 接口获取到的选项类对象是一致不变的。


参考文章:
ASP.NET Core 中的选项模式 | Microsoft Learn
选项模式 - .NET | Microsoft Learn
面向 .NET 库创建者的选项模式指南 - .NET | Microsoft Learn
理解ASP.NET Core - 选项(Options)


ASP.NET Core 系列:
目录:ASP.NET Core 系列总结
上一篇:ASP.NET Core - 选项系统之选项配置

来源:https://www.cnblogs.com/wewant/archive/2023/03/23/17111653.html
免责声明:由于采集信息均来自互联网,如果侵犯了您的权益,请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容,谢谢合作!

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

x

举报 回复 使用道具