Net6 Configuration & Options 源码分析 Part1

在Net6中配置系统一共由两个部分组成Options 模型配置系统.它们是两个完全独立的系统。

第一部分主要记录配置系统

下面演示的几个实例具有一个共同的特征( 1. 将配置绑定为Options对象),即都采用配置系统来提供绑定Options对象的原始数据,实际上,Options 框架具有一个完全独立的模型,可以称为Options 模型。这个独立的Options 模型本身并不依赖于配置系统,让配置系统来提供配置数据仅仅是通过 Options 模型的一个扩展点实现的。在很多情况下,可能并不需要将应用的配置选项定义在配置文件中,在应用启动时直接初始化可能是一种更方便、快捷的方式

以上引用 ASP.NET Core 3 框架揭秘

使用

IConfiguration IConfigurationBuilder IConfigurationSource

读取的配置信息最终会转换成一个IConfiguration对象供应用程序使用。IConfigurationBuilder 对象是IConfiguration对象的构建者,而构建IConfiguration是需要的数据来源用IConfigurationSource对象表示,它代表配置数据最原始的来源.以键值对的形式读取配置。以上是在使用层面,其实在IConfigurationSource还有个IConfigurationProvider。

MemoryConfiguration 使用

以下示例创建一个ConfigurationBuilder(IConfigurationBuilder接口的默认实现类型)对象,并为之注册一个或者多个 IConfigurationSource 对象,最后利用它来创建我们需要的IConfiguration对象作为对外的数据的操作接口。

  1. var source = new Dictionary<string, string>{
  2. ["key"] ="hello",
  3. };
  4. var configuration = new ConfigurationBuilder().Add (new MemoryConfigurationSource(InitialData = source )).Build();
  5. public class TestOptions {
  6. string name;
  7. public DateTime TestOptions (IConfiguration configuration){
  8. name = configuration["key"];
  9. }
  10. }
读取结构化的配置/树形层次结构

IConfigurationRoot与IConfigurationSection组成了一个逻辑上树形结构数据。两者均实现了IConfiguration。前者作为根节点。后者作为普通节点。

  1. var source = new Dictionary<string, string>{
  2. {"TestOptions:Key1" ,"TestOptions key1"},
  3. {"TestOptions:Key2" ,"TestOptions key2"},
  4. {"UserInfo:key1" ,"UserInfo"},
  5. };
  6. var rootConfiguration = new ConfigurationBuilder().Add(new MemoryConfigurationSource() { InitialData = source }).Build();
  7. configurationSection = configuration.GetSection("TestOptions");
  8. configurationSection = configuration.GetSection("UserInfo");
绑定到POCO对象 ConfigurationBinder 也可以叫做配置绑定

包:Microsoft.Extensions.Configuration.Binder

ConfigurationBinder是一个帮助类是对IConfiguration的扩展类,内部就是通过反射tpye 然后在利用IConfiguration绑定节点到type并返回实例。

值得注意的是,如果你的节点没有对应的type属性会报错比如你的配置源中有个叫Name的节点,但对应的POCO对象并没有这个属性就会抛异常。但这是通过BinderOptions设置的。

  1. var configuration = new ConfigurationBuilder().Add(new MemoryConfigurationSource() { InitialData = source }).Build();
  2. var testOption = configuration.GetSection("TestOptions").Get<TestOpetion>();
  3. Console.WriteLine(testOption.Key1);

JsonConfigurationSource

一般不需要手动创建这个 JsonConfigurationSource对象,只需要调用 IConfiguration Builder接口的AddJsonFile扩展方法添加指定的JSON文件即可

  1. var configuration = new ConfigurationBuilder().AddJsonFile("appsettings.json").AddJsonFile($"appsettings.{environment}.json.Build();//两个appsettings内容会合并。
  2. var test = configuration.GetSection("TestOptions").Get<>(TestOptions);

其它数据源

  1. CommandLineConfigurationSource
  2. EnvironmentVariablesConfigurationSource

    环境变量存储位置:系统/用户/当前进程的环境变量(系统和用户级别的环境变量保存在注册表)

    Environment静态类用于操作环境变量。GetEnvironmentVariables返回当前所有环境变量
  3. FileConfigurationSource

绑定配置项的值 TypeConverter/数据结构及其转换

配置的同步 ConfigurationReloadToken

ConfigurationReloadToken本质上就是对 CancellationTokenSource的封装。

注册个回调事件当配置源发生改变。

  1. var config = new ConfigurationBuilder().Add(new MemoryConfigurationSource() { InitialData = source }).Build();
  2. ChangeToken.OnChange(() => config.GetReloadToken(), () =>
  3. {
  4. Console.WriteLine("config change call back!");
  5. });
  6. }

使用篇总结

:1.IConfigurationSource内由IConfigurationProvider提供数据, 2.IConfigurationBuilder build出来的IConfigurationRoot 作为根节点,IConfigurationRoot内部维护了一个IConfigurationProvider集合,是由IConfigurationBuilder 从自身的IConfigurationSource集合整理出来的。IConfigurationRoot与IConfigurationSection组成了树形结构数据,但是IConfigurationSection的数据均是从根节点获取的。

接口 实现 注释
IConfigurationProvider ConfigurationProvider-MemoryConfigurationProvider 数据提供者
IConfigurationSource MemoryConfigurationSource 数据源
IConfigurationBuilder ConfigurationBuilder Builder类收集数据源创建IConfiguration
IConfiguration IConfigurationRoot/IConfigurationSection 读取数据操作

源码分析

Microsoft.Extensions.Configuration.Abstractions

Microsoft.Extensions.Configuration

Microsoft.Extensions.Configuration.Binder

从三个方面入手源码,

  1. 数据源收集与构建:IConfigurationBuilder ConfigurationBuilder 作为数据源采集,然后创建出ConfigurationRoot,
  2. 对外操作类:IConfiguration 用来对外提供数据,实现了它的类跟接口有,ConfigurationSection IConfigurationSection,ConfigurationRoot IConfigurationRoot
  3. 数据源 :IConfigurationSource ConfigurationProvider MemoryConfigurationSource MemoryConfigurationProvider

数据源收集与构建 ConfigurationBuilder :IConfigurationBuilder

ConfigurationBuilder用来收集IConfigurationSource,并根据数据源提供的provider用其build方法构建出ConfigurationRoot。

  1. public class ConfigurationBuilder : IConfigurationBuilder
  2. {
  3. // 返回用于获取配置值的源。你通过Add方法添加的IConfigurationSource都存在这里了
  4. public IList<IConfigurationSource> Sources { get; } = new List<IConfigurationSource>();
  5. // 属性则以字典的形式存放任意的自定义属性。
  6. public IDictionary<string, object> Properties { get; } = new Dictionary<string, object>();
  7. // Adds a new configuration source.
  8. public IConfigurationBuilder Add(IConfigurationSource source!!)
  9. {
  10. Sources.Add(source); return this;
  11. }
  12. // 方法很简单,直接调用收集到的Source的build同名方法,然后拿到对应的provider 最后用此providers 集合生成 ConfigurationRoot
  13. public IConfigurationRoot Build()
  14. {
  15. var providers = new List<IConfigurationProvider>();
  16. foreach (IConfigurationSource source in Sources)
  17. {
  18. IConfigurationProvider provider = source.Build(this);
  19. providers.Add(provider);
  20. }
  21. return new ConfigurationRoot(providers);
  22. }
  23. }

对外操作类 IConfiguration

表示一组键/值应用程序配置属性。 用于读取配置它对应了连个实现类IConfigurationSection与ConfigurationRoot

  1. /// 表示一组键/值应用程序配置属性。
  2. public interface IConfiguration
  3. {
  4. // Gets or sets a configuration value. 当执行这个索引的时候,它会按照与 GetSection方法完全一致的逻辑得到一个 IConfigurationSection对象,并返回其 Value属性
  5. string? this[string key] { get; set; }
  6. // 获取具有指定键的配置子节。
  7. IConfigurationSection GetSection(string key);
  8. // 获取直接子代配置子节。
  9. IEnumerable<IConfigurationSection> GetChildren();
  10. // 返回一个<see cref="IChangeToken"/>,用于观察该配置何时被重新加载。
  11. IChangeToken GetReloadToken();
  12. }

ConfigurationSection:IConfigurationSection:IConfiguration

表示普通节点,其数据还是以IConfigurationRoot为源头,其实就是对IConfigurationRoot的封装让使用这从使用逻辑上由一个树形结构的数据结构 概念。利用属性path 与属性key 拼接成 字典key在内部找数据,所以不是所有section都会有值

  1. // 表示应用程序配置值的一节。
  2. public interface IConfigurationSection : IConfiguration
  3. {
  4. string Key { get; }
  5. // 节点的路径.
  6. string Path { get; }
  7. //节点对应的数据。( 因为data是个字典所以你给出的key(路径) 一定要是字典的key才会有值否则为null很正常)
  8. string? Value { get; set; }
  9. }
  10. public class ConfigurationSection : IConfigurationSection
  11. {
  12. private readonly IConfigurationRoot _root;
  13. private readonly string _path;
  14. private string? _key;
  15. public ConfigurationSection(IConfigurationRoot root!!, string path!!)
  16. {
  17. _root = root;
  18. _path = path;
  19. }
  20. public string? this[string key]
  21. {
  22. get return _root[ConfigurationPath.Combine(Path, key)];
  23. set _root[ConfigurationPath.Combine(Path, key)] = value;
  24. }
  25. public IConfigurationSection GetSection(string key) => _root.GetSection(ConfigurationPath.Combine(Path, key));
  26. public IEnumerable<IConfigurationSection> GetChildren() => _root.GetChildrenImplementation(Path);
  27. public IChangeToken GetReloadToken() => _root.GetReloadToken();
  28. public string Path => _path;
  29. public string Key { get return _key; }
  30. public string? Value { get return _root[Path]; set _root[Path] = value; }
  31. }

ConfigurationRoot:IConfigurationRoot:IConfiguration 表示根节点

它由ConfigurationBuilder创建出来,同时ConfigurationBuilder把收集到的IConfigurationProvider集合作为参数传入,在构造方法内它会调用他们的load方法进行初始化对应的IConfigurationProvider的data属性。用于后续调用Get方法使用。同时注册了RaiseChanged这样 仍和 一个provider发生了change 都会执行都会执行注册在此root节点的ReloadToken回调

我们将IConfigurationRoot 对象看作一棵配置树的跟接单

  1. GetConfiguration 后来在居上
  2. this[string key] -> GetConfiguration
  3. IChangeToken GetReloadToken() => _changeToken; 获取token 后可以注册此root下任何一个provider 发生change时的回调。
  1. /// <summary>
  2. /// The root node for a configuration.
  3. /// </summary>
  4. public class ConfigurationRoot : IConfigurationRoot, IDisposable
  5. {
  6. private readonly IList<IConfigurationProvider> _providers;
  7. private readonly IList<IDisposable> _changeTokenRegistrations;
  8. private ConfigurationReloadToken _changeToken = new ConfigurationReloadToken();
  9. public ConfigurationRoot(IList<IConfigurationProvider> providers!!)
  10. {
  11. _providers = providers;
  12. _changeTokenRegistrations = new List<IDisposable>(providers.Count);
  13. foreach (IConfigurationProvider p in providers)
  14. {
  15. p.Load();
  16. _changeTokenRegistrations.Add(ChangeToken.OnChange(() => p.GetReloadToken(), () => RaiseChanged()));
  17. }
  18. }
  19. internal static string? GetConfiguration(IList<IConfigurationProvider> providers, string key)
  20. {
  21. for (int i = providers.Count - 1; i >= 0; i--)
  22. {
  23. IConfigurationProvider provider = providers[i];
  24. if (provider.TryGet(key, out string? value))
  25. {
  26. return value;
  27. }
  28. }
  29. return null;
  30. }
  31. // Gets or sets the value corresponding to a configuration key.
  32. public string? this[string key]
  33. {
  34. get => GetConfiguration(_providers, key);
  35. set => SetConfiguration(_providers, key, value);
  36. }
  37. public IEnumerable<IConfigurationSection> GetChildren() => this.GetChildrenImplementation(null);
  38. public IChangeToken GetReloadToken() => _changeToken;
  39. public IConfigurationSection GetSection(string key) => new ConfigurationSection(this, key);
  40. ....
  41. }

数据源

netcore 的数据源是由Source 以及 Proivder 组成。前者负责创建后者。后者提供具体的数据源。

IConfigurationSource

此接口只有一个Build创建对应的provider.实现它的有常用类有FileConfigurationSource 以及MemoryConfigurationSource 请看具体的实现类

  1. public interface IConfigurationSource
  2. {
  3. IConfigurationProvider Build(IConfigurationBuilder builder);
  4. }

ConfigurationProvider:IConfigurationProvider

作为其它provider 的基类就如微软所的一样“Base helper class for implementing an IConfigurationProvider”,负责了保存子类整理好的数据源以及根据此数据源的一些基础操作如get /GetChildKeys / GetReloadToken

以及一个比较重要的虚方法方法Load,由具体的子类实现如FiletConfigurationPorivder / MemoryConfigurationProvider(他没实现Load方法因为他在构造函数就把这事情做了)以及构造方法中对

这里的 OnReload()会触发 Reload 通知并重新生成一个新的ReloadToken 注意新生成的ReloadToekn 是没注册任何回调事件的。 可以通过GetReloadToken() 获得对应的token 然后通过ChangeToken.OnChange方式注册个callback

  1. public abstract class ConfigurationProvider : IConfigurationProvider
  2. {
  3. protected IDictionary<string, string?> Data { get; set; }
  4. private ConfigurationReloadToken _reloadToken = new ConfigurationReloadToken();
  5. protected ConfigurationProvider()
  6. {
  7. Data = new Dictionary<string, string?>(StringComparer.OrdinalIgnoreCase);
  8. }
  9. public virtual bool TryGet(string key, out string? value) => Data.TryGetValue(key, out value);
  10. public virtual void Set(string key, string? value) => Data[key] = value;
  11. public virtual void Load(){ }
  12. // 当前节点下的所有子节点的key 这里不包含孙子节点.
  13. public virtual IEnumerable<string> GetChildKeys(
  14. IEnumerable<string> earlierKeys,
  15. string? parentPath)
  16. {
  17. var results = new List<string>();
  18. if (parentPath is null)
  19. {
  20. foreach (KeyValuePair<string, string?> kv in Data)
  21. {
  22. results.Add(Segment(kv.Key, 0));
  23. }
  24. }
  25. else
  26. {
  27. Debug.Assert(ConfigurationPath.KeyDelimiter == ":");
  28. foreach (KeyValuePair<string, string?> kv in Data)
  29. {
  30. if (kv.Key.Length > parentPath.Length &&
  31. kv.Key.StartsWith(parentPath, StringComparison.OrdinalIgnoreCase) &&
  32. kv.Key[parentPath.Length] == ':')
  33. {
  34. results.Add(Segment(kv.Key, parentPath.Length + 1));
  35. }
  36. }
  37. }
  38. results.AddRange(earlierKeys);
  39. results.Sort(ConfigurationKeyComparer.Comparison);
  40. return results;
  41. }
  42. private static string Segment(string key, int prefixLength)
  43. {
  44. int indexOf = key.IndexOf(ConfigurationPath.KeyDelimiter, prefixLength, StringComparison.OrdinalIgnoreCase);
  45. return indexOf < 0 ? key.Substring(prefixLength) : key.Substring(prefixLength, indexOf - prefixLength);
  46. }
  47. public IChangeToken GetReloadToken()=>return _reloadToken;}
  48. /// Triggers the reload change token and creates a new one.
  49. protected void OnReload()
  50. {
  51. ConfigurationReloadToken previousToken = Interlocked.Exchange(ref _reloadToken, new ConfigurationReloadToken());
  52. previousToken.OnReload();
  53. }
  54. }

MemoryConfigurationSource: 非常简单

InitialData字段就是你在创建MemoryConfigurationSource提供的字典对象,build方法则创建一个MemoryConfigurationProvider并把自身this作为参数传入,其目的很简单。在Proivder 对象中可以访问到Source对象,其构造函数内根据Source的InitialData初始化Data属性.

  1. public class MemoryConfigurationSource : IConfigurationSource
  2. {
  3. /// The initial key value configuration pairs. 数据源
  4. public IEnumerable<KeyValuePair<string, string?>>? InitialData { get; set; }
  5. /// Builds the <see cref="MemoryConfigurationProvider"/> for this source.
  6. public IConfigurationProvider Build(IConfigurationBuilder builder)
  7. {
  8. return new MemoryConfigurationProvider(this);
  9. }
  10. }

MemoryConfigurationProvider

因为这是最简单的Provider 赋值把MemoryConfigurationSource的data 整理好给父类Data属性就好。然后用父类Data属性对外提供数据。所以MemoryConfigurationProvider并没有重写父类的Load方法

  1. /// <summary>
  2. /// In-memory implementation of <see cref="IConfigurationProvider"/>
  3. /// </summary>
  4. public class MemoryConfigurationProvider : ConfigurationProvider, IEnumerable<KeyValuePair<string, string?>>
  5. {
  6. private readonly MemoryConfigurationSource _source;
  7. public MemoryConfigurationProvider(MemoryConfigurationSource source!!)
  8. {
  9. _source = source;
  10. foreach (KeyValuePair<string, string?> pair in _source.InitialData)
  11. {
  12. Data.Add(pair.Key, pair.Value);
  13. }
  14. }
  15. public void Add(string key, string? value) { Data.Add(key, value); }
  16. public IEnumerator<KeyValuePair<string, string?>> GetEnumerator() { return Data.GetEnumerator(); }
  17. IEnumerator IEnumerable.GetEnumerator() { return GetEnumerator(); }
  18. }

其它

FileConfiguration

FileConfiguration以Json File Configuration ,整个实际跟上面介绍的一样作为数据源同样由 1.Source 2. Provider组成 source作为Porvider的build类用于创建Porivder,创建出来的Provider提供具体的数据源

两条线 1.Provider 2.Source

Provider的继承与实现关系:JsonConfigurationProvider->FileConfigurationProvider-> ConfigurationProvider->IConfigurationProvider

Source 的继承与实现关系:JsonConfigurationSource -> FileConfigurationSource ->IConfigurationSource

其它数据源

EnvironmentVariablesConfigurationSource

CommandLineConfigurationSource

总结

在使用层面上

IConfiguration接口对外提供配置数据,实现了此接口的有 IConfigurationSection & IConfigurationRoot 也由此两个接口在代码上实现了一个具有树行结构逻辑数据源。

所有的数据源均以字典key形式存储的。所以你不给一个完整的路径是得不到数据的。

在构建数据源与数据提供方向:

IConfigurationProvider/IConfigurationSource/IConfigurationBuilder

IConfigurationProvider接口提供了set\get\load();等接口,前两给负责使用者提供数据源,而load方法用于初始化加载数据到自身的data属性,它调用的时机是创建ConfigurationRoot的构造函数内。

IConfigurationSource 仅仅有一个build方法 当调用IConfigurationBuilder的build方法创建IConfigurationRoot是,就是调用每个IConfigurationSource的Build创Porivder并把此集合作为参数去创建IConfigurationRoot

它的Get数据流向:

根节点:IConfigurationRoot-> IConfigurationProvider

非根节点:IConfigurationSection -> IConfigurationRoot-> IConfigurationProvider

其中IConfigurationRoot的IConfigurationProvider由IConfigurationBuilder整理自身的IConfigurationSource提供在构造IConfigurationRoot作为参数传入,值得注意的是IConfigurationRoot并不保存数据,而是从对应的povider中获取。

Net6 Configuration & Options 源码分析 Part1的更多相关文章

  1. Net6 Configuration & Options 源码分析 Part2 Options

    Net6 Configuration & Options 源码分析 Part2 Options 第二部分主要记录Options 模型 OptionsConfigurationServiceCo ...

  2. Net6Configuration & Options 源码分析 Part3 IOptionsMonitor 是如何接收到配置文件变更并同步数据源的

    配置源的同步 IOptionsMonitor 使用 //以下demo演示使用IOptionsMonitor重新加载配置并当重新加载配置是执行回调函数 var configuration = new C ...

  3. Net6 DI源码分析Part1 ServiceCollection、ServiceDescriptor、ServiceLifetime、IServiceProvider

    ServiceCollection.ServiceDescriptor.ServiceLifetime.IServiceProvider Microsoft.Extensions.Dependency ...

  4. ABP源码分析一:整体项目结构及目录

    ABP是一套非常优秀的web应用程序架构,适合用来搭建集中式架构的web应用程序. 整个Abp的Infrastructure是以Abp这个package为核心模块(core)+15个模块(module ...

  5. Android事件分发机制源码分析

    Android事件分发机制源码分析 Android事件分发机制源码分析 Part1事件来源以及传递顺序 Activity分发事件源码 PhoneWindow分发事件源码 小结 Part2ViewGro ...

  6. ABP源码分析四:Configuration

    核心模块的配置 Configuration是ABP中设计比较巧妙的地方.其通过AbpStartupConfiguration,Castle的依赖注入,Dictionary对象和扩展方法很巧妙的实现了配 ...

  7. 【MyBatis源码分析】Configuration加载(下篇)

    元素设置 继续MyBatis的Configuration加载源码分析: private void parseConfiguration(XNode root) { try { Properties s ...

  8. Hadoop源码分析之Configuration

    转自:http://www.it165.net/admin/html/201312/2178.html org.apache.hadoop.conf.Configuration类是Hadoop所有功能 ...

  9. Springboot中注解@Configuration源码分析

    Springboot中注解@Configuration和@Component的区别 1.先说结论,@Configuration注解上面有@Component注解,所以@Component有的功能@Co ...

随机推荐

  1. Ajax不允许缓存方法

    AJAX请求后台时会自动缓存,客户端发起请求首先请求缓存,第一次请求即由缓存再请求服务器,返回数据时同样先返回到缓存再展示再客户端.但是如果数据要求随时性呢,数据变化频率高呢?那么如何不让ajax设置 ...

  2. LBS应用之 根据一点的经纬度实现附近点的查询

    这年头和LBS相关的应用越来越火.从foursquare的热闹程度就可见一般(什么,没听过 foursquare-. 哥们,你 out 了).和 LBS有关的应用一般都包括一些共同的操作,最常见的一个 ...

  3. iOS应用启动main函数

    #import <UIKit/UIKit.h> #import "AppDelegate.h" int main(int argc, char * argv[]) { ...

  4. 优化UITableViewCell高度计算的那些事 by --胡 xu

    这篇总结你可以读到: UITableView高度计算和估算的机制 不同iOS系统在高度计算上的差异 iOS8 self-sizing cell UITableView+FDTemplateLayout ...

  5. 基于SSM风格的Java源代码生成器

    一.序言 UCode Cms 是一款Maven版的Java源代码生成器,是快速构建项目的利器.代码生成器模块属于可拆卸模块,即按需引入.代码生成器生成SSM(Spring.SpringBoot.Myb ...

  6. 微服务从代码到k8s部署应有尽有系列(二、网关)

    我们用一个系列来讲解从需求到上线.从代码到k8s部署.从日志到监控等各个方面的微服务完整实践. 整个项目使用了go-zero开发的微服务,基本包含了go-zero以及相关go-zero作者开发的一些中 ...

  7. 《STL源码剖析》学习半生记:第一章小结与反思

    不学STL,无以立.--陈轶阳 从1.1节到1.8节大部分都是从各方面介绍STL, 包括历史之类的(大致上是这样,因为实在看不下去我就直接略到了1.9节(其实还有一点1.8.3的内容)). 第一章里比 ...

  8. Solution -「HDU 6875」Yajilin

    \(\mathcal{Description}\)   Link.(HDU 裂开了先放个私链 awa.)   在一个 \(n\times n\) 的方格图中,格子 \((i,j)\) 有权值 \(w_ ...

  9. vivo 服务端监控架构设计与实践

    一.业务背景 当今时代处在信息大爆发的时代,信息借助互联网的潮流在全球自由的流动,产生了各式各样的平台系统和软件系统,越来越多的业务也会导致系统的复杂性. 当核心业务出现了问题影响用户体验,开发人员没 ...

  10. Spring Boot数据访问之动态数据源切换之使用注解式AOP优化

    在Spring Boot数据访问之多数据源配置及数据源动态切换 - 池塘里洗澡的鸭子 - 博客园 (cnblogs.com)中详述了如何配置多数据源及多数据源之间的动态切换.但是需要读数据库的地方,就 ...