跟我一起学.NetCore之配置变更监听-白红宇的个人博客

发布日期：2021-05-09 09:31:59 浏览次数：5 分类：博客文章

本文共 4096 字，大约阅读时间需要 13 分钟。

前言

通常程序中配置少不了，配置的修改也避免不了，配置的热更新为此给应用程序带来很大的便捷，不用重启，提高用户体验；但往往有时候需要对修改进行审计，也就是需要记录，有时候也会针对配置修改的时候触发相关操作，比如说发邮件通知，或是其他业务操作等，遇到这种情况，配置变更监听的用处就体现出来了，接下来就尝尝鲜去；

正文

在看前两篇文档的小伙伴可能会看到IConfiguration、IConfigurationProvider接口中有一个GetReloadToken()方法，之前只是注释了一下，其实此方法返回的值就是变更通知的核心，如下图的定义：

看看返回的IChangeToken里定义了什么

对于上面GetReloadToken其实最后返回的真正类型是ConfigurationReloadToken，继承与IChangeToken，其作用就是为了通知程序：改变之后的配置源数据已经通过对应的IConfigurationProvider重新加载；看看其中是本质是啥？

通过以上代码显示，其实ConfigurationReloadToken就是利用CancellationTokenSource在OnReload触发的时候进行通知，这里暂且不深入再研究CancellationTokenSource了，不然感觉要跑题了(可以私下研究研究)，停，赶紧回来；

大概了解到变更通知的原理，再来回顾一下配置IConfigurationRoot和IConfigurationSection，其实这两个微软其实已经实现了两个类，ConfigurationRoot和ConfigurationSection，有默认的实现，简单看看是如何实现的，稍微进行了重点注释哦；

namespace Microsoft.Extensions.Configuration{    // 实现了IConfiguration 和ConfigurationRoot    public class ConfigurationRoot : IConfigurationRoot, IConfiguration, IDisposable    {        // 用于存放注册进来的IConfigurationProvider，Provider的作用还记得吗？        private readonly IList
   
     _providers;        // 默认创建一个ConfirationReloadToken，        private ConfigurationReloadToken _changeToken = new ConfigurationReloadToken();        // 提供一个_providers的访问属性        public IEnumerable
    
      Providers => _providers;        // 实现中括号访问，获取配置值，看过前两篇文章的应该知道都是用中括号的方式获取值        public string this[string key]        {            get            {   // 注意，这里倒序遍历，这样就会导致相同Key，后注册的配置源会覆盖之前的                for (int num = _providers.Count - 1; num >= 0; num--)                {                    if (_providers[num].TryGet(key, out string value))                    {                        return value;                    }                }                return null;            }            set            {                if (!_providers.Any())                {                    throw new InvalidOperationException(Resources.Error_NoSources);                }                // 其实这里的设置值只是在内存里，没有持久化                foreach (IConfigurationProvider provider in _providers)                {                    provider.Set(key, value);                }            }        }        // 构造函数        public ConfigurationRoot(IList
     
       providers)        {            if (providers == null)            {                throw new ArgumentNullException("providers");            }            _providers = providers;            _changeTokenRegistrations = new List
      
       (providers.Count);            // 遍历所有有providers,加载数据            foreach (IConfigurationProvider p in providers)            {                // 加载数据                p.Load();                // 注册监听及回调                _changeTokenRegistrations.Add(ChangeToken.OnChange((Func
       
        )(() => p.GetReloadToken()), (Action)delegate                {                    // 通知                    RaiseChanged();                }));            }        }        // 获取通知Token        public IChangeToken GetReloadToken()        {            return _changeToken;        }        // 重新加载数据         public void Reload()        {            // 遍历所有provider进行重新加载数据            foreach (IConfigurationProvider provider in _providers)            {                provider.Load();            }            // 发送通知            RaiseChanged();        }        // 触发通知        private void RaiseChanged()        {            Interlocked.Exchange(ref _changeToken, new ConfigurationReloadToken()).OnReload();        }        ........省去一些方法......    }}

ConfigurationSection就不贴代码，其实内部大多都是通过调用了IConfigrationRoot对象的方法来实现的，还是贴个图吧，如下：

由ConfigurationRoot可见，触发通知的方法RaiseChanged在ConfigurationRoot构造函数中(ConfigurationProvider对应的IChangeToken回调中调用)及Reload的方法中进行调用，也就是说当IConfigurationProvider捕捉到配置源改变时会利用IChangeToken进行通知，或通过调用Reload方法加载时也会通知；

好了好了，理论就暂且说这么多了，撸撸代码，看看是如何监听的，话说在前头，理论一大堆，使用很简单，哈哈哈哈哈，控制台程序走起来：

运行结果

经过上面案例演示，一个IChangeToken只能通知一次，需要多次创建，如果多次都是自己肯定很麻烦，所以微软已经想到了，提供了一个静态函数，如下代码优化即可：

运行结果：

静态方法这种形式，就是ConfigurationRoot构造函数中IChangeToken监听的方式，忘了的话往上再看看；

总结

有没有被这节给忽悠了，一个这么简单的使用，还说那么多"废话"，写文字不累吗？我去，又过12点了，洗洗睡觉！！！！！；下次开始说说“Option”~~~

----------------------------------------------

一个被程序搞丑的帅小伙，关注"Code综艺圈"，跟我一起学~~~

转载地址：https://www.cnblogs.com/zoe-zyq/p/13533131.html 如侵犯您的版权，请留言回复原文章的地址，我们会给您删除此文章，给您带来不便请您谅解！

上一篇：跟我一起学.NetCore之选项(Options)核心类型简介

下一篇：跟我一起学.NetCore之自定义配置源-热更新-对象绑定

发表评论

关于作者

喝酒易醉，品茶养心，人生如梦，品茶悟道，何以解忧？唯有杜康！

-- 愿君每日到此一游！

发表评论

最新留言

关于作者

推荐文章