ASP.NET Core笔记(3) - 配置

• 配置规则
• 命令行配置提供程序
• 环境变量配置提供程序
• 文件配置提供程序
• 配置的读取
• 自定义配置数据源

ASP.NET Core中的配置项能够经过命令行、环境变量、json/xml/ini配置文件来提供。

Web应用在生成主机时会调用CreateDefaultBuilder方法，这个方法按照下面的顺序添加各类配置提供程序：

• 文件配置提供程序，用于加载appsetting.json
• 文件配置提供程序，用于加载appsetting.{Environment}.json
• 环境变量配置提供程序
• 命令行配置提供程序

对于同一配置，后面加载的配置提供程序会覆盖前面加载的内容，因此配置的默认优先级从低到高依次为：文件 -> 环境变量 -> 命令行。

配置规则

分层配置数据

配置 API 可以经过在配置键中使用分隔符来展平分层数据以保持分层配置数据。
好比，这样的json文件：

{
  "section0": {
    "key0": "value",
    "key1": "value"
  },
  "section1": {
    "key0": "value",
    "key1": "value"
  }
}

配置提供程序加载时，将使用冒号 (😃 展平节和键，以这样的方式建立惟一键以保持配置源的原始分层数据结构。

section0:key0
section0:key1
section1:key0
section1:key1

关于键和值的约定

配置键采用如下约定：

• 不区分大小写；
• 若是由相同或不一样的配置提供程序设置相同键的值，则键上设置的最后一个值就是所使用的值；
• 分层键默认使用冒号分隔符，但在环境变量中，冒号分隔符可能没法适用于全部平台，能够用双下划线代替。

配置值的约定：

• 值是字符串；
• NULL值不能存储在配置中或绑定到对象。

命令行配置提供程序

能够经过ConfigureHostConfiguration和ConfigureAppConfiguration方法来指定配置提供程序或者设置提供程序的优先级。
若是不须要CreateDefaultBuilder默认添加的配置提供提供程序，能够直接删除

.ConfigureAppConfiguration((hostingContext, config) =>
{
    config.Sources.Clear();
})

在ConfigurationBuilder 的实例上调用 AddCommandLine 扩展方法能够激活命令行配置，不过CreateDefaultBuilder已经自动调用了AddCommandLine，而且命令行配置的优先级最高。若要添加其余配置提供程序并保持可以用命令行参数替代这些提供程序的配置，能够在ConfigureAppConfiguration中添加完其余提供程序后，再调用一次AddCommandLine。

.ConfigureAppConfiguration((hostingContext, config) =>
{
    // Call other providers here
    config.AddCommandLine(args);
})

命令行配置的设置方式为：

dotnet run CommandLineKey=CommandLineValue

这种设置方法使用了等号（=），也能够用--或/做为前缀，并空格代替等号，下面的写法都是合理的：

dotnet run --CommandLineKey2=value2
dotnet run --CommandLineKey2 value2
dotnet run /CommandLineKey3=value3
dotnet run /CommandLineKey3 value3

环境变量配置提供程序

在ConfigurationBuilder 的实例上调用 AddEnvironmentVariables 扩展方法能够激活环境变量配置，CreateDefaultBuilder也已经默认启用了环境变量配置提供程序。

AddEnvironmentVariables方法还有一个重载支持加载指定前缀的环境变量。
好比

.AddEnvironmentVariables("CUSTOM_")

会只加载前缀为CUSTOM_的环境变量。

环境变量的设置方法：

• 命令行，set CUSTOM_ENV1=value1，但这种设置只在当前命令行窗口生效
• 设置全局系统变量；
• 经过visual studio，在launchSettings.json文件中设置。

文件配置提供程序

以Json文件为例（INI、XML文件相似）：

.ConfigureAppConfiguration((hostingContext, config) =>
{
    config.AddJsonFile("MyConfig.json", 
            optional: true, 
            reloadOnChange: true);
          .AddJsonFile($"MyConfig.{env.EnvironmentName}.json", 
            optional: true, 
            reloadOnChange: true);
})

以这种顺序添加，后面MyConfig.{env.EnvironmentName}.json中的配置会覆盖MyConfig.json中的同名配置。

配置的读取

GetValue

从配置中提取一个具备指定键的值，并将它转换为指定的类型

var number = Configuration.GetValue<int>("NumberKey", 99);

GetSection

会返回具备指定子节键的配置子节

section1 = configuration.GetSection("section1");

对于GetSection的结果，可使用GetValue 来获取单个键的值，也可使用GetChild来获取获取子节键下的全部配置。

使用Get 能够直接把配置内容绑定到类

var starship = _config.GetSection("starship").Get<Starship>();

{
  "starship": {
    "name": "USS Enterprise",
    "registry": "NCC-1701",
    "class": "Constitution",
    "length": 304.8,
    "commissioned": false,
    "Array": [ "12", "23", "d3" ],
    "ShipLog": {
      "ID": "1"
    }
  }
  ...
}

public class Starship 
{
	public string Name { get; set; }
	public string Registry { get; set; }
	public string Class { get; set; }
	public decimal Length { get; set; }
	public bool Commissioned { get; set; }
	public ShipLog ShipLog { get; set; }
	public string[] Array { get; set; }
}
public class ShipLog
{
	public string ID { get; set; }
}

自定义配置数据源

除了上述配置提供程序，还能够自定义配置数据源，好比能够统一从配置中心获取配置。
要自定义配置源，须要实现IConfigurationSource和IConfigurationProvider。

实现IConfigurationSource：

class MyConfigurationSource : IConfigurationSource
{
    public IConfigurationProvider Build(IConfigurationBuilder builder)
    {
        return new MyConfigurationProvider();
    }
}

实现IConfigurationProvider，具体方式能够经过继承ConfigurationProvider，而后重写它的虚方法。下面的示例重写了Load方法，在这里能够自行编码获取配置、设置到this.Data，Data是一个键和值类型都是string的字典，用于存储配置。还用了一个定时器来模拟配置的变动，在发生配置变动时，触发base.OnReload();

class MyConfigurationProvider : ConfigurationProvider
{
    Timer timer;

    public MyConfigurationProvider() : base()
    {
        timer = new Timer();
        timer.Elapsed += (a, b) => Load(true);
        timer.Interval = 3000;
        timer.Start();
    }

    public override void Load()
    {
        //加载数据
        Load(false);
    }

    void Load(bool reload)
    {
        this.Data["lastTime"] = DateTime.Now.ToString();            
        if (reload)
        {
            base.OnReload();
        }
    }
}

使用的时候：builder.Add(new MyConfigurationSource());

但这种方法会暴露具体的实现，能够封装为扩展方法。若是把这个扩展类的命名空间指定为Microsoft.Extensions.Configuration，这样在分发到第三方后，就能够直接使用，而没必要using程序集的命名空间，而前面的实现类默认为internal，第三方没法访问到，实现了整个类库只暴露出一个扩展方法的效果。

namespace Microsoft.Extensions.Configuration
{
    public static class MyConfigurationBuilderExtensions
    {
        public static IConfigurationBuilder AddMyConfiguration(this IConfigurationBuilder builder)
        {
            builder.Add(new MyConfigurationSource());
            return builder;
        }
    }
}

监听配置变动的方法：

builder.AddMyConfiguration();
var configRoot = builder.Build();
ChangeToken.OnChange(() => configRoot.GetReloadToken(), () =>
{
    //监听到配置变动后的处理代码
});