配置的實現在以Microsoft.Extensions.Configuration開頭的Nuget包中，引入對應的nuget包就可以使用配置功能
Github地址：https://github.com/dotnet/extensions/tree/master/src/Configuration
一、先看下下面接口的關系圖
二、各個接口的實現
1、IConfiguration和IConfigurationRoot的實現類：ConfigurationRoot
ConfigurationRoot的構造函數接收IList<IConfigurationProvider>類型，遍歷provider調用Load()方法加載數據
1 public ConfigurationRoot(IList<IConfigurationProvider> providers) 2 { 3 if (providers == null) 4 { 5 throw new ArgumentNullException(nameof(providers)); 6 } 7 8 _providers = providers; 9 _changeTokenRegistrations = new List<IDisposable>(providers.Count); 10 foreach (var p in providers) 11 { 12 p.Load(); 13 _changeTokenRegistrations.Add(ChangeToken.OnChange(() => p.GetReloadToken(), () => RaiseChanged())); 14 } 15 }
實現IConfiguration的索引器如下：
遍歷每個provider，從provider獲取對應鍵的值返回，在這里可以看出，鍵值對都是保存在各個provider中
public string this[string key] { get { for (var i = _providers.Count - 1; i >= 0; i--) { var provider = _providers[i]; if (provider.TryGet(key, out var value)) { return value; } } return null; } set { if (!_providers.Any()) { throw new InvalidOperationException(Resources.Error_NoSources); } foreach (var provider in _providers) { provider.Set(key, value); } } }
IConfiguration的GetChildren實現如下
public IEnumerable<IConfigurationSection> GetChildren() => this.GetChildrenImplementation(null);
internal static IEnumerable<IConfigurationSection> GetChildrenImplementation(this IConfigurationRoot root, string path) { return root.Providers .Aggregate(Enumerable.Empty<string>(), (seed, source) => source.GetChildKeys(seed, path)) .Distinct(StringComparer.OrdinalIgnoreCase) .Select(key => root.GetSection(path == null ? key : ConfigurationPath.Combine(path, key))); }
IConfiguration的GetReloadToken實現如下：
private ConfigurationReloadToken _changeToken = new ConfigurationReloadToken(); public IChangeToken GetReloadToken() => _changeToken;
IChangeToken 的實現類：
public class ConfigurationReloadToken : IChangeToken { private CancellationTokenSource _cts = new CancellationTokenSource(); /// <summary> /// Indicates if this token will proactively raise callbacks. Callbacks are still guaranteed to be invoked, eventually. /// </summary> /// <returns>True if the token will proactively raise callbacks.</returns> public bool ActiveChangeCallbacks => true; /// <summary> /// Gets a value that indicates if a change has occurred. /// </summary> /// <returns>True if a change has occurred.</returns> public bool HasChanged => _cts.IsCancellationRequested; /// <summary> /// Registers for a callback that will be invoked when the entry has changed. <see cref="Microsoft.Extensions.Primitives.IChangeToken.HasChanged"/> /// MUST be set before the callback is invoked. /// </summary> /// <param name="callback">The callback to invoke.</param> /// <param name="state">State to be passed into the callback.</param> /// <returns>The <see cref="CancellationToken"/> registration.</returns> public IDisposable RegisterChangeCallback(Action<object> callback, object state) => _cts.Token.Register(callback, state); /// <summary> /// Used to trigger the change token when a reload occurs. /// </summary> public void OnReload() => _cts.Cancel(); }
調用IConfiguration的GetReloadToken返回的IChangeToken，可以調用RegisterChangeCallback注冊一些回調方法，當配置發生改變時會觸發這些回調方法
IConfigurationRoot的Reload方法實現如下
public void Reload() { foreach (var provider in _providers) { provider.Load(); } RaiseChanged(); }
該方法會調用每個provider的Load方法重新加載配置信息，並調用IChangeToken的OnReload方法
2、IConfigurationSection的實現類ConfigurationSection
ConfigurationSection可以理解為針對指定配置節點下的配置信息，對IConfigurationRoot 進行相關的調用
public class ConfigurationSection : IConfigurationSection { private readonly IConfigurationRoot _root; private readonly string _path; private string _key; /// <summary> /// Initializes a new instance. /// </summary> /// <param name="root">The configuration root.</param> /// <param name="path">The path to this section.</param> public ConfigurationSection(IConfigurationRoot root, string path) { if (root == null) { throw new ArgumentNullException(nameof(root)); } if (path == null) { throw new ArgumentNullException(nameof(path)); } _root = root; _path = path; } /// <summary> /// Gets the full path to this section from the <see cref="IConfigurationRoot"/>. /// </summary> public string Path => _path; /// <summary> /// Gets the key this section occupies in its parent. /// </summary> public string Key { get { if (_key == null) { // Key is calculated lazily as last portion of Path _key = ConfigurationPath.GetSectionKey(_path); } return _key; } } /// <summary> /// Gets or sets the section value. /// </summary> public string Value { get { return _root[Path]; } set { _root[Path] = value; } } /// <summary> /// Gets or sets the value corresponding to a configuration key. /// </summary> /// <param name="key">The configuration key.</param> /// <returns>The configuration value.</returns> public string this[string key] { get { return _root[ConfigurationPath.Combine(Path, key)]; } set { _root[ConfigurationPath.Combine(Path, key)] = value; } } /// <summary> /// Gets a configuration sub-section with the specified key. /// </summary> /// <param name="key">The key of the configuration section.</param> /// <returns>The <see cref="IConfigurationSection"/>.</returns> /// <remarks> /// This method will never return <c>null</c>. If no matching sub-section is found with the specified key, /// an empty <see cref="IConfigurationSection"/> will be returned. /// </remarks> public IConfigurationSection GetSection(string key) => _root.GetSection(ConfigurationPath.Combine(Path, key)); /// <summary> /// Gets the immediate descendant configuration sub-sections. /// </summary> /// <returns>The configuration sub-sections.</returns> public IEnumerable<IConfigurationSection> GetChildren() => _root.GetChildrenImplementation(Path); /// <summary> /// Returns a <see cref="IChangeToken"/> that can be used to observe when this configuration is reloaded. /// </summary> /// <returns>The <see cref="IChangeToken"/>.</returns> public IChangeToken GetReloadToken() => _root.GetReloadToken(); }
3、 IConfigurationProvider的抽象類ConfigurationProvider
ConfigurationProvider內部定義了一個類型為Dictionary<string, string>(StringComparer.OrdinalIgnoreCase)的Data屬性用來保存配置信息，IConfigurationProvider接口的TryGet和Set方法針對Data進行獲取、設置配置
ConfigurationRoot類獲取配置信息類獲取或設置配置信息的的時候就是調用TryGet和Set方法
public abstract class ConfigurationProvider : IConfigurationProvider { private ConfigurationReloadToken _reloadToken = new ConfigurationReloadToken(); /// <summary> /// Initializes a new <see cref="IConfigurationProvider"/> /// </summary> protected ConfigurationProvider() { Data = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase); } /// <summary> /// The configuration key value pairs for this provider. /// </summary> protected IDictionary<string, string> Data { get; set; } /// <summary> /// Attempts to find a value with the given key, returns true if one is found, false otherwise. /// </summary> /// <param name="key">The key to lookup.</param> /// <param name="value">The value found at key if one is found.</param> /// <returns>True if key has a value, false otherwise.</returns> public virtual bool TryGet(string key, out string value) => Data.TryGetValue(key, out value); /// <summary> /// Sets a value for a given key. /// </summary> /// <param name="key">The configuration key to set.</param> /// <param name="value">The value to set.</param> public virtual void Set(string key, string value) => Data[key] = value; /// <summary> /// Loads (or reloads) the data for this provider. /// </summary> public virtual void Load() { } /// <summary> /// Returns the list of keys that this provider has. /// </summary> /// <param name="earlierKeys">The earlier keys that other providers contain.</param> /// <param name="parentPath">The path for the parent IConfiguration.</param> /// <returns>The list of keys for this provider.</returns> public virtual IEnumerable<string> GetChildKeys( IEnumerable<string> earlierKeys, string parentPath) { var prefix = parentPath == null ? string.Empty : parentPath + ConfigurationPath.KeyDelimiter; return Data .Where(kv => kv.Key.StartsWith(prefix, StringComparison.OrdinalIgnoreCase)) .Select(kv => Segment(kv.Key, prefix.Length)) .Concat(earlierKeys) .OrderBy(k => k, ConfigurationKeyComparer.Instance); } private static string Segment(string key, int prefixLength) { var indexOf = key.IndexOf(ConfigurationPath.KeyDelimiter, prefixLength, StringComparison.OrdinalIgnoreCase); return indexOf < 0 ? key.Substring(prefixLength) : key.Substring(prefixLength, indexOf - prefixLength); } /// <summary> /// Returns a <see cref="IChangeToken"/> that can be used to listen when this provider is reloaded. /// </summary> /// <returns>The <see cref="IChangeToken"/>.</returns> public IChangeToken GetReloadToken() { return _reloadToken; } /// <summary> /// Triggers the reload change token and creates a new one. /// </summary> protected void OnReload() { var previousToken = Interlocked.Exchange(ref _reloadToken, new ConfigurationReloadToken()); previousToken.OnReload(); } /// <summary> /// Generates a string representing this provider name and relevant details. /// </summary> /// <returns> The configuration name. </returns> public override string ToString() => $"{GetType().Name}"; }
實現了IConfigurationSource接口的類會Build一個IConfigurationProvider
4、IConfigurationBuilder接口實現類ConfigurationBuilder
public class ConfigurationBuilder : IConfigurationBuilder { /// <summary> /// Returns the sources used to obtain configuration values. /// </summary> public IList<IConfigurationSource> Sources { get; } = new List<IConfigurationSource>(); /// <summary> /// Gets a key/value collection that can be used to share data between the <see cref="IConfigurationBuilder"/> /// and the registered <see cref="IConfigurationProvider"/>s. /// </summary> public IDictionary<string, object> Properties { get; } = new Dictionary<string, object>(); /// <summary> /// Adds a new configuration source. /// </summary> /// <param name="source">The configuration source to add.</param> /// <returns>The same <see cref="IConfigurationBuilder"/>.</returns> public IConfigurationBuilder Add(IConfigurationSource source) { if (source == null) { throw new ArgumentNullException(nameof(source)); } Sources.Add(source); return this; } /// <summary> /// Builds an <see cref="IConfiguration"/> with keys and values from the set of providers registered in /// <see cref="Sources"/>. /// </summary> /// <returns>An <see cref="IConfigurationRoot"/> with keys and values from the registered providers.</returns> public IConfigurationRoot Build() { var providers = new List<IConfigurationProvider>(); foreach (var source in Sources) { var provider = source.Build(this); providers.Add(provider); } return new ConfigurationRoot(providers); } }
該類是創建配置的核心，其內部定義了類型為List<IConfigurationSource>的Source屬性
調用Build方法時，會遍歷Source中的每個IConfigurationProvider，從而構建ConfigurationRoot對象
當我們創建ConfigurationBuilder對象時，需要向Source添加對應的IConfigurationSource，IConfigurationBuilder的擴展方法其實就是添加對應的IConfigurationSource
5、 我們看下IConfigurationSource、IConfigurationProvider接口的幾個實現類
ChainedConfigurationSource和ChainedConfigurationProvider
ChainedConfigurationSource有個IConfiguration接口的Configuration屬性，當ChainedConfigurationProvider調用TryGet、Set時，其實調用了IConfiguration
ChainedConfigurationSource可以理解為IConfiguration接口的封裝
public static class ChainedBuilderExtensions { /// <summary> /// Adds an existing configuration to <paramref name="configurationBuilder"/>. /// </summary> /// <param name="configurationBuilder">The <see cref="IConfigurationBuilder"/> to add to.</param> /// <param name="config">The <see cref="IConfiguration"/> to add.</param> /// <returns>The <see cref="IConfigurationBuilder"/>.</returns> public static IConfigurationBuilder AddConfiguration(this IConfigurationBuilder configurationBuilder, IConfiguration config) => AddConfiguration(configurationBuilder, config, shouldDisposeConfiguration: false); /// <summary> /// Adds an existing configuration to <paramref name="configurationBuilder"/>. /// </summary> /// <param name="configurationBuilder">The <see cref="IConfigurationBuilder"/> to add to.</param> /// <param name="config">The <see cref="IConfiguration"/> to add.</param> /// <param name="shouldDisposeConfiguration">Whether the configuration should get disposed when the configuration provider is disposed.</param> /// <returns>The <see cref="IConfigurationBuilder"/>.</returns> public static IConfigurationBuilder AddConfiguration(this IConfigurationBuilder configurationBuilder, IConfiguration config, bool shouldDisposeConfiguration) { if (configurationBuilder == null) { throw new ArgumentNullException(nameof(configurationBuilder)); } if (config == null) { throw new ArgumentNullException(nameof(config)); } configurationBuilder.Add(new ChainedConfigurationSource { Configuration = config, ShouldDisposeConfiguration = shouldDisposeConfiguration, }); return configurationBuilder; } }
IConfigurationBuilder 的擴展方法AddConfiguration也就是添加ChainedConfigurationSource對象
MemoryConfigurationSource和MemoryConfigurationProvider
MemoryConfigurationSource有類型為IEnumerable<KeyValuePair<string, string>>的InitialData屬性
MemoryConfigurationProvider會把InitialData的鍵值對信息添加到基類ConfigurationProvider的Data屬性中
核心代碼：
public MemoryConfigurationProvider(MemoryConfigurationSource source) { if (source == null) { throw new ArgumentNullException(nameof(source)); } _source = source; if (_source.InitialData != null) { foreach (var pair in _source.InitialData) { Data.Add(pair.Key, pair.Value); } } }
擴展方法：
public static class MemoryConfigurationBuilderExtensions { /// <summary> /// Adds the memory configuration provider to <paramref name="configurationBuilder"/>. /// </summary> /// <param name="configurationBuilder">The <see cref="IConfigurationBuilder"/> to add to.</param> /// <returns>The <see cref="IConfigurationBuilder"/>.</returns> public static IConfigurationBuilder AddInMemoryCollection(this IConfigurationBuilder configurationBuilder) { if (configurationBuilder == null) { throw new ArgumentNullException(nameof(configurationBuilder)); } configurationBuilder.Add(new MemoryConfigurationSource()); return configurationBuilder; } /// <summary> /// Adds the memory configuration provider to <paramref name="configurationBuilder"/>. /// </summary> /// <param name="configurationBuilder">The <see cref="IConfigurationBuilder"/> to add to.</param> /// <param name="initialData">The data to add to memory configuration provider.</param> /// <returns>The <see cref="IConfigurationBuilder"/>.</returns> public static IConfigurationBuilder AddInMemoryCollection( this IConfigurationBuilder configurationBuilder, IEnumerable<KeyValuePair<string, string>> initialData) { if (configurationBuilder == null) { throw new ArgumentNullException(nameof(configurationBuilder)); } configurationBuilder.Add(new MemoryConfigurationSource { InitialData = initialData }); return configurationBuilder; } }
調用AddInMemoryCollection擴展方法時，我們可以傳IEnumerable<KeyValuePair<string, string>>類型的配置數據
StreamConfigurationSource和StreamConfigurationProvider
StreamConfigurationSource和StreamConfigurationProvider都是抽象類，定義簡單
public abstract class StreamConfigurationSource : IConfigurationSource { /// <summary> /// The stream containing the configuration data. /// </summary> public Stream Stream { get; set; } /// <summary> /// Builds the <see cref="StreamConfigurationProvider"/> for this source. /// </summary> /// <param name="builder">The <see cref="IConfigurationBuilder"/>.</param> /// <returns>An <see cref="IConfigurationProvider"/></returns> public abstract IConfigurationProvider Build(IConfigurationBuilder builder); }
public abstract class StreamConfigurationProvider : ConfigurationProvider { /// <summary> /// The source settings for this provider. /// </summary> public StreamConfigurationSource Source { get; } private bool _loaded; /// <summary> /// Constructor. /// </summary> /// <param name="source">The source.</param> public StreamConfigurationProvider(StreamConfigurationSource source) { Source = source ?? throw new ArgumentNullException(nameof(source)); } /// <summary> /// Load the configuration data from the stream. /// </summary> /// <param name="stream">The data stream.</param> public abstract void Load(Stream stream); /// <summary> /// Load the configuration data from the stream. Will throw after the first call. /// </summary> public override void Load() { if (_loaded) { throw new InvalidOperationException("StreamConfigurationProviders cannot be loaded more than once."); } Load(Source.Stream); _loaded = true; } }
可以看到Provider里面有個Load(Stream stream)方法，其實該方法是從流中獲取配置信息，比如讀取json文件流，具體的實現類后面再講
總結：本文主要分析了netcore配置系統，我們其實在項目里一般都是注入IConfiguration接口就能獲取對應的配置信息，這里涉及到了netcore的依賴注入
本質上是系統先創建ConfigurationBuilder對象，再調用對應的擴展方法向Sources添加配置數據源，最后Build出ConfigurationRoot對象，把ConfigurationRoot注入到容器中，所有的配置數據其實從ConfigurationRoot對象中獲取的
主要核心代碼：
public IConfigurationRoot Build() { var providers = new List<IConfigurationProvider>(); foreach (var source in Sources) { var provider = source.Build(this); providers.Add(provider); } return new ConfigurationRoot(providers); }