ASP.NET Core 源码学习之 Options[2]:IOptions

在上一篇中，介绍了一下Options的注册，而使用时只需要注入 IOption 即可：

public ValuesController(IOptions<MyOptions> options){    var opt = options.Value;
}

IOptions

IOptions 定义非常简单，只有一个Value属性：

public interface IOptions<out TOptions> where TOptions : class, new()
{TOptions Value { get; }
}

OptionsManager

而当我们注入IOptions<MyOptions>时，其默认实现则是OptionsManager<MyOptions>，而且使用的单例模式，在AddOptions扩展方法中可以看到：

public static IServiceCollection AddOptions(this IServiceCollection services){services.TryAdd(ServiceDescriptor.Singleton(typeof(IOptions<>), typeof(OptionsManager<>)));    
return services;
}

而我们在使用的时候，并没有调用AddOptions扩展方法，那是因为在WebHostBuilder的BuildCommonServices方法中进行了调用，具体在Hosting系列中会详细来说。

再看一下OptionsManager的源码：

public class OptionsManager<TOptions> : IOptions<TOptions> where TOptions : class, new()
{  
  private LegacyOptionsCache<TOptions> _optionsCache;    
  
  public OptionsManager(IEnumerable<IConfigureOptions<TOptions>> setups)    {_optionsCache = new LegacyOptionsCache<TOptions>(setups);}  
  
    public virtual TOptions Value{      
        get{        
          return _optionsCache.Value;}}
}

OptionsManager的构造函数中注入了IConfigureOptions<T>，而这里使用了 IEnumerable 类型，则表示当注册多个时，则为按顺序依次执行。而其IConfigureOptions则在上一篇已经讲过，是通过Configure扩展方法进行注册的。而TOptions的创建工作则是在LegacyOptionsCache类中：

LegacyOptionsCache

先看代码，胜过千言万语：

internal class LegacyOptionsCache<TOptions> where TOptions : class, new()
{    
   private readonly Func<TOptions> _createCache;   
   private object _cacheLock = new object();   
   private bool _cacheInitialized;    
   private TOptions _options;   
   
   private IEnumerable<IConfigureOptions<TOptions>> _setups;  
     public LegacyOptionsCache(IEnumerable<IConfigureOptions<TOptions>> setups)    {_setups = setups;_createCache = CreateOptions;}    

private TOptions CreateOptions()    {      
  var result = new TOptions();        if (_setups != null){            foreach (var setup in _setups){setup.Configure(result);}}        return result;}  
  
    public virtual TOptions Value{    
        get{          
          return LazyInitializer.EnsureInitialized(  
                        ref _options,      
                         ref _cacheInitialized,  
                          ref _cacheLock,_createCache);}}
}