ASP.NET Core中修改配置文件后自动加载新配置的方法详解

ASP.NET Core中修改配置文件后自动加载新配置的方法详解
 更新时间：2020年08月16日 11:45:21   作者：张志敏  

这篇文章主要给大家介绍了关于ASP.NET Core中修改配置文件后自动加载新配置的相关资料，文中通过示例代码介绍的非常详细，对大家学习或者使用ASP.NET Core具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧

前言
在 ASP.NET Core 默认的应用程序模板中， 配置文件的处理如下面的代码所示：

config.AddJsonFile(
path: “appsettings.json”,
optional: true,
reloadOnChange: true
);
config.AddJsonFile(
path: $”appsettings.{env.EnvironmentName}.json”,
optional: true,
reloadOnChange: true
);

appsettings.json 和 appsettings.{env.EnvironmentName}.json 两个配置文件都是可选的， 并且支持当文件被修改时能够重新加载。
可以在 ASP.NET Core 应用中利用这个特性， 实现修改配置文件之后， 不需要重启应用， 自动加载修改过的配置文件， 从而减少系统停机的时间。 实现的步骤如下：
使用配置 API 进行注入
假设要在程序中注入这样一个配置类型：

public class WeatherOption {
public string City { get; set; }
public int RefreshInterval { get; set; }
}

在 appsettings.json 中添加的配置如下：

{
“weather”: {
“city”: “GuangZhou”,
“refreshInterval”: 120
}
}

在 Startup.cs 的 ConfigureServices 方法中使用配置 API 进行注入， 代码如下：

public void ConfigureServices(IServiceCollection services) {
services.Configure<WeatherOption>(Configuration.GetSection(“weather”));
services.AddControllers();
}

这个步骤很关键， 通过这个配置 API 可以把注入内容和配置所在的节点关联起来。 如果有兴趣了解底层实现的话， 可以继续查看这个 OptionsConfigurationServiceCollectionExtensions.cs 。

通过这种方式注册的内容， 都是支持当配置文件被修改时， 自动重新加载的。
在控制器 (Controller) 中加载修改过后的配置
控制器 (Controller) 在 ASP.NET Core 应用的依赖注入容器中注册的生命周期是 Scoped ， 即每次请求都会创建新的控制器实例。 这样只需要在控制器的构造函数中注入 IOptionsSnapshot<TOption> 参数即可， 代码如下：

[ApiController]
[Route(“[controller]”)]
public class WeatherForecastController : ControllerBase {

private WeatherOption option;

public WeatherForecastController(
IOptionsSnapshot<WeatherOption> options
) {
this.option = options.Value;
}

// GET /weatherforcase/options
[HttpGet(“options”)]
public ActionResult<WeatherOption> GetOption() {
return options;
}
}

当然， 如果不希望在控制器中使用这个 IOptionsSnapshot 接口类型（会带来一些对现有代码重构和修改， 还是有一定的风险的）， 可以在 ConfigureServices 中添加对 WeatherOption 的注入， 代码如下：

public void ConfigureServices(IServiceCollection services) {
services.Configure<WeatherOption>(Configuration.GetSection(“weather”));
// 添加对 WeatherOption 的注入， 生命周期为 Scoped ， 这样每次请求都可以获取新的配置值。
services.AddScoped(serviceProvider => {
var snapshot = serviceProvider.GetService<IOptionsSnapshot<WeatherOption>>();
return snapshot.Value;
});
services.AddControllers();
}

这样在控制器中就不需要注入 IOptionsSnapshot<T> 类型了， 最终控制器的代码如下：

[ApiController]
[Route(“[controller]”)]
public class WeatherForecastController : ControllerBase {

private WeatherOption option;

public WeatherForecastController(
WeatherOption option
) {
this.option = option;
}

// GET /weatherforcase/options
[HttpGet(“options”)]
public ActionResult<WeatherOption> GetOption() {
return options;
}
}

这样控制器就无需修改任何代码即可加载修改过后的新配置。
在中间件 (Middleware) 中加载修改过后的配置
中间件 (Middleware) 在 ASP.NET Core 应用的依赖注入容器中注册的生命周期是 Singleton ， 即单例的， 只有在当应用启动时， 根据中间件创建处理连时创建一次全局实例， 所以只能通过注入 IOptionsMonitor<T> 来监听配置文件的修改情况， 示例代码如下：

public class TestMiddleware {

private RequestDelegate next;
private WeatherOption option;

public TestMiddleware(
RequestDelegate next,
IOptionsMonitor<WeatherOption> monitor
) {
this.next = next;
option = monitor.CurrentValue;
// moni config change
monitor.OnChange(newValue => {
option = newValue;
});
}

public async Task Invoke(HttpContext context) {
await context.Response.WriteAsync(JsonSerializer.Serialize(option));
}

}

当然， 在中间件的 Task Invoke(HttpContext context) 方法中， 直接获取 IOptionsSnapshot<T> 也是可以的， 代码如下：

public async Task Invoke(HttpContext context) {
var snapshot = context.RequestServices.GetService<IOptionsSnapshot<WeatherOption>>();
await context.Response.WriteAsync(JsonSerializer.Serialize(snapshot.Value));
}

但是这么做的话， 似乎就偏离了依赖注入的原则了， 因此不推荐这种做法。
总结
到此这篇关于ASP.NET Core中修改配置文件后自动加载新配置的文章就介绍到这了,更多相关ASP.NET Core自动加载新配置内容请搜索华域联盟以前的文章或继续浏览下面的相关文章希望大家以后多多支持华域联盟！

您可能感兴趣的文章:ASP.NET core Web中使用appsettings.json配置文件的方法.NET Core简单读取json配置文件.NET Core读取配置文件方式详细总结.NET Core 2.0迁移小技巧之web.config 配置文件示例详解实现core文件自动生成配置文件的方法.NET Core2.1如何获取自定义配置文件信息详解如何在ASP.NET Core类库项目中读取配置文件详解Asp.net Core与类库读取配置文件信息的方法.Net Core读取Json配置文件的实现示例asp.net core配置文件加载过程的深入了解

asp.net
core
配置文件

相关文章
详解ASP.NET页面生命周期事件这篇文章介绍了ASP.NET页面生命周期事件，有需要的朋友可以参考一下 2013-07-07
.Net 单例模式(Singleton)单例模式的意思就是只有一个实例。单例模式确保某一个类只有一个实例，而且自行实例化并向整个系统提供这个实例。这个类称为单例类 2013-07-07
C#中OpenFileDialog和PictrueBox的用法分析这篇文章主要介绍了C#中OpenFileDialog和PictrueBox的用法,以实例的形式较为详细的分析了OpenFileDialog和PictrueBox使用时的注意事项与具体用法,具有一定的参考借鉴价值,需要的朋友可以参考下 2014-11-11
GridView控件实现数据的修改（第9节）这篇文章主要介绍了GridView控件实现数据的修改,需要的朋友可以参考下 2015-08-08
.net 4.5部署到docker容器的完整步骤这篇文章主要给大家介绍了关于.net 4.5部署到docker容器的完整步骤，文中通过示例代码介绍的非常详细，对大家学习或者使用.net4.5具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧 2019-04-04
.NET c# 单体模式（Singleton）.NET c# 单体模式（Singleton）… 2007-12-12
ASP.NET笔记之 ListView 与 DropDownList的使用本篇文章小编为大家介绍，ASP.NET笔记之 ListView 与 DropDownList的使用。需要的朋友参考下 2013-04-04
asp.net页面SqlCacheDependency缓存实例这篇文章主要介绍了asp.net页面SqlCacheDependency缓存实例,以一个完整实例来展现asp.net中缓存技术的使用方法,需要的朋友可以参考下 2014-08-08
SqlCommandBuilder类批量更新excel或者CSV数据的方法这篇文章主要介绍了SqlCommandBuilder类批量更新excel或者CSV数据的方法，需要的朋友可以参考下 2015-10-10
轻松解决asp.net用户ASPNET登录失败问题的方法分享这篇文章介绍了asp.net用户ASPNET登录失败问题的方法，有需要的朋友可以参考一下 2013-11-11

最新评论