以前提起配置,大家都会想到web.config和app.config,而且好像只有这一种方式。但是在ASP.NET CORE中,不仅提供了多元化的配置方式,而且提供了监视功能。
我们这里只介绍几种最常用的配置方式,最常见的配置方式应该还是配置文件吧,毕竟使用这种方式修改配置比较方便,不需要重新编译代码。
1、将配置定义在appsettings.json文件中
配置如下:
"format": {
"dateTime": {
"longDataPattern": "dddd,MMMM,d,yyyy",
"longTimePattern": "h:mm:ss tt",
"shortDataPattern": "M/d/yyyy",
"shortTimePattern": "h:mm tt"
},
"currencyDecimal": {
"digits": "5",
"symbol": "$"
}
}
然后定义一个与当前结构一致的类:
public class FormatOptions
{
public DateTimeFormatOptions DateTime { get; set; }
public CurrencyDecimalFormatOptions CurrencyDecimal { get; set; }
}
public class DateTimeFormatOptions
{
public string LongDataPattern { get; set; }
public string LongTimePattern { get; set; }
public string ShortDataPattern { get; set; }
public string ShortTimePattern { get; set; }
}
public class CurrencyDecimalFormatOptions
{
public int Digits { get; set; }
public string Symbol { get; set; }
}
在startup的ConfigureServices方法中添加依赖注入:
services.AddOptions().Configure(Configuration.GetSection("format"));
这里的Configuration就是startup类的全局变量
public IConfiguration Configuration { get; }
这个Configuration默认包含了appsettings.json配置文件的内容,所以我们不需要自己新建一个ConfigurationBuilder对象,如果我们的配置不是定义在appsettings.json里面,而是自定义了一个JSON文件,
那我们就需要新建一个ConfigurationBuilder对象,这个我们下面会讲到
这里为什么要调用GetSection方法呢?因为我们的appsettings.json中还有其他的配置项(项目创建时框架默认创建的配置项),我们只取我们想要的部分,如果这里不调用GetSection的话,也无法获取到
配置项的值,因为我们定义的类里面没有框架默认的那些配置项的字段。
下面我们新建一个控制器,把IOptions作为构造函数的参数,代码如下:
public class TestController : Controller
{
private readonly IOptions<FormatOptions> _options;
public TestController(IOptions<FormatOptions> options)
{
_options = options;
}
public string Index()
{
var value = _options.Value;
var dateTime = value.DateTime;
var currencyDecimal = value.CurrencyDecimal;
StringBuilder sb = new StringBuilder();
sb.Append($"DateTime:");
sb.Append($"\r\nlongDataPattern:{dateTime.LongDataPattern}");
sb.Append($"\r\nlongTimePattern:{dateTime.LongTimePattern}");
sb.Append($"\r\nshortDataPattern:{dateTime.ShortDataPattern}");
sb.Append($"\r\nshortTimePattern:{dateTime.ShortTimePattern}");
sb.Append($"\r\nCurrencyDecimal:");
sb.Append($"\r\ndigits:{currencyDecimal.Digits}");
sb.Append($"\r\nsymbol:{currencyDecimal.Symbol}");
return sb.ToString();
}
}
2、自定义配置文件
某些情况下,我们可能需要将配置文件定义在我们自定义的JSON文件中。我们自己新建一个profile.json文件,配置如下:
{
"gender": "Male",
"age": "33",
"contactinfo": {
"emailAddress": "foobar.outlook.com",
"phoneno": "123456789"
}
}
在startup类的ConfigureServices方法中添加依赖注入:
var configuration = new ConfigurationBuilder().AddJsonFile(path:"profile.json",optional:false,reloadOnChange:true).Build();
services.AddOptions().Configure<Profile>(configuration);
path:表示配置文件的路径;optional表示这个配置文件是不是可选的,如果是的话,在程序启动的时候框架就不会去检查该文件是不是存在,而且就算没有这个文件,程序也不会报错,框架也会给这个配置对应的类的所有字段赋一个默认值。如是不是可选的话,框架会检查这个文件是不是存在,不存在的话会报错;reloadOnChange:如果配置文件有改动的话,框架会重新加载配置文件;
这个profile类的定义就按照配置文件给出的字段定义就好了,这些我就不把这个类的定义贴出来了。使用的方式也和上面介绍的FormatOptions一样。如果这个配置文件里面还有其他的配置项,
记得调用GetSection方法获取我们想要的部分。
3、根据运行环境动态加载配置文件
在ASP.NET CORE中有3中运行环境:Development、Stage、Production。不同环境下配置文件的内容可能会不同。
我们拿发布环境做一下测试。如果当前项目还没有appsettings.Production.json文件,那就新建一个。
配置如下:
{
"ConnectionStrings": {
"DefaultConnection": "Server=(localdb)\\MSSQLLocalDB;Database=_CHANGE_ME;Trusted_Connection=True;MultipleActiveResultSets=true"
},
"format": {
"currencyDecimal": {
"digits": "6"
}
}
}
var environmentName = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT");
var formatConfig = new ConfigurationBuilder().AddJsonFile(path: "appsettings.json", optional: false, reloadOnChange: true)
.AddJsonFile(path: $"appsettings.{environmentName}.json", optional: false, reloadOnChange: true).Build() ;
services.AddOptions().Configure<FormatOptions>(formatConfig.GetSection("format"));
大家可以看到在appsettings.Production.json配置文件中,我并没有定义FormatOptions的所有字段,只配置了CurrencyDecimalFormatOptions类里面的Digits字段。
在创建ConfigurationBuilder类的时候,我添加了2个appsettings.json,在appsettings.json中,我定义了FormatOptions的所有字段。
在appsettings.json里面我把Digits设置为4,而在appsettings.Production.json里面我把Digits设置为6。然后在lanuchSettings.json中把ASPNETCORE_ENVIRONMENT
设置为Production,还是在TestController中运行,我们发现Digits字段的值等于6。
这种方式我觉得还是挺好的,把所有配置项都写在appsettings.json文件中,然后在与运行环境相对应的配置文件中只写运行环境对应的配置项,不需要再把所有的
配置项都重写一遍。框架会把这两个文件的配置项做一个合并。
4、监视配置文件的变化
我们都希望在程序运行的过程中修改配置文件不需要重启应用程序,修改的配置也能生效,ASP.NET CORE做到了这一点。
代码其实和上面的差不多,我们要监视配置文件的变化,只需要把reloadOnChange属性设置为true即可。
然后我们在消费Options对象的时候,要使用IOptionsMonitor,而不是之前的IOptions,代码如下:
public TestController(IOptions<FormatOptions> options,IOptionsMonitor<FormatOptions> optionsMonitor)
{
_options = options;
_monitorOptions = optionsMonitor;
}
我新加了一个函数:
public string MonitorIndex()
{
var value = _monitorOptions.CurrentValue;
var dateTime = value.DateTime;
var currencyDecimal = value.CurrencyDecimal;
StringBuilder sb = new StringBuilder();
sb.Append($"DateTime:");
sb.Append($"\r\nlongDataPattern:{dateTime.LongDataPattern}");
sb.Append($"\r\nlongTimePattern:{dateTime.LongTimePattern}");
sb.Append($"\r\nshortDataPattern:{dateTime.ShortDataPattern}");
sb.Append($"\r\nshortTimePattern:{dateTime.ShortTimePattern}");
sb.Append($"\r\nCurrencyDecimal:");
sb.Append($"\r\ndigits:{currencyDecimal.Digits}");
sb.Append($"\r\nsymbol:{currencyDecimal.Symbol}");
return sb.ToString();
}
唯一的变化就是获取值的时候使用的CurrentValue属性。
在浏览器中输入/test/MonitorIndex进入到该方法,然后到程序运行的根目录下(bin\Debug\netcoreapp3.1)修改任意一个配置项的值,保存。
然后刷新一下,界面就会显示新值。如果我们还是进入到/test/index,发现修改过的配置项的值是不会变的。
下面是配置项对应POCO对象:
public class Profile
{
public Gender Gender { get; set; }
public int Age { get; set; }
public ContactInfo ContactInfo { get; set; }
}
public class ContactInfo
{
public string EmailAddress { get; set; }
public string PhoneNo { get; set; }
}
1、IOptionsSnapshot
在上一篇文章中我们介绍了IOptions和IOptionsMonitor,这里我们讲一下IOptionsSnapshot。我们看一下下面这个配置文件:
{
"foo": {
"gender": "Male",
"age": "18",
"contactinfo": {
"emailAddress": "foobar.outlook.com",
"phoneno": "123"
}
},
"bar": {
"gender": "Female",
"age": "20",
"contactinfo": {
"emailAddress": "foobar.outlook.com",
"phoneno": "456"
}
}
}
这里有2个配置,配置项的字段是一样的,但是每个配置都有自己的名称:foo和bar。这就像是一个班级里面有很多学生,每个学生都拥有自己的属性(姓名、年龄等)。
这种配置的使用方式和上篇文章介绍了那两种其实区别不大,下面看一下代码:
这是在startup的ConfigureServices函数中的代码:
var configuration1 = new ConfigurationBuilder().AddJsonFile(path: "profile1.json", optional: false, reloadOnChange: true).Build();
services.AddOptions().Configure<Profile>("foo", configuration1.GetSection("foo"));
services.AddOptions().Configure<Profile>("bar", configuration1.GetSection("bar"));
这是获取配置的代码:
var fooProfile = _snapOptions.Get("foo");
var barProfile = _snapOptions.Get("bar");
_snapOptions是定义的全局变量:IOptionsSnapshot _snapOptions,通过依赖注入给它赋值。
这种方式其实是给配置取了一个名字,然后通过名字去获取配置。
2、MemoryConfigurationSource
前面我们都是用配置文件,因为这是最常见一种配置方式,下面我们看一下使用内存来配置。
var memorySource = new Dictionary<string, string>
{
["gender"] = "Male",
["age"] = "20",
["ContactInfo:emailaddress"] = "foo@outlook.com",
["ContactInfo:phoneno"] = "123"
};
var memeoryConfig = new ConfigurationBuilder().AddInMemoryCollection(memorySource).Build();
services.AddOptions().Configure<Profile>(memeoryConfig);
gender和age是Profile类的属性,所以直接赋值即可。但是后面两个是ContactInfo类的属性,所以需要把ContactInfo放到前面,然后用冒号引用这个类的属性。这里注意一定是冒号,而不是逗号。
获取配置的方式和前面一样,这里就不再赘述了。