《ASP.NET Core 高性能系列》关于.NET Core的配置信息的若干事项

1.配置文件的相关闲话

  Core自身对于配置文件不是必须品,但由上文分析可知ASP.NET Core默认采用appsettings.json作为配置文件,关于配置信息的优先等级

命令行>环境变量>自我订制的配置(AddUserSecrets)>和当前环境相匹配的appsettings.json中的配置>大于appsettings.json中的配置

  关于AddUserSecrets是什么这里简单一言以蔽之:每个开发人员有自己特性的配置数据,这些配置信息仅仅属于个人,不能提交给团队成员,

  但是又不想不团队共有的配置所影响. 剩下的自行去了解,关键是上面的优先级

  和当前环境相匹配的appsettings.json如appsettings.Development.json

 

2.日志配置的问题

系统默认采用Microsoft.Extensions.Logging系列套餐作为默认的日志组件,且采用配置文件中的Logging节点作为日志的默认配置参数依据。如下图所示:

 

日志的优先等级如下(从上到下依次递增)

    public enum LogLevel
    {
        // 含有最详细的日志数据,其中可能含有程序的一些敏感数据,该选项默认是被禁用的,且生产环境中绝对不要开启
        // (太多,太敏感),之所以默认禁用在于appsettings.json中最低级别是Information
        Trace = 0,
        //调试用的一些数据
        Debug = 1,
        // 用于跟踪程序通常的流程数据,这些日志是一些长期的数据。 
        Information = 2,
        // 需要引起重视的日志数据,不会导致程序崩溃
        Warning = 3,
        //发生了错误,但不会导致程序大范围崩溃
        Error = 4,       
        // 严重且致命的错误
        Critical = 5,
        // 不是用来记录日志的. 通常用于设置默认值
        None = 6
    }  

3.配置文件的读取

 1)ASP.NET Core的Host采用appsettings.json作为配置文件,具体的值是多少受优先级的影响(看第一段)

 2)Startup类中Host自动通过构造注入的方式提供了Configuration的值,Configuration读取方式介绍如下

ASP.NET Core中默认采用了Microsoft.Extensions.Configuration.Json作为配置解析器(publish一下就看到了里面有它)

{
  "Id": "123",
  "Logging": {
    "IncludeScopes": false,
    "LogLevel": {
      "Default": "Debug",
      "System": "Information",
      "Microsoft": "Information"
    }
  },
  "UserList": [
    {
      "Name": "Name1"
    },
    {
      "Name": "Name2"
    },
    {
      "Name": "Name3"
    }
  ]
}

3.通过Key进行读取

Configuration["Id"]; //  123
Configuration["Logging:IncludeScopes"]; //  false
Configuration["Logging:LogLevel:Default"]; // Debug
Configuration["UserList:0:Name"]; // Name1

上面这些值都是string类型的,我们可以通过GetValue来获取指定类型的值

 

 如下

Configuration.GetValue<int>("Id"); // int类型的123
Configuration.GetValue<bool>("Logging:IncludeScopes"); // bool 类型 false
Configuration.GetValue<string>("Logging:LogLevel:Default"); // string 类型 Debug
Configuration.GetValue<string>("UserList:0:Name"); // string 类型 Name1

 

4.通过POCO(纯C#对象)类来获取配置信息(这里以Get方法为例)

public class Poco
{
    public int Id { get; set; }
    public LoggingPoco Logging { get; set; }
    public List<User> UserList { get; set; }
    public class User
    {
        public string Name { get; set; }
    }
}
public class LoggingPoco
{
    public bool IncludeScopes { get; set; }
    public LogLevelPoco LogLevel { get; set; }
}
public class LogLevelPoco
{
    public string Default { get; set; }
    public string System { get; set; }
    public string Microsoft { get; set; }
}
var detailLogging = Configuration.GetSection("Logging").Get<LoggingPoco>();

  

获取整个配置文件的配置信息

var allConfig = Configuration.Get<Poco>();

获取指定节点下的配置内容

var logging = Configuration.GetSection("Logging").Get<LoggingPoco>();

 

说说优先级最高的配置(命令行方式)

前文所述,命令行具有优先级最高的配置权力,命令行传入A的值的方式:

//core特有的传入方式,没有引号就会因空格截断

dotnet  app.dll  /A="Value in CMD"  

//传统的方式,没有引号就会因空格截断
dotnet  app.dll  --A "Value in CMD"  
dotnet  app.dll  A="Value in CMD"  

 

 

 

环境变量的传值方式

环境变量的等级仅次于命令行,另外windows当前用户的环境变量有限等级高于系统环境变量,windows环境变量可能重启后才能生效;

主要的应用场景在于docker等

 

内存性配置方式

主要用于加密保护一些敏感配置数据.

posted @ 2020-02-06 09:51  迅捷网络[来送福利]  阅读(884)  评论(2编辑  收藏  举报