亚洲一区在线视频,婷婷午夜天,国产高清视频在线观看

上一篇 ASP.NET Core - 選項系統之選項配置中提到 IOptions、IOptionsMonitor 和 IOptionsSnapshot 三個接口，通過這三個接口都可以從依賴注入容器中解析出已經配置的選項類，在我們通過 Configure 方法配置選項時，這三個接口會被同時注冊，但三個接口是有區別的，適用場景也有所不同。

1. IOptions

IOptions 對象的生命周期是 Singleton (單例)，它可以在任意地方進行注入使用
該接口對象在第一次使用的時候被實例化，并且選項類中的內容會一直保持不變，前面也提過選項類內容可以在配置來源修改之后更新，但是通過 IOption 解析的選項類不會隨著更新而改變
IOptions 接口不支持命名選項模式，它是沒有 get 方法的，也并不會默認讀取第一個，它只能讀取 String.Empty 默認命名的選項，如果沒有配置默認選項的話，雖然也能解析出 Options 選項類對象，但是對象的屬性都是相應類型的默認值(引用類型是 null，值類型是 0，其他的也都是相應類型的默認值)

public class OptionController : ControllerBase
{
	private readonly BlogOptions _blogOptions;
	public OptionController(IOptions<BlogOptions> options)
	{
		// 通過 IOptions<TOptions> 接口的 Value 屬性讀取選項類
		// 選項類始終是程序啟動時加載的值，不會改變
		_blogOptions = options.Value;
	}
}

2. IOptionsMonitor

IOptionsMonitor 對象的生命周期是 Scoped(作用域)，Scoped 生命周期的特點是不能注入到 Singleton 服務中
在作用域中(最常見的一次Http請求)，創建 IOptionsSnapshot 對象實例時，會從配置中讀取最新選項值作為快照，并在當前作用域中始終使用該快照。也就是說一次請求中選項類內容保持不變，但是不同請求中可能因為配置來源的修改而不同
IOptionsMonitor 支持命名選項

public class OptionController : ControllerBase
{
	private readonly BlogOptions _blogOptions;
	public OptionController(IOptionsSnapshot<BlogOptions> optionsSnapshot)
	{
		// IOptionsSnapshot<TOptions> 可以通過 Value 屬性讀取默認的命名的選項類， Options 對象實例創建時讀取的配置快照
		_blogOptions = optionsSnapshot.Value;
		// 也可以通過 Get 方法獲取某一個命名選項，沒有指定命名時，默認命名為 string.Empty
		//_blogOptions = optionsSnapshot.Get(string.Empty);
	}
}

3. IOptionsSnapshot

IOptionsSnapshot 對象的生命周期也是 Singleton (單例)
通過 IOptionsSnapshot 接口注入的對象每次讀取選項值時，都是從配置中讀取最新選項值，能夠實時獲取配置來源的更改
該接口支持命名選項模式
除了可以查看 TOptions 的值，還可以監控 TOptions 配置的更改，支持重新加載配置（CurrentValue），并當配置發生更改時，進行通知（OnChange），支持緩存與緩存失效 (IOptionsMonitorCache)，每次調用實例的 CurrentValue 時，會先檢查緩存（IOptionsMonitorCache）是否有值，如果有值，則直接用，如果沒有，則從配置中讀取最新選項值，并記入緩存。當配置發生更改時，會將緩存清空。

public class OptionController : ControllerBase
{
	private readonly BlogOptions _blogOptions;
	public OptionController(IOptionsMonitor<BlogOptions> optionsMonitor)
	{
		// IOptionsMonitor<TOptions> 接口沒有 Value 屬性，通過 CurrentValue 獲取選項類對象，
		// 每次調用 CurrentValue都會實時讀取配置源，始終是最新配置的值
		_blogOptions = optionsMonitor.CurrentValue;
		// 該接口也支持通過 Get 方法獲取命名選項
		_blogOptions = optionsMonitor.Get(string.Empty);
		// 可以通過 OnChange 注冊事件，當配置被加載時會觸發事件
		optionsMonitor.OnChange(OnOptionsChange);
	}

	[HttpGet]
	public Task<BlogOptions> Get()
	{
		return Task.FromResult(_blogOptions);
	}

	private void OnOptionsChange(BlogOptions options)
	{
		Console.WriteLine(JsonSerializer.Serialize(options));
	}
}

啟動應用，調用一次 Get 接口，在 Api 控制器構造函數中注冊了配置加載觸發事件，之后修改 appsettings.json 配置文件中選項類對于的配置節點內容，可以看到事件觸發，控制臺中輸出了改變之后的選項類內容。

ASP.NET Core - 選項系統之選項使用

4. 三個接口的選項讀取機制演示

三個接口解析的選項類的差別，可以通過以下測試清楚得看出：

配置文件中初始選項節點如下：

"Blog": {
    "Title": "ASP.NET Core Options11",
    "Content": "This is a blog about Options System in ASP.NET Core Framework.",
    "CreateTime": "2022-12-06"
}

這里為了方便看出 Scoped 生命周期 IOptionSnapeshoot 接口的變化，所有通過 Web Api 接口來測試

public class OptionController : ControllerBase
{
	private readonly IOptions<BlogOptions> _blogOptions;
	private readonly IOptionsSnapshot<BlogOptions> _blogSnapshotOptions;
	private readonly IOptionsMonitor<BlogOptions> _blogMonitorOptions;
	public OptionController(
		 IOptions<BlogOptions> options,
		IOptionsSnapshot<BlogOptions> optionsSnapshot,
		IOptionsMonitor<BlogOptions> optionsMonitor
		)
	{
// 注意這里不能再把選項類對象先讀取出來，否則選項類對象也不會再改變了
		_blogOptions = options;
		_blogSnapshotOptions = optionsSnapshot;
		_blogMonitorOptions = optionsMonitor;
	}

	[HttpGet]
	public Task Get()
	{
		Console.WriteLine("第一次讀取配置：");
		Console.WriteLine("IOptions<TOptions>：" + JsonSerializer.Serialize(_blogOptions.Value));
		Console.WriteLine("IOptionsSnapshot<TOptions>：" + JsonSerializer.Serialize(_blogSnapshotOptions.Value));
		Console.WriteLine("IOptionsMonitor<TOptions>：" + JsonSerializer.Serialize(_blogMonitorOptions.CurrentValue));

		Console.WriteLine("請修改配置文件！");
		Console.ReadKey();

		Console.WriteLine("第二次讀取配置：");
		Console.WriteLine("IOptions<TOptions>：" + JsonSerializer.Serialize(_blogOptions.Value));
		Console.WriteLine("IOptionsSnapshot<TOptions>：" + JsonSerializer.Serialize(_blogSnapshotOptions.Value));
		Console.WriteLine("IOptionsMonitor<TOptions>：" + JsonSerializer.Serialize(_blogMonitorOptions.CurrentValue));

		return Task.CompletedTask;
	}
}

之后啟動應用調用 Get 接口，并在過程中將配置文件內容修改為以下：

"Blog": {
    "Title": "ASP.NET Core Options222",
    "Content": "This is a blog about Options System in ASP.NET Core Framework.",
    "CreateTime": "2022-12-06"
}

可以看到控制臺的輸出中，第二次讀取配置的時候，IOptionsMonitor 接口讀取到的內容已經改變

ASP.NET Core - 選項系統之選項使用

之后不要關閉應用，再調一次 Get 接口，并在過程中再次修改配置如下：

"Blog": {
    "Title": "ASP.NET Core Options333",
    "Content": "This is a blog about Options System in ASP.NET Core Framework.",
    "CreateTime": "2022-12-06"
}

這一次的 Get 請求的輸出結果如下：
ASP.NET Core - 選項系統之選項使用

可以看到 IOptionsMonitor 接口每次都能獲取到配置文件的實時值，IOptionsSnapshot 接口相較于第一次調用 Get 接口的時候已經改變，獲取到了之前修改的值，但是之后的修改它又獲取不到了，因為它是 Scoped 生命周期，在一次請求內是保持一致的，而 IOptions 接口獲取到的選項類對象是一致不變的。

參考文章：
ASP.NET Core 中的選項模式 | Microsoft Learn
選項模式 - .NET | Microsoft Learn
面向 .NET 庫創建者的選項模式指南 - .NET | Microsoft Learn
理解ASP.NET Core - 選項(Options)

ASP.NET Core 系列：

目錄：ASP.NET Core 系列總結
上一篇：ASP.NET Core - 選項系統之選項配置