zoukankan      html  css  js  c++  java
  • [ASP.NET Core 3框架揭秘] Options[7]: 与配置系统的整合

    Options模型本身与配置系统完全没有关系,但是配置在大部分情况下会作为绑定Options对象的数据源,所以有必要将两者结合在一起。与《扩展与定制》演示的两个例子一样,针对配置系统的集成同样是通过定制Options模型相应的对象来实现的。具体来说,集成配置系统需要解决如下两个问题:

    • 将承载配置数据的IConfiguration对象绑定为Options对象。

    • 自动感知配置数据的变化。

    第一个问题涉及针对Options对象的初始化问题,这自然是通过自定义IConfigureOptions<TOptions>实现类型来解决的,具体来说就是下面的NamedConfigureFromConfigurationOptions<TOptions>类型,它定义在NuGet包“Microsoft.Extensions.Options.ConfigurationExtensions”中。如下面的代码片段所示,NamedConfigureFromConfigurationOptions<TOptions>通过调用ConfigurationBinder的静态方法Bind利用配置绑定机制来实现配置数据向Options对象的转换。

    public class NamedConfigureFromConfigurationOptions<TOptions> : ConfigureNamedOptions<TOptions> where TOptions : class
    {
        public NamedConfigureFromConfigurationOptions(string name, IConfiguration config)
            : base(name, options => ConfigurationBinder.Bind(config, options))
        {}
    }

    第二个问题则采用自定义的IOptionsChangeTokenSource<TOptions>实现类型来解决,具体提供的就是下面的ConfigurationChangeTokenSource<TOptions>。从给出的代码片段可以看出,GetChangeToken方法直接调用IConfiguration对象的GetReloadToken方法得到返回的IChangeToken对象。

    public class ConfigurationChangeTokenSource<TOptions> : IOptionsChangeTokenSource<TOptions>
    {
        private IConfiguration _config;
        public string Name { get; }
    
        public ConfigurationChangeTokenSource(IConfiguration config) : this(Options.DefaultName, config)
        { }
        public ConfigurationChangeTokenSource(string name, IConfiguration config)
        {
            _config = config;
            Name = name ?? Options.DefaultName;
        }
    
        public IChangeToken GetChangeToken() => _config.GetReloadToken()
    }

    将IConfiguration对象绑定为Options对象的NamedConfigureFromConfigurationOptions<TOptions>和用来检测配置数据变化的ConfigurationChangeTokenSource<TOptions>都是通过下面的Configure<TOptions>扩展方法来注册的。

    public static class OptionsConfigurationServiceCollectionExtensions
    {    
        public static IServiceCollection Configure<TOptions>( this IServiceCollection services, IConfiguration config) where TOptions : class
            => services.Configure<TOptions>(Options.Options.DefaultName, config);
        
        public static IServiceCollection Configure<TOptions>( this IServiceCollection services, string name, IConfiguration config)  where TOptions : class
            => services
             .AddSingleton<IOptionsChangeTokenSource<TOptions>>( new ConfigurationChangeTokenSource<TOptions>(name, config))
             .AddSingleton<IConfigureOptions<TOptions>>( new NamedConfigureFromConfigurationOptions<TOptions>(name, config));
    }

    [ASP.NET Core 3框架揭秘] Options[1]: 配置选项的正确使用方式[上篇]
    [ASP.NET Core 3框架揭秘] Options[2]: 配置选项的正确使用方式[下篇]
    [ASP.NET Core 3框架揭秘] Options[3]: Options模型[上篇]
    [ASP.NET Core 3框架揭秘] Options[4]: Options模型[下篇]
    [ASP.NET Core 3框架揭秘] Options[5]: 依赖注入
    [ASP.NET Core 3框架揭秘] Options[6]: 扩展与定制
    [ASP.NET Core 3框架揭秘] Options[7]: 与配置系统的整合

  • 相关阅读:
    JS脚本延时
    Linux的关机与重启命令
    MasterCard信用卡测试卡号-creditcard-1
    HTTP_USER_AGENT
    nginx 502
    今天收到报警邮件,提示网站502 bad gateway,
    Iptables網路連線限制及攻擊防護和相關設定
    #添加屏蔽IP LINUX
    linux下启动和关闭网卡命令
    unfinish
  • 原文地址:https://www.cnblogs.com/artech/p/inside-asp-net-core-06-07.html
Copyright © 2011-2022 走看看