[ASP.NET Core 3框架揭秘] Options[7]: 与配置系统的整合

2021-04-27 02:26

阅读:716

标签:ase   静态   系统   order   sof   针对   nop   静态方法   binder   

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

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

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

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

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

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

public class ConfigurationChangeTokenSource : IOptionsChangeTokenSource
{
    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和用来检测配置数据变化的ConfigurationChangeTokenSource都是通过下面的Configure扩展方法来注册的。

public static class OptionsConfigurationServiceCollectionExtensions
{    
    public static IServiceCollection Configure( this IServiceCollection services, IConfiguration config) where TOptions : class
        => services.Configure(Options.Options.DefaultName, config);
    
    public static IServiceCollection Configure( this IServiceCollection services, string name, IConfiguration config)  where TOptions : class
        => services
         .AddSingleton>( new ConfigurationChangeTokenSource(name, config))
         .AddSingleton>( new NamedConfigureFromConfigurationOptions(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]: 与配置系统的整合

[ASP.NET Core 3框架揭秘] Options[7]: 与配置系统的整合

标签:ase   静态   系统   order   sof   针对   nop   静态方法   binder   

原文地址:https://www.cnblogs.com/artech/p/inside-asp-net-core-06-07.html


评论


亲,登录后才可以留言!