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

原文: 《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节点作为日志的默认配置参数依据。如下图所示:

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

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
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一下就看到了里面有它)

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
   "Id" : "123" ,
   "Logging" : {
     "IncludeScopes" : false ,
     "LogLevel" : {
       "Default" : "Debug" ,
       "System" : "Information" ,
       "Microsoft" : "Information"
     }
   },
   "UserList" : [
     {
       "Name" : "Name1"
     },
     {
       "Name" : "Name2"
     },
     {
       "Name" : "Name3"
     }
   ]
}

3.通过Key进行读取

?
1
2
3
4
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方法为例)

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
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的值的方式:

?
1
2
3
4
5
6
//core特有的传入方式,没有引号就会因空格截断
 
dotnet  app.dll  /A= "Value in CMD" 
 
//传统的方式,没有引号就会因空格截断
dotnet  app.dll  --A "Value in CMD"
?
1
dotnet  app.dll  A= "Value in CMD"

 

环境变量的传值方式

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

主要的应用场景在于docker等

内存性配置方式

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

猜你喜欢

转载自www.cnblogs.com/lonelyxmas/p/12292922.html