1. 程式人生 > >《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節點作為日誌的預設配置引數依據。如下圖所示:

 

日誌的優先等級如下(從上到下依次遞增)

    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"  

 

環境變數的傳值方式

環境變數的等級僅次於命令列,另外windows當前使用者的環境變數有限等級高於系統環境變數,windows環境變數可能重啟後才能生效;

主要的應用場景在於docker等

 

記憶體性配置方式

主要用於加密保護一些敏感配置數